Поделиться через


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.

Если регистр не равно true, то функция возвращает CDocTemplate::yesAttemptForeign.

Реализация по умолчанию не возвращает CDocTemplate::maybeAttemptForeign или CDocTemplate::maybeAttemptNative. Переопределить эту функцию для реализации тип- соответствующую логику, подходящую приложению, можно с помощью этих 2 значений из перечисления Confidence.

Требования

Header: afxwin.h

См. также

Ссылки

Класс CDocTemplate

Диаграмма иерархии

CDocTemplate::GetDocString