Freigeben über


CDocTemplate::MatchDocType

Bestimmt den Grad des Abhängigkeit in der Übereinstimmung zwischen einem Dokumenttyp und dieser Vorlage.

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

Parameter

  • lpszPathName
    Pfadname der Datei, deren Typ bestimmt werden soll.

  • rpDocMatch
    Zeiger auf ein Dokument, das das entsprechende Dokument zugewiesen wird, wenn die Datei, die von lpszPathName angegeben wird, bereits geöffnet ist.

Rückgabewert

Ein Wert aus der Confidence-Enumeration, die definiert wird, wie folgt:

enum Confidence

{

noAttempt,

maybeAttemptForeign,

maybeAttemptNative,

yesAttemptForeign,

yesAttemptNative,

yesAlreadyOpen

};

Hinweise

Verwenden Sie diese Funktion, um den Typ der Normal-Vorlage zu bestimmen, die für das Öffnen einer Datei zu verwenden.Wenn Ihre Anwendung mehrere Dateitypen unterstützt zum Beispiel können Sie diese Funktion verwenden, um zu bestimmen, die von den verfügbaren Dokumentvorlagen für eine angegebene Datei geeignet ist, indem wiederum MatchDocType für jede Vorlage aufruft, und eine Vorlage entsprechend dem zurückgegebenen Vertrauenswert auswählen.

Wenn die Datei, die von lpszPathName angegeben wird, bereits geöffnet ist, gibt CDocTemplate::yesAlreadyOpen dieser Funktion und das Objekt CDocument Kopien der Datei in das Objekt bei rpDocMatch.

Wenn die Datei nicht geöffnet ist, aber die Erweiterung in lpszPathName die Erweiterung übereinstimmt, die von CDocTemplate::filterExt angegeben wird, legt gibt CDocTemplate::yesAttemptNative dieser Funktion und rpDocMatch zu NULL fest.Weitere Informationen zu CDocTemplate::filterExt, finden Sie unter CDocTemplate::GetDocString.

Wenn keines der Fall True ist, gibt die Funktion CDocTemplate::yesAttemptForeign zurück.

Die Standardimplementierung gibt nicht CDocTemplate::maybeAttemptForeign oder CDocTemplate::maybeAttemptNative zurück.Überschreiben Sie diese Funktion, um die Typ-entsprechende Logik zu implementieren, die der Anwendung, unter Umständen dieser beiden Werte aus der Confidence-Enumeration entspricht.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CDocTemplate-Klasse

Hierarchien-Diagramm

CDocTemplate::GetDocString