CMDIChildWndEx::GetDocumentName
Devuelve el nombre del documento que se muestra en la ventana MDI secundaria.
virtual LPCTSTR GetDocumentName(
CObject** pObj
);
Valor devuelto
un puntero a una cadena que contiene el nombre de un documento.
Comentarios
Un documento es lo que muestra la ventana MDI secundaria. Normalmente, la ventana muestra los datos de los que se carga o guarda en un archivo. Por consiguiente, el nombre del documento es el nombre del archivo. la implementación predeterminada de GetDocumentName devuelve una cadena obtenida de CDocument::GetPathName.
Si la ventana muestra un documento que no se carga de un archivo, invalide este método en una clase derivada y devuelve un identificador único del documento.
GetDocumentName llama el marco cuando guarda el estado de todos los documentos abiertos. La cadena devuelta se escribe en el registro.
Cuando el marco está restaurando el estado más adelante, el nombre del documento se leen del registro y se pasa a CMDIFrameWndEx::CreateDocumentWindow. Invalide este método en CMDIFrameWndEx- clase derivada y póngala o abra un documento que tiene este nombre y leer en el archivo que tiene este nombre. Si el documento no se basa en un archivo, cree el documento basado en el identificador propio del documento. Debe realizar las acciones anteriores solo si desea guardar y restaurar documentos.
Ejemplo
En el siguiente ejemplo se muestra el uso del método GetDocumentName. Este fragmento de código procede de ejemplo de VisualStudioDemo: Aplicación MFC Visual Studio.
LPCTSTR CChildFrame::GetDocumentName(CObject** pObj)
{
if (DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL)
{
return g_strStartViewName;
}
return CMDIChildWndEx::GetDocumentName(pObj);
}
Requisitos
encabezado: afxMDIChildWndEx.h