CDocTemplate::GetDocString

Artikel
02/26/2013

Ruft eine Zeichenfolge ab, die dem Dokumenttyp zugeordnet ist.

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

Parameter

rString
Ein Verweis auf einen CString-Objekt, das die Zeichenfolge enthält, wenn die Funktion zurückgibt.
Index
Ein Index der Teilzeichenfolge, die aus der Zeichenfolge abgerufen wird, die den Dokumenttyp beschreibt.Dieser Parameter kann einen der folgenden Werte aufweisen:
- CDocTemplate::windowTitle Name, der in der Titelleiste des Anwendungsfensters angezeigt wird (beispielsweise, "Microsoft Excel").Stellen Sie sich nur in der Normal-Vorlage für SDI-Anwendungen dar.
- CDocTemplate::docName Stamm für den standardmäßigen Dokumentnamen (beispielsweise, "Blatt").Dieser Stamm, plus eine Zahl, wird für den Standardnamen ein neues Dokument dieses Typs verwendet, wenn der Benutzer den neuen Befehl aus der Menü Datei auswählt (beispielsweise, "Sheet1" oder "Sheet2").Wenn Sie nicht angegeben werden, "unberechtigt" wird als Standard verwendet.
- CDocTemplate::fileNewName Name dieses Dokumenttyps.Wenn die Anwendung mehr als einen Typ Dokument unterstützt, wird diese Zeichenfolge im neuen Dialogfeld Datei angezeigt (beispielsweise, "Arbeitsblatt").Wenn nicht angegeben wird, ist der Dokumenttyp mithilfe des neuen Befehls der Datei nicht möglich.
- CDocTemplate::filterName Beschreibung des Dokumenttyps und Platzhalter filtern entsprechende Dokumente dieses Typs.Diese Zeichenfolge wird in den Bericht der Typdropdownliste im geöffneten Dialogfeld Datei angezeigt (beispielsweise, "Arbeitsblätter (*.xls) ").Wenn nicht angegeben wird, ist der Dokumenttyp mithilfe des Befehls der geöffneten Datei nicht möglich.
- CDocTemplate::filterExt Erweiterung für Dokumente dieses Typs (beispielsweise, ".xls").Wenn nicht angegeben wird, ist der Dokumenttyp mithilfe des Befehls der geöffneten Datei nicht möglich.
- CDocTemplate::regFileTypeId Bezeichner, sodass der Dokumenttyp in der Registrierungsdatenbank gespeichert werden kann, die von Windows verwaltet wird.Diese Zeichenfolge ist nur für die interne Verwendung (beispielsweise, "ExcelWorksheet").Wenn nicht angegeben wird, kann der Dokumenttyp nicht mit dem Windows-Datei-Manager registriert werden.
- CDocTemplate::regFileTypeName Name des in der Registrierungsdatenbank gespeichert werden, Dokumenttyps.Diese Zeichenfolge wird in den Dialogfeldern Anwendungen möglicherweise angezeigt, die auf die Registrierungsdatenbank zugreifen (beispielsweise, "Microsoft Excel-Arbeitsblatt").

Rückgabewert

Ungleich 0 (null), wenn die angegebene untergeordnete Zeichenfolge gefunden wurde; andernfalls 0.

Hinweise

Rufen Sie diese Funktion auf, um eine bestimmte Teilzeichenfolge abzurufen, die den Dokumenttyp beschreibt.Die Zeichenfolge, die diese Teilzeichenfolgen enthält, wird in der Normal-Vorlage gespeichert und aus einer Zeichenfolge in der Ressourcendatei für die Anwendung berechnet.Das Framework ruft diese Funktion auf, um die Zeichenfolgen abzurufen, die sie für die Benutzeroberfläche der Anwendung benötigt.Wenn Sie eine Dateinamenerweiterung für die Dokumente der Anwendung angegeben haben, ruft das Framework auch diese Funktion auf, wenn der Eintrag zur Windows-Registrierungsdatenbank hinzugefügt wird, dieses ermöglicht die vom Windows-Datei-Manager zu öffnenden Dokumente.

Rufen Sie diese Funktion nur auf, wenn Sie die eigene Klasse von CDocTemplate berechnen.