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 deve ser determinada.

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

Valor de retorno

Um valor de enumeração de Confidence , que é definido como segue:

enum Confidence

{

noAttempt,

maybeAttemptForeign,

maybeAttemptNative,

yesAttemptForeign,

yesAttemptNative,

yesAlreadyOpen

};

Comentários

Use esta função para determinar o tipo de modelo do documento usar para abrir um arquivo.Se seu aplicativo suporta vários tipos de arquivo, por exemplo, você pode usar essa função para determinar qual os modelos disponíveis de documento é adequada para um determinado arquivo MatchDocType chamando para cada modelo por sua vez, e escolhendo um modelo de acordo com o valor retornado de confiança.

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

Se o arquivo não está aberto mas a extensão em lpszPathName coincide com a extensão especificada por CDocTemplate::filterExt, retorna CDocTemplate::yesAttemptNative de essa função e definem rpDocMatch a NULO.Para obter mais informações sobre CDocTemplate::filterExt, consulte CDocTemplate::GetDocString.

Se nenhum caso é verdadeiro, a função retorna CDocTemplate::yesAttemptForeign.

a implementação padrão não retorna CDocTemplate::maybeAttemptForeign ou CDocTemplate::maybeAttemptNative.Substituir essa função para implementar a lógica de tipo correspondente for apropriado para seu aplicativo, talvez usando esses dois valores da enumeração de Confidence .

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe de CDocTemplate

Gráfico de hierarquia

CDocTemplate::GetDocString