CDocTemplate::GetDocString

Articolo
03/05/2013

Recupera una stringa associata al tipo di documento.

virtual BOOL GetDocString(
   CString& rString,
   enum DocStringIndex index 
) const;

Parametri

rString
Un riferimento a un oggetto CString che conterrà la stringa quando la funzione restituisce.
indice
Un indice della sottostringa che viene recuperata dalla stringa che descrive il tipo di documento.Per il parametro è possibile specificare uno dei valori riportati di seguito.
- Nome diCDocTemplate::windowTitle visualizzato nella barra del titolo della finestra dell'applicazione, ad esempio "Microsoft Excel").Presenti solo nel modello di documento per applicazioni SDI.
- Radice per il nome del documento predefinito, ad esempio "" foglio diCDocTemplate::docName ).Questa radice, oltre a un numero, viene utilizzata per il nome predefinito di un nuovo documento di questo tipo ogni volta che l'utente sceglie il nuovo comando dal menu File, ad esempio "Sheet1" o "Foglio2").Se non specificato, "senza titolo" viene utilizzato come predefinito.
- Nome diCDocTemplate::fileNewName di questo tipo di documento.Se l'applicazione supporta più di un tipo di documento, questa stringa viene visualizzata nella finestra di dialogo dei file, ad esempio "foglio di lavoro").Se non specificato, il tipo di documento è inaccessibile utilizzando il nuovo comando del file.
- Descrizione diCDocTemplate::filterName documenti corrispondenti di un filtro jolly e il tipo di documento di questo tipo.Questa stringa visualizzati nei file dell'elenco a discesa dei tipi nella finestra di dialogo di apertura file, ad esempio "fogli di lavoro (*.xls) ".Se non specificato, il tipo di documento non è accessibile tramite il comando aperto il file.
- Estensione diCDocTemplate::filterExt per documenti di questo tipo, ad esempio "xls").Se non specificato, il tipo di documento non è accessibile tramite il comando aperto il file.
- Identificatore diCDocTemplate::regFileTypeId per il tipo di documento siano archiviati nel database di registrazione gestito da Windows.Questa stringa è solo per utilizzo interno, ad esempio "ExcelWorksheet").Se non specificato, il tipo di documento non può essere registrato nel File Manager di Windows.
- Nome diCDocTemplate::regFileTypeName del tipo di documento da archiviare nel database di registrazione.Questa stringa può essere visualizzato nelle finestre di dialogo delle applicazioni che accedono al database di registrazione, ad esempio "foglio di lavoro di Microsoft Excel").

Valore restituito

Diverso da zero se la sottostringa specificata è stata trovata; in caso contrario 0.

Note

Chiamare la funzione per recuperare una sottostringa specifica che descrive il tipo di documento.La stringa contenente le sottostringhe è archiviata nel modello di documento ed è derivata da una stringa nel file di risorse per l'applicazione.Il framework chiama la funzione per ottenere le stringhe necessarie per l'interfaccia utente dell'applicazione.Se è stato specificato un'estensione del nome file per documenti dell'applicazione, il framework chiama anche questa funzione quando si aggiunge una voce al database di registrazione di Windows, in questo modo i documenti da aprire il File Manager di Windows.

Chiamare questa funzione solo se si deriva una classe da CDocTemplate.