CMDIChildWndEx::GetDocumentName
Retorna o nome de documento que é exibido na janela filho MDI.
virtual LPCTSTR GetDocumentName(
CObject** pObj
);
Valor de retorno
Um ponteiro para uma cadeia de caracteres que contém o nome de um documento.
Comentários
Um documento é o que a janela filho MDI exibe. Em geral, a janela exibe os dados que ele é carregado ou salvo em um arquivo. Portanto, o nome do documento é o nome do arquivo. a implementação padrão de GetDocumentName retorna uma cadeia de caracteres obtida de CDocument::GetPathName.
Se a janela exibe um documento que não está carregado de um arquivo, substitua esse método em uma classe derivada e retornar um identificador exclusivo do documento.
GetDocumentName é chamado pela estrutura quando salvar o estado de todos os documentos abertos. A cadeia de caracteres retornada é gravada no Registro.
Quando a estrutura está restaurando o estado posteriormente, o nome do documento é lida do Registro e passado para CMDIFrameWndEx::CreateDocumentWindow. Substitua esse método em CMDIFrameWndEx- classe derivada e criar ou abrir um documento que têm esse nome e lê o arquivo que tem esse nome. Se o documento não é baseado em um arquivo, crie o documento baseado no próprio identificador do documento. Você deve fazer as ações anterior somente se você pretende salvar e restaurar documentos.
Exemplo
O exemplo a seguir demonstra o uso do método de GetDocumentName . Este trecho de código proveniente de exemplo de VisualStudioDemo: Aplicativo MFC Visual Studio.
LPCTSTR CChildFrame::GetDocumentName(CObject** pObj)
{
if (DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL)
{
return g_strStartViewName;
}
return CMDIChildWndEx::GetDocumentName(pObj);
}
Requisitos
Cabeçalho: afxMDIChildWndEx.h