Partilhar via


CDocTemplate::MatchDocType

Determina o grau de confiança na correspondência entre um tipo de documento e esse modelo.

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

Parâmetros

  • lpszPathName
    Nome do caminho do arquivo cujo tipo é para ser determinado.

  • rpDocMatch
    Ponteiro para um documento que é atribuído o documento correspondente, se o arquivo especificado por lpszPathName já está em aberto.

Valor de retorno

Um valor a partir de Confiança enumeração, que é definida da seguinte forma:

enum Confidence

{

noAttempt,

maybeAttemptForeign,

maybeAttemptNative,

yesAttemptForeign,

yesAttemptNative,

yesAlreadyOpen

};

Comentários

Use esta função para determinar o tipo de modelo de documento a ser usado para abrir um arquivo.Se seu aplicativo suporta vários tipos de arquivo, por exemplo, você pode usar esta função para determinar qual dos modelos de documento disponível é apropriado para um determinado arquivo chamando MatchDocType para cada modelo de ativar e escolhendo um modelo ao valor confiança retornado.

Se o arquivo especificado por lpszPathName já está em aberto, essa função retorna CDocTemplate::yesAlreadyOpen e copia CDocument objeto do objeto no rpDocMatch.

Se o arquivo não estiver em aberto, mas a extensão de lpszPathName coincide com a extensão especificada por CDocTemplate::filterExt, essa função retorna CDocTemplate::yesAttemptNative and sets rpDocMatch para NULO.Para obter mais informações sobre o CDocTemplate::filterExt, see CDocTemplate::GetDocString.

Se nenhuma caso for true, a função retornará CDocTemplate::yesAttemptForeign.

A implementação padrão não retorna CDocTemplate::maybeAttemptForeign or CDocTemplate::maybeAttemptNative.Substituir esta função para implementar a lógica de correspondência de tipo apropriada para seu aplicativo, talvez usando esses dois valores do Confiança enumeração.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CDocTemplate

Gráfico de hierarquia

CDocTemplate::GetDocString

Outros recursos

CDocTemplate membros