CDocTemplate::MatchDocType
判斷確定要相符的資料型別與範本之間。
virtual Confidence MatchDocType(
LPCTSTR lpszPathName,
CDocument*& rpDocMatch
);
參數
lpszPathName
要判斷輸入檔案的路徑名稱。rpDocMatch
指派至這個相符之文件的指標, lpszPathName ,如果指定的檔案已經開啟。
傳回值
從 Confidence 列舉值,定義如下:
enum Confidence
{
noAttempt,
maybeAttemptForeign,
maybeAttemptNative,
yesAttemptForeign,
yesAttemptNative,
yesAlreadyOpen
};
備註
使用這個函式來判斷檔案的範本類型為開啟檔案時使用。 例如,如果應用程式支援多個檔案類型可使用這個函式來判斷哪些資料範本為指定的檔案是適當的作法。接著呼叫每個範本的 MatchDocType 和選取範本是以確定所傳回的值。
如果 lpszPathName 指定的檔案已經開啟,這個函式會傳回 CDocTemplate::yesAlreadyOpen 和複製檔案的 CDocument 物件加入至 rpDocMatch的物件中。
如果檔案尚未開啟,而是在 lpszPathName 的副檔名與 CDocTemplate::filterExt指定副檔名,這個函式會傳回 CDocTemplate::yesAttemptNative 和設定 rpDocMatch 至 NULL。 如需 CDocTemplate::filterExt的資訊,請參閱 CDocTemplate::GetDocString。
如果兩個案例不成立,函式會傳回 CDocTemplate::yesAttemptForeign。
預設實作未傳回 CDocTemplate::maybeAttemptForeign 或 CDocTemplate::maybeAttemptNative。 覆寫這個函式實作型別相符的邏輯適用於您的應用程式,或使用從 Confidence 列舉型別中的這兩個值。
需求
Header: afxwin.h