CMDIChildWndEx::GetDocumentName
Restituisce il nome del documento che viene visualizzato nella finestra figlio MDI.
virtual LPCTSTR GetDocumentName(
CObject** pObj
);
Valore restituito
Un puntatore a una stringa contenente il nome di un documento.
Note
Un documento è quello la finestra figlio MDI viene visualizzato. In genere, la finestra vengono visualizzati i dati da cui viene caricato o salvato in un file. Di conseguenza, il nome del documento è il nome del file. l'implementazione predefinita GetDocumentName restituisce una stringa ottenuta da CDocument::GetPathName.
Se la finestra visualizza un documento non viene caricato da un file, eseguire l'override di questo metodo in una classe derivata e restituiscono un identificatore univoco del documento.
GetDocumentName viene chiamato dal framework quando viene salvato lo stato di tutti i documenti aperti. La stringa restituita è scritta nel Registro di sistema.
Quando il framework in corso il ripristino successivamente lo stato, il nome del documento viene letto dal Registro di sistema e passato a CMDIFrameWndEx::CreateDocumentWindow. Eseguire l'override di questo metodo in CMDIFrameWndExclasse derivata da e creare o aprire un documento con questo nome e leggere nel file con questo nome. Se il documento non è basato su un file, creare un documento basato sull'identificatore stesso documento. È necessario eseguire le azioni precedenti solo se si desidera salvare e ripristinare i documenti.
Esempio
Nell'esempio seguente viene illustrato l'utilizzo del metodo GetDocumentName. Nel frammento di codice proviene da Esempio VisualStudioDemo: Applicazione MFC Visual Studio.
LPCTSTR CChildFrame::GetDocumentName(CObject** pObj)
{
if (DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL)
{
return g_strStartViewName;
}
return CMDIChildWndEx::GetDocumentName(pObj);
}
Requisiti
intestazione: afxMDIChildWndEx.h