CMDIChildWndEx::GetDocumentName
Retorna o nome do documento que é exibido na janela filho MDI.
virtual LPCTSTR GetDocumentName(
CObject** pObj
);
Valor de retorno
Um ponteiro para uma seqüência de caracteres que contém o nome de um documento.
Comentários
Um documento é o que exibe a janela filho MDI.Em geral, a janela exibe dados carregados do ou salvos em um arquivo.Portanto, o nome do documento é o nome do arquivo.A implementação padrão de GetDocumentName Retorna uma seqüência obtida CDocument::GetPathName.
Se a janela exibe um documento que não é carregado de um arquivo substituir este método em uma classe derivada e retornar um identificador exclusivo do documento.
GetDocumentName é chamado pela estrutura quando ele salva o estado de todos os documentos abertos. A seqüência de caracteres retornada é gravada no registro.
Quando a estrutura está restaurando estado mais tarde, o nome do documento é ler a partir do registro e passado para CMDIFrameWndEx::CreateDocumentWindow. substituir Este método em um CMDIFrameWndEx - classe derivada e criar ou em aberto um documento com o mesmo nome e ler no arquivo com o mesmo nome.Se o documento não for baseado em um arquivo, crie o documento com base no identificador do documento.Você deve fazer as ações anteriores somente se você pretende salvar e restauração os documentos.
Exemplo
O exemplo a seguir demonstra o uso do GetDocumentName método. Neste trecho de código é proveniente do Exemplo do VisualStudioDemo: Aplicativo do 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