CDocTemplate::GetDocString

virtuelle BOOL GetDocString ( CString& rString, enum DocStringIndex Index ) const;

Rückgabewert

Ungleich NULL, wenn die angegebene Teilzeichenfolge gefunden wurde; andernfalls 0.

Parameter

rString

Ein Verweis auf ein CString -Objekt, das die Zeichenfolge enthalten wird, wenn die Funktion zurückgegeben.

index

Ein Index der Teilzeichenfolge aus der Zeichenfolge, die beschreibt den Dokumenttyp abgerufen wird. Dieser Parameter kann einer der folgenden Werte aufweisen.:

• CDocTemplate::windowTitle&Nbsp;  Name wird in der Titelleiste des Anwendungsfensters zu (z. B. "Microsoft Excel") angezeigt. Handen Sie nur in der Dokumentvorlage für SDI-Anwendungen vor.
  
  
• CDocTemplate::doc&NameNbsp;  Wurzel für den Dokument-Standardnamen (z. B. "Blatt"). Dieser Stamm, sowie eine Nummer, ist für den Standardnamen für ein neues Dokument dieses Typs verwendet, wenn der Benutzer wählt den Befehl neu im Menü Datei (z. B. "Tabelle1" oder "Tabelle2"). Wenn nicht angegeben, wird "Untitled" als Standard verwendet.
  
  
• CDocTemplate::file&NewNameNbsp;  Name der diesen Dokumenttyp. Wenn die Anwendung mehr als eine Art von Dokumenten unterstützt, wird diese Zeichenfolge im Dialogfeld neue Datei (z. B. "Arbeitsblatt") angezeigt. Wenn nicht angegeben, ist der Dokumenttyp nicht zugegriffen werden kann mit dem Befehl Datei neu.
  
  
• CDocTemplate::filter&NameNbsp;  Beschreibung der Art des Dokuments und eine Wildcard-Filter übereinstimmenden Dokumente dieses Typs. Diese Zeichenfolge wird in der Liste Dateityp Dropdown-Liste in das Dialogfeld Datei öffnen (z. B. "Arbeitsblätter (*.xls)") angezeigt. Wenn nicht angegeben, ist der Dokumenttyp nicht zugegriffen werden kann mit den Befehl Datei öffnen.
  
  
• CDocTemplate::filterExt&Nbsp;  Erweiterung für Dokumente dieses Typs (z. B. ".xls"). Wenn nicht angegeben, ist der Dokumenttyp nicht zugegriffen werden kann mit den Befehl Datei öffnen.
  
  
• CDocTemplate::regFileTypeId&Nbsp;  Bezeichner für den Dokumenttyp in der Registrierungsdatenbank von Windows verwaltet gespeichert werden. Diese Zeichenfolge ist nur zur internen Verwendung (z. B. "ExcelWorksheet"). Wenn nicht angegeben, kann nicht der Dokumenttyp mit Windows Datei-Manager registriert werden.
  
  
• CDocTemplate::regFileType&NameNbsp;  Name des Dokumenttyps in der Registrierungsdatenbank gespeichert werden. Diese Zeichenfolge kann im Dialogfeld Anwendungen angezeigt werden, die Zugriff auf die Registrierungsdatenbank (z. B. "Microsoft-Excel-Arbeitsblatt").

Bemerkungen

Rufen Sie diese Funktion zum Abrufen einer bestimmten Teilzeichenfolge beschreibt den Dokumenttyp. Die Zeichenfolge, die diese Teilzeichenfolgen enthält wird in der Dokumentvorlage gespeichert und stammt aus einer Zeichenfolge in der Ressourcendatei für die Anwendung. Das Framework ruft diese Funktion die Zeichenfolgen abgerufen werden, die sie für die Benutzeroberfläche der Anwendung benötigt. Wenn Sie eine Dateinamenerweiterung für die Anwendung Dokumente angegeben haben, ruft das Framework auch diese Funktion, wenn Sie einen Eintrag auf der Windows-Registrierungsdatenbank hinzufügen; Dadurch können Dokumente über den Datei-Manager von Windows geöffnet werden.

Rufen Sie diese Funktion nur wenn Sie eine eigene Klasse von CDocTemplate.

Übersicht über die CDocTemplate |  Member der Klasse | Hierarchiediagramm

Siehe auch&Nbsp;CMultiDocTemplate::CMultiDocTemplate, CSingleDocTemplate::CSingleDocTemplate, CWinApp::RegisterShellFileTypes