CDocTemplate::MatchDocType

确定信心要匹配的"文件类型和此模板之间。

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

参数

  • lpszPathName
    将确定类型文件的路径名。

  • rpDocMatch
    对分配匹配的文档的指针文档,则为; lpszPathName 指定的文件已打开的。

返回值

Confidence 枚举的值,将定义如下:

enum Confidence

{

noAttempt,

maybeAttemptForeign,

maybeAttemptNative,

yesAttemptForeign,

yesAttemptNative,

yesAlreadyOpen

};

备注

使用此功能确定类型的文档模板用于打开文件。例如,如果应用程序支持多个文件类型可以使用此函数确定可用文档模板为特定文件适用于通过又调用每个模板的 MatchDocType 并选择模板基于返回的confidence值。

如果 lpszPathName 指定的文件已打开的,此函数返回 CDocTemplate::yesAlreadyOpen 并复制文件的 CDocument 对象到对象。rpDocMatch。

如果文件不是打开的,而是在 lpszPathName 的扩展名与 CDocTemplate::filterExt指定的扩展,此函数返回 CDocTemplate::yesAttemptNative 并将 rpDocMatch 到 NULL。有关 CDocTemplate::filterExt的更多信息,请参见 CDocTemplate::GetDocString

如果两种情况下不为true,则函数返回 CDocTemplate::yesAttemptForeign

默认实现不返回 CDocTemplate::maybeAttemptForeignCDocTemplate::maybeAttemptNative。重写此函数实现类型匹配的逻辑适合您的应用程序,而使用从 Confidence 枚举的这两个值。

要求

Header: afxwin.h

请参见

参考

CDocTemplate选件类

层次结构图

CDocTemplate::GetDocString