CDocTemplate::GetDocString

virtu&al BOOL GetDocString ( CStringamp; rString, enum DocStringIndex índice ) const;

Valor devuelto

Distinto de cero si se encontró la subcadena especificada; caso contrario 0.

Parámetros

rString

Una referencia a un objeto CString que contendrá la cadena cuando la función devuelve.

índice

Índice de la subcadena que se está recuperando de la cadena que describe el tipo de documento. Este parámetro puede tener uno de los siguientes valores:

• CDocTemplate::windowTitlenbsp;  &Nombre que aparece en el título de la ventana de la aplicación de la barra (por ejemplo, "Microsoft Excel"). Presente sólo en la plantilla de documento para aplicaciones SDI.
  
  
• CDocTemplate::doc&Namenbsp;  Raíz para el nombre de documento predeterminado (por ejemplo, "Hoja"). Esta raíz, además de un número, se utiliza el nombre predeterminado de un nuevo documento de este tipo siempre que el usuario selecciona el comando nuevo del menú Archivo (por ejemplo, "Hoja1" o "Sheet2"). Si no se especifica, se utiliza como valor predeterminado "Untitled".
  
  
• CDocTemplate::file&NewNamenbsp;  Nombre de este tipo de documento. Si la aplicación es compatible con más de un tipo de documento, esta cadena se muestra en el cuadro de diálogo nuevo archivo (por ejemplo, "hoja"). Si no se especifica, el tipo de documento es inaccesible mediante el comando nuevo archivo.
  
  
• CDocTemplate::filter&Namenbsp;  Descripción del tipo de documento y un filtro de comodín que coinciden con los documentos de este tipo. Esta cadena se muestra en la lista de archivos del tipo de lista desplegable en el cuadro de diálogo Abrir archivo (por ejemplo, "hojas (*.xls)"). Si no se especifica, el tipo de documento es inaccesible mediante el comando Abrir archivo.
  
  
• CDocTemplate::filterExt   Extensión de los documentos de este tipo (por ejemplo, ".xls"). Si no se especifica, el tipo de documento es inaccesible mediante el comando Abrir archivo.
  
  
• CDocTemplate::regFileTypeId   Identificador para el tipo de documento a ser almacenados en la base de datos de registro mantenido por Windows. Esta cadena es sólo para uso interno (por ejemplo, "ExcelWorksheet"). Si no se especifica, el tipo de documento no se puede registrar con el administrador de archivos de Windows.
  
  
• CDocTemplate::regFileType&Namenbsp;  Nombre del tipo de documento a ser almacenados en la base de datos del registro. Esta cadena puede mostrarse en cuadros de diálogo de aplicaciones que acceden a la base de datos de registro (por ejemplo, "Microsoft Excel Worksheet").

Observaciones

Llamar a esta función para recuperar una subcadena específica que describe el tipo de documento. La cadena que contiene las subcadenas se almacena en la plantilla de documento y se deriva de una cadena en el archivo de recursos para la aplicación. El marco llama a esta función para obtener las cadenas que necesita para la interfaz de usuario de la aplicación. Si se ha especificado una extensión de archivo de documentos de su aplicación, el marco también llama a esta función cuando se agrega una entrada a la base de datos de registro de Windows; Esto permite que los documentos que se abran desde el administrador de archivos de Windows.

Llamar a esta función sólo si se derivan su propia clase de CDocTemplate.

I&ntroducción a CDocTemplate |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;CMultiDocTemplate::CMultiDocTemplate, CSingleDocTemplate::CSingleDocTemplate, CWinApp::RegisterShellFileTypes