Partager via


CDocTemplate::MatchDocType

Détermine le niveau de confiance en correspondance entre un type de document et ce modèle.

virtual Confidence MatchDocType(
   LPCTSTR lpszPathName,
   CDocument*& rpDocMatch 
);

Paramètres

  • lpszPathName
    Nom de chemin d'accès du fichier dont le type doit être déterminé.

  • rpDocMatch
    Pointeur vers un document qui est assigné le document correspondant, si le fichier spécifié par lpszPathName est déjà ouvert.

Valeur de retour

Une valeur de l'énumération de Confiance , qui est définie comme suit :

enum Confidence

{

noAttempt,

maybeAttemptForeign,

maybeAttemptNative,

yesAttemptForeign,

yesAttemptNative,

yesAlreadyOpen

};

Notes

Utilisez cette fonction pour déterminer le type de modèle de document à utiliser pour ouvrir un fichier.Si vos types de fichier multiple de l'application prend en charge, par exemple, vous pouvez utiliser cette fonction pour déterminer les modèles de document disponibles est appropriée pour un fichier donné en appelant MatchDocType pour chaque modèle ensuite, et en choisissant un modèle en fonction de la valeur de confiance retournée.

Si le fichier spécifié par lpszPathName est déjà ouvert, retourne CDocTemplate::yesAlreadyOpen de cette fonction et des copies l'objet de CDocument du fichier dans l'objet à rpDocMatch.

Si le fichier n'est pas ouvert mais l'extension dans lpszPathName correspond à l'extension spécifiée par CDocTemplate::filterExt, retourne CDocTemplate::yesAttemptNative de cette fonction et définit rpDocMatch à NULL.Pour plus d'informations sur CDocTemplate::filterExt, consultez CDocTemplate::GetDocString.

Si ni l'un ni l'autre cas n'est affectée, la fonction retourne CDocTemplate::yesAttemptForeign.

L'implémentation par défaut ne retourne pas CDocTemplate::maybeAttemptForeign ou CDocTemplate::maybeAttemptNative.Remplacez cette fonction pour implémenter la logique de type correspondance appropriée à votre application, éventuellement à l'aide de ces deux valeurs de l'énumération de Confiance .

Configuration requise

Header: afxwin.h

Voir aussi

Référence

Classe de CDocTemplate

Graphique de la hiérarchie

CDocTemplate::GetDocString