Udostępnij za pośrednictwem


CDocTemplate::MatchDocType

Określa stopień zaufania w meczu pomiędzy ten szablon i typu dokumentu.

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

Parametry

  • lpszPathName
    Nazwa ścieżki pliku, którego typ jest ustalany.

  • rpDocMatch
    Wskaźnik do dokumentu, który jest przypisany pasującego dokumentu, jeżeli plik określony przez lpszPathName jest już otwarty.

Wartość zwracana

Wartość z zaufania wyliczenia, który jest zdefiniowany następująco:

enum Confidence

{

noAttempt,

maybeAttemptForeign,

maybeAttemptNative,

yesAttemptForeign,

yesAttemptNative,

yesAlreadyOpen

};

Uwagi

Ta funkcja służy do określenia typu szablon dokumentu używany do otwierania pliku.Jeśli aplikacja obsługuje wiele typów plików, na przykład funkcja to do określenia, które szablony dokumentów dostępne jest odpowiednie dla danego pliku, wywołując MatchDocType dla każdego szablonu w kolei i wybierając szablon zgodnie z wartością zaufania zwracane.

Jeżeli plik określony przez lpszPathName jest już otwarty, funkcja zwraca CDocTemplate::yesAlreadyOpen i kopiuje plik CDocument obiektu do obiektu na rpDocMatch.

Jeśli plik nie jest otwarty, ale rozszerzenie w lpszPathName odpowiada rozszerzenie określone przez CDocTemplate::filterExt, funkcja zwraca CDocTemplate::yesAttemptNative i ustawia rpDocMatch do NULL.Aby uzyskać więcej informacji na CDocTemplate::filterExt, zobacz CDocTemplate::GetDocString.

Jeśli nie jest spełniony, funkcja zwraca CDocTemplate::yesAttemptForeign.

Domyślna implementacja nie zwraca CDocTemplate::maybeAttemptForeign lub CDocTemplate::maybeAttemptNative.Zastąpienie tej funkcji do wdrożenia odpowiednich aplikacji, zapewne użycia tych dwóch wartości z logiki dopasowywania typu zaufania wyliczenia.

Wymagania

Nagłówek: afxwin.h

Zobacz też

Informacje

Klasa CDocTemplate

Wykres hierarchii

CDocTemplate::GetDocString