CDocTemplate::GetDocString

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

Valeur de retour

Différent de zéro si la sous-chaîne spécifiée a été trouvée ; sinon 0.

Paramètres

rString

Une référence à un objet CString qui contiendra la chaîne lorsque la fonction renvoie.

index

Un index de la sous-chaîne est Récupérée de la chaîne qui décrit le type de document. Ce paramètre peut prendre l'une des valeurs suivantes:

• CDocTemplate::windowTitlenbsp ;  &Nom qui apparaît dans le titre de la fenêtre de l'application bar (par exemple, « Microsoft Excel »). Présents uniquement dans le modèle de document pour les applications SDI.
  
  
• CDocTemplate::doc&Namenbsp ;  Racine pour le nom du document par défaut (par exemple, « Feuille »). Cette racine, plus un nombre, est utilisé pour le nom par défaut d'un nouveau document de ce type, chaque fois que l'utilisateur choisit la commande nouveau dans le menu fichier (par exemple, « Sheet1 » ou « Feuille Sheet2 »). Si non spécifié, « Sans titre » est utilisé comme valeur par défaut.
  
  
• CDocTemplate::file&NewNamenbsp ;  Nom de ce type de document. Si l'application prend en charge plus d'un type de document, cette chaîne est affichée dans la boîte de dialogue Nouveau fichier (par exemple, « feuille »). Si non spécifié, le type de document est inaccessible à l'aide de la commande nouveau dossier.
  
  
• CDocTemplate::filter&Namenbsp ;  Description du type de document et un filtre générique correspondant des documents de ce type. Cette chaîne est affichée dans la liste fichiers de Type dans la liste déroulante dans la boîte de dialogue Ouvrir (par exemple, « fiches (*.xls) »). Si non spécifié, le type de document est inaccessible à l'aide de la commande fichier ouvrir.
  
  
• CDocTemplate::filterExt  ;  Extension pour les documents de ce type (par exemple, ".xls"). Si non spécifié, le type de document est inaccessible à l'aide de la commande fichier ouvrir.
  
  
• CDocTemplate::regFileTypeId  ;  Identificateur pour le type de document à être stockés dans la base de registres de Windows. Cette chaîne est pour usage interne seulement (par exemple, "ExcelWorksheet"). Si non spécifié, le type de document ne peut être enregistré avec le gestionnaire de fichiers Windows.
  
  
• CDocTemplate::regFileType&Namenbsp ;  Nom du type de document à être stockés dans la base de données d'enregistrement. Cette chaîne peut-être être affichée dans les boîtes de dialogue des applications qui accèdent à la base de données d'enregistrement (par exemple, « Microsoft Excel Worksheet »).

Remarques

Appelez cette fonction pour extraire une sous-chaîne spécifique décrivant le type de document. La chaîne contenant les sous-chaînes est stockée dans le modèle de document et est dérivée d'une chaîne dans le fichier de ressources de l'application. Le framework appelle cette fonction pour obtenir les chaînes dont il a besoin pour l'interface utilisateur de l'application. Si vous avez spécifié une extension de nom de fichier pour les documents de votre application, l'infrastructure appelle également cette fonction lors de l'ajout d'une entrée à la base de données d'enregistrement de Windows ; Cela permet aux documents pour ouvrir le gestionnaire de fichiers de Windows.

Appelez cette fonction uniquement si vous dérivez votre propre classe de CDocTemplate.

Aperçu CDocTemplate |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CMultiDocTemplate::CMultiDocTemplate, CSingleDocTemplate::CSingleDocTemplate, CWinApp::RegisterShellFileTypes