CMDIChildWndEx::GetDocumentName
Retourne le nom du document qui s'affiche dans la fenêtre enfant MDI.
virtual LPCTSTR GetDocumentName(
CObject** pObj
);
Valeur de retour
Un pointeur vers une chaîne qui contient le nom d'un document.
Notes
Est un document que la fenêtre enfant MDI affiche.En général, la fenêtre affiche les données dont est chargé ou enregistré dans un fichier.Par conséquent, le nom du document est le nom du fichier.L'implémentation par défaut d' GetDocumentName retourne une chaîne obtenue à partir de CDocument::GetPathName.
Si la fenêtre affiche un document qui n'est pas chargé à partir d'un fichier, substituez cette méthode dans une classe dérivée et retournent un identificateur unique de document.
GetDocumentName est appelée par l'infrastructure lorsqu'il enregistre l'état de tous les documents ouverts.La chaîne retournée est écrite dans le Registre.
Lorsque l'infrastructure restaure l'état ultérieurement, le nom de document est lu dans le Registre et passé à CMDIFrameWndEx::CreateDocumentWindow.Substituez cette méthode dans CMDIFrameWndExclasse dérivée de et créez ou ouvrez un document portant ce nom et lit le contenu du fichier portant ce nom.Si le document n'est pas sur un fichier, créez le document avec l'identificateur de document lui-même.Vous devez effectuer les actions précédentes uniquement si vous avez l'intention d'enregistrer et restaurer des documents.
Exemple
L'exemple suivant illustre l'utilisation de la méthode GetDocumentName.Cet extrait de code provient d' Exemple VisualStudioDemo : Application MFC Visual Studio.
LPCTSTR CChildFrame::GetDocumentName(CObject** pObj)
{
if (DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL)
{
return g_strStartViewName;
}
return CMDIChildWndEx::GetDocumentName(pObj);
}
Configuration requise
en-tête : afxMDIChildWndEx.h