CDocument osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

A felhasználó által definiált dokumentumosztályok alapvető funkcióit biztosítja.

Szemantika

class CDocument : public CCmdTarget

Tagok

Nyilvános konstruktorok

Név	Description
CDocument::CDocument	Egy CDocument objektumot hoz létre.

Nyilvános metódusok

Név	Description
CDocument::AddView	Nézet csatolása a dokumentumhoz.
CDocument::BeginReadChunks	Inicializálja az adattömbök olvasását.
CDocument::CanCloseFrame	Speciális felülírható; a dokumentumot megtekintő keretablak bezárása előtt.
CDocument::ClearChunkList	Törli az adattömbök listáját.
CDocument::ClearPathName	Törli a dokumentumobjektum elérési útját.
CDocument::DeleteContents	A dokumentum törlésének gombra van meghívva.
CDocument::FindChunk	Megadott GUID azonosítóval rendelkező adattömbet keres.
CDocument::GetAdapter	Az objektum implementáló IDocument felületére mutató mutatót ad vissza.
CDocument::GetDocTemplate	A dokumentum típusát leíró dokumentumsablonra mutató mutatót ad vissza.
CDocument::GetFile	A kívánt objektumra mutató mutatót ad CFile vissza.
CDocument::GetFirstViewPosition	A nézetek listájában az első pozícióját adja vissza; az iteráció megkezdéséhez használatos.
CDocument::GetNextView	Végigvezeti a dokumentumhoz társított nézetek listáján.
CDocument::GetPathName	A dokumentum adatfájljának elérési útját adja vissza.
CDocument::GetThumbnail	A miniatűr-szolgáltató által a miniatűrök megjelenítéséhez használandó bitkép létrehozásához hívható meg.
CDocument::GetTitle	A dokumentum címét adja vissza.
CDocument::InitializeSearchContent	A Keresési kezelő keresési tartalmának inicializálására van meghívva.
CDocument::IsModified	Azt jelzi, hogy a dokumentum a legutóbbi mentés óta módosult-e.
CDocument::IsSearchAndOrganizeHandler	Azt jelzi, hogy ez az CDocument objektumpéldány a Keresés és rendszerezés kezelőhöz lett-e létrehozva.
CDocument::LoadDocumentFromStream	Meghívva a dokumentumadatok streamből való betöltésére.
CDocument::OnBeforeRichPreviewFontChanged	A Rich Preview betűtípus módosítása előtt hívható meg.
CDocument::OnChangedViewList	A nézet a dokumentumhoz való hozzáadása vagy a dokumentumból való eltávolítása után hívható meg.
CDocument::OnCloseDocument	A dokumentum bezárásához hívva.
CDocument::OnCreatePreviewFrame	A keretrendszer meghívja, amikor előképkeretet kell létrehoznia a Rich Preview számára.
CDocument::OnDocumentEvent	A keretrendszer meghívta egy dokumentumeseményre válaszul.
CDocument::OnDrawThumbnail	Felülbírálja ezt a metódust egy származtatott osztályban a miniatűr tartalmának rajzolásához.
CDocument::OnLoadDocumentFromStream	A keretrendszer meghívja, amikor be kell töltenie a dokumentumadatokat a streamből.
CDocument::OnNewDocument	Új dokumentum létrehozásához hívták meg.
CDocument::OnOpenDocument	Meghívva egy meglévő dokumentum megnyitásához.
CDocument::OnPreviewHandlerQueryFocus	Az előnézeti kezelőt a függvény meghívásától való visszatérésre HWNDGetFocus irányítja.
CDocument::OnPreviewHandlerTranslateAccelerator	Az előnézeti kezelőt arra irányítja, hogy kezelje a folyamat üzenetpumpa által átadott billentyűleütést, amelyben az előzetes kezelő fut.
CDocument::OnRichPreviewBackColorChanged	Akkor hívjuk meg, ha a Rich Preview háttérszíne megváltozott.
CDocument::OnRichPreviewFontChanged	A Rich Preview betűtípus módosításakor hívható meg.
CDocument::OnRichPreviewSiteChanged	A Rich Preview webhely módosításakor hívható meg.
CDocument::OnRichPreviewTextColorChanged	A Rich Preview szövegszínének módosításakor hívható meg.
CDocument::OnSaveDocument	A rendszer meghívta a dokumentum lemezre mentéséhez.
CDocument::OnUnloadHandler	A keretrendszer meghívta az előzetes verzió kezelőjének kiürítésekor.
CDocument::PreCloseFrame	A keretablak bezárása előtt hívjuk.
CDocument::ReadNextChunkValue	Beolvassa a következő adattömb értékét.
CDocument::ReleaseFile	Kiad egy fájlt, hogy elérhetővé tegye más alkalmazások számára.
CDocument::RemoveChunk	Eltávolítja a megadott GUIDadattömböket.
CDocument::RemoveView	Leválasztja a nézetet a dokumentumról.
CDocument::ReportSaveLoadException	Speciális felülírható; akkor van meghívva, ha egy nyitott vagy mentési művelet kivétel miatt nem hajtható végre.
CDocument::SaveModified	Speciális felülírható; a rendszer meghívta, hogy megkérdezze a felhasználótól, hogy menteni kell-e a dokumentumot.
CDocument::SetChunkValue	Adattömbértéket állít be.
CDocument::SetModifiedFlag	Beállít egy jelzőt, amely jelzi, hogy módosította a dokumentumot a legutóbbi mentés óta.
CDocument::SetPathName	Beállítja a dokumentum által használt adatfájl elérési útját.
CDocument::SetTitle	Beállítja a dokumentum címét.
CDocument::UpdateAllViews	Értesíti a dokumentumot módosító összes nézetet.

Védett metódusok

Név	Description
CDocument::OnFileSendMail	E-mailt küld a csatolt dokumentummal.
CDocument::OnUpdateFileSendMail	Engedélyezi a Levelek küldése parancsot, ha a levelezési támogatás jelen van.

Nyilvános adatok tagjai

Név	Description
CDocument::m_bGetThumbnailMode	Megadja, hogy az CDocument objektumot a dllhost hozta létre miniatűrökhöz. Be kell jelentkeznie CView::OnDraw.
CDocument::m_bPreviewHandlerMode	Megadja, hogy az CDocument objektumot a prevhost hozta létre a következőhöz Rich Preview: . Be kell jelentkeznie CView::OnDraw.
CDocument::m_bSearchMode	Azt adja meg, hogy az CDocument objektumot indexelő vagy más keresőalkalmazás hozta létre.
CDocument::m_clrRichPreviewBackColor	A Rich Preview ablak háttérszínét adja meg. Ezt a színt a gazdagép állítja be.
CDocument::m_clrRichPreviewTextColor	A Rich Preview ablak előtérszínét adja meg. Ezt a színt a gazdagép állítja be.
CDocument::m_lfRichPreviewFont	A Rich Preview ablak szöveg betűtípusát adja meg. Ezt a betűtípus-információt a gazdagép állítja be.

Megjegyzések

A dokumentum azt az adategységet jelöli, amelyet a felhasználó általában a Fájlmegnyitás paranccsal nyit meg, és a Fájl mentése paranccsal ment.

CDocument támogatja az olyan szabványos műveleteket, mint a dokumentum létrehozása, betöltése és mentése. A keretrendszer a megadott felületen CDocumentmódosítja a dokumentumokat.

Az alkalmazások több dokumentumtípust is támogathatnak; Egy alkalmazás például a számolótáblákat és a szöveges dokumentumokat is támogathatja. Minden dokumentumtípushoz tartozik egy dokumentumsablon; a dokumentumsablon megadja, hogy milyen erőforrásokat (például menüt, ikont vagy gyorsítótáblát) használnak az adott dokumentumtípushoz. Minden dokumentum tartalmaz egy mutatót a társított objektumhoz CDocTemplate .

A felhasználók a dokumentumokkal a CView társított objektum(ok)on keresztül kommunikálnak. A nézet képként jeleníti meg a dokumentumot egy keretablakban, és a felhasználói bemenetet műveletekként értelmezi a dokumentumon. Egy dokumentumhoz több nézet is társítható. Amikor a felhasználó megnyit egy ablakot egy dokumentumon, a keretrendszer létrehoz egy nézetet, és csatolja azt a dokumentumhoz. A dokumentumsablon megadja, hogy milyen típusú nézetet és keretablakot használ a rendszer az egyes dokumentumtípusok megjelenítéséhez.

A dokumentumok a keretrendszer szabványos parancs-útválasztásának részei, ezért a szabványos felhasználói felületi összetevőktől (például a Fájlmentés menüelemtől) kapnak parancsokat. A dokumentumok az aktív nézet által továbbított parancsokat fogadják. Ha a dokumentum nem kezel egy adott parancsot, a parancsot az azt kezelő dokumentumsablonnak továbbítja.

A dokumentum adatainak módosításakor minden nézetnek tükröznie kell ezeket a módosításokat. CDocument biztosítja a UpdateAllViews tagfüggvényt, hogy értesítse az ilyen módosítások nézeteit, hogy a nézetek szükség szerint újrafesthessék magukat. A keretrendszer arra is kéri a felhasználót, hogy a bezárása előtt mentsen egy módosított fájlt.

A dokumentumok egy tipikus alkalmazásban való implementálásához a következőket kell tennie:

• Minden dokumentumtípushoz CDocument származtat egy osztályt.

• Tagváltozók hozzáadása az egyes dokumentumok adatainak tárolásához.

• Tagfüggvények implementálása a dokumentum adatainak olvasásához és módosításához. A dokumentum nézetei a tagfüggvények legfontosabb felhasználói.

• CObject::Serialize A dokumentumosztály tagfüggvényének felülbírálása a dokumentum adatainak írásához és beolvasásához a lemezre és a lemezről.

CDocument támogatja a dokumentum e-mailben történő küldését, ha a levéltámogatás (MAPI) jelen van. Lásd a MAPI és a MAPI támogatás az MFC-ben című cikket.

További információ a szerializálásrólCDocument, a dokumentum-/nézetarchitektúrával kapcsolatos témakörökről és a dokumentum-/nézetlétrehozásról.

Öröklési hierarchia

CObject

CCmdTarget

CDocument

Requirements

Fejléc:afxwin.h

CDocument::AddView

Hívja meg ezt a függvényt, hogy egy nézetet csatoljon a dokumentumhoz.

void AddView(CView* pView);

Paraméterek

pView
A hozzáadott nézetre mutat.

Megjegyzések

Ez a függvény hozzáadja a megadott nézetet a dokumentumhoz társított nézetek listájához; a függvény a nézet dokumentummutatóját is ehhez a dokumentumhoz állítja. A keretrendszer meghívja ezt a függvényt, amikor egy újonnan létrehozott nézetobjektumot csatol egy dokumentumhoz; ez egy Fájl új, Fájlmegnyitás vagy Új ablak parancsra válaszul, vagy egy felosztóablak felosztásakor fordul elő.

Ezt a függvényt csak akkor hívja meg, ha manuálisan hoz létre és csatol egy nézetet. A keretrendszer általában lehetővé teszi a dokumentumok és nézetek összekapcsolására egy CDocTemplate objektum definiálásával, amely dokumentumosztályt, nézetosztályt és keretablak-osztályt társít.

Example

// The following example toggles two views in an SDI (single document
// interface) frame window. A design decision must be made as to
// whether to leave the inactive view connected to the document,
// such that the inactive view continues to receive OnUpdate
// notifications from the document. It is usually desirable to
// keep the inactive view continuously in sync with the document, even
// though it is inactive. However, doing so incurs a performance cost,
// as well as the programming cost of implementing OnUpdate hints.
// It may be less expensive, in terms of performance and/or programming,
// to re-sync the inactive view with the document only with it is
// reactivated. This example illustrates this latter approach, by
// reconnecting the newly active view and disconnecting the newly
// inactive view, via calls to CDocument::AddView and RemoveView.

void CMainFrame::OnViewChange(UINT nCmdID)
// There is an ON_COMMAND_RANGE message map entry associated with
// OnViewChange:
// ON_COMMAND_RANGE(ID_VIEW_CHANGE1, ID_VIEW_CHANGE2, &OnViewChange)
{
   CView *pViewAdd;
   CView *pViewRemove;
   CDocument *pDoc = GetActiveDocument();

   // cvView1 and cvView2 are enum members defined in my CMainFrame class
   if ((nCmdID == ID_VIEW_CHANGE1) && (m_currentView == cvView1))
      return;
   if ((nCmdID == ID_VIEW_CHANGE2) && (m_currentView == cvView2))
      return;

   if (nCmdID == ID_VIEW_CHANGE2)
   {
      if (m_pView2 == NULL)
      {
         m_pView1 = GetActiveView();
         m_pView2 = new CMyView2;

         //Note that if OnSize has been overridden in CMyView2
         //and GetDocument() is used in this override it can
         //cause assertions and, if the assertions are ignored,
         //cause access violation.

         m_pView2->Create(NULL, NULL, AFX_WS_DEFAULT_VIEW, rectDefault, this,
                          AFX_IDW_PANE_FIRST + 1, NULL);
      }
      pViewAdd = m_pView2;
      pViewRemove = m_pView1;
      m_currentView = cvView2;
   }
   else
   {
      pViewAdd = m_pView1;
      pViewRemove = m_pView2;
      m_currentView = cvView1;
   }

   // Set the child i.d. of the active view to AFX_IDW_PANE_FIRST,
   // so that CFrameWnd::RecalcLayout will allocate to this
   // "first pane" that portion of   the frame window's client area
   // not allocated to control   bars.  Set the child i.d. of the
   // other view to anything other than AFX_IDW_PANE_FIRST; this
   // examples switches the child id's of the two views.

   int nSwitchChildID = pViewAdd->GetDlgCtrlID();
   pViewAdd->SetDlgCtrlID(AFX_IDW_PANE_FIRST);
   pViewRemove->SetDlgCtrlID(nSwitchChildID);

   // Show the newly active view and hide the inactive view.

   pViewAdd->ShowWindow(SW_SHOW);
   pViewRemove->ShowWindow(SW_HIDE);

   // Connect the newly active view to the document, and
   // disconnect the inactive view.
   pDoc->AddView(pViewAdd);
   pDoc->RemoveView(pViewRemove);

   SetActiveView(pViewAdd);
   RecalcLayout();
}

CDocument::BeginReadChunks

Inicializálja az adattömbök olvasását.

virtual void BeginReadChunks ();

Megjegyzések

CDocument::CanCloseFrame

A keretrendszer meghívta a dokumentumot megjelenítő keretablak bezárása előtt.

virtual BOOL CanCloseFrame(CFrameWnd* pFrame);

Paraméterek

pFrame
A dokumentumhoz csatolt nézet keretablakára mutat.

Visszaadott érték

Nonzero, ha biztonságosan bezárja a keretablakot; egyéb esetben 0.

Megjegyzések

Az alapértelmezett implementáció ellenőrzi, hogy vannak-e más keretablakok, amelyek a dokumentumot jelenítik meg. Ha a megadott keretablak az utolsó, amely megjeleníti a dokumentumot, a függvény arra kéri a felhasználót, hogy mentse a dokumentumot, ha módosították. Bírálja felül ezt a függvényt, ha speciális feldolgozást szeretne végezni egy keretablak bezárásakor. Ez egy speciális felülírható.

CDocument::CDocument

Egy CDocument objektumot hoz létre.

CDocument();

Megjegyzések

A keretrendszer kezeli a dokumentumok létrehozását. Felülbírálja a OnNewDocument tagfüggvényt az inicializálás dokumentumonkénti végrehajtásához. Ez különösen fontos az egydokumentumos felületi (SDI-) alkalmazásokban.

CDocument::ClearChunkList

Törli az adattömbök listáját.

virtual void ClearChunkList ();

Megjegyzések

CDocument::ClearPathName

Törli a dokumentumobjektum elérési útját.

virtual void ClearPathName();

Megjegyzések

Ha törli az elérési utat egy CDocument objektumból, az alkalmazás rákérdez a felhasználóra a dokumentum következő mentésekor. Így a Mentés parancs a Mentés másként parancshoz hasonlóan viselkedik .

CDocument::DeleteContents

A keretrendszer meghívta, hogy törölje a dokumentum adatait az objektum megsemmisítése CDocument nélkül.

virtual void DeleteContents();

Megjegyzések

A rendszer éppen a dokumentum megsemmisítése előtt hívja meg. Azt is meg kell győződni arról, hogy egy dokumentum üres, mielőtt újra felhasználják. Ez különösen fontos egy olyan SDI-alkalmazás esetében, amely csak egy dokumentumot használ; a rendszer minden alkalommal újra felhasználja a dokumentumot, amikor a felhasználó létrehoz vagy megnyit egy másik dokumentumot. Hívja meg ezt a függvényt egy "Az összes törlése" vagy hasonló parancs implementálásához, amely törli a dokumentum összes adatát. A függvény alapértelmezett implementációja nem végez semmit. A függvény felülbírálása a dokumentum adatainak törléséhez.

Example

// This example is the handler for an Edit Clear All command.
void CExampleDoc::OnEditClearAll()
{
   DeleteContents();
   UpdateAllViews(NULL);
}

void CExampleDoc::DeleteContents()
{
   // Re-initialize document data here.
}

CDocument::FindChunk

Megadott GUID azonosítóval rendelkező adattömbet keres.

virtual POSITION FindChunk(
    REFCLSID guid,
    DWORD pid);

Paraméterek

guid
Megadja a megkeresendő adattömb GUID-azonosítóját.

pid
Egy megkeresni kívánt adattömb PID-jének megadása.

Visszaadott érték

A belső adattömb listában való pozíció, ha sikeres. Egyéb esetben NULL.

Megjegyzések

CDocument::GetAdapter

Az illesztőt implementáló IDocument objektumra mutató mutatót ad vissza.

virtual ATL::IDocument* GetAdapter();

Visszaadott érték

Az interfészt megvalósító IDocument objektumra mutató mutató.

Megjegyzések

CDocument::GetDocTemplate

Hívja meg ezt a függvényt, hogy az ehhez a dokumentumtípushoz tartozó dokumentumsablonra mutató mutatót kapjon.

CDocTemplate* GetDocTemplate() const;

Visszaadott érték

Az ehhez a dokumentumtípushoz tartozó dokumentumsablonra mutató mutató, vagy NULL értékű, ha a dokumentumot nem dokumentumsablon kezeli.

Example

// This example accesses the doc template object to construct
// a default document name such as SHEET.XLS, where "sheet"
// is the base document name and ".xls" is the file extension
// for the document type.
CString strDefaultDocName, strBaseName, strExt;
CDocTemplate *pDocTemplate = GetDocTemplate();
if (!pDocTemplate->GetDocString(strBaseName, CDocTemplate::docName) || !pDocTemplate->GetDocString(strExt, CDocTemplate::filterExt))
{
   AfxThrowUserException(); // These doc template strings will
                            // be available if you created the application using AppWizard
                            // and specified the file extension as an option for
                            // the document class produced by AppWizard.
}
strDefaultDocName = strBaseName + strExt;

CDocument::GetFile

Hívja meg ezt a tagfüggvényt, hogy mutatót kapjon egy CFile objektumhoz.

virtual CFile* GetFile(
    LPCTSTR lpszFileName,
    UINT nOpenFlags,
    CFileException* pError);

Paraméterek

lpszFileName
Egy sztring, amely a kívánt fájl elérési útja. Az elérési út lehet relatív vagy abszolút.

pError
Egy meglévő fájlkivételi objektumra mutató mutató, amely a művelet befejezési állapotát jelzi.

nOpenFlags
Megosztási és hozzáférési mód. Megadja a fájl megnyitásakor végrehajtandó műveletet. A CFile konstruktorban CFile::CFile felsorolt beállításokat a bitenkénti VAGY (|) operátorral kombinálhatja. Egy hozzáférési engedélyre és egy megosztási lehetőségre van szükség; a és modeNoInherit a modeCreate módok megadása nem kötelező.

Visszaadott érték

Egy objektumra mutató CFile mutató.

CDocument::GetFirstViewPosition

A függvény meghívásával lekérheti az első nézet helyét a dokumentumhoz társított nézetek listájában.

virtual POSITION GetFirstViewPosition() const;

Visszaadott érték

A POSITION tagfüggvénnyel GetNextView való iterációhoz használható érték.

Example

//To get the first view in the list of views:
//To get the first view in the list of views:
// POSITION pos = GetFirstViewPosition();
// CView* pFirstView = GetNextView(pos);
//
// This example uses CDocument::GetFirstViewPosition
// and GetNextView to repaint each view.
// An easier way to accomplish the same result is to call
// UpdateAllViews(NULL);
void CExampleDoc::OnRepaintAllViews()
{
   POSITION pos = GetFirstViewPosition();
   while (pos != NULL)
   {
      CView *pView = GetNextView(pos);
      pView->UpdateWindow();
   }
}

CDocument::GetNextView

Hívja meg ezt a függvényt a dokumentum összes nézetének iterálásához.

virtual CView* GetNextView(POSITION& rPosition) const;

Paraméterek

rPosition
Hivatkozás az POSITION előző hívás által a GetNextView tagfüggvényekhez GetFirstViewPosition visszaadott értékre. Ez az érték nem lehet NULL.

Visszaadott érték

Mutató az általa azonosított nézetre rPosition.

Megjegyzések

A függvény visszaadja az általa rPosition azonosított nézetet, majd a POSITION lista következő nézetének értékét állítja rPosition be. Ha a lekért nézet az utolsó a listában, akkor rPosition a beállítás értéke NULL.

Example

//To get the first view in the list of views:
//To get the first view in the list of views:
// POSITION pos = GetFirstViewPosition();
// CView* pFirstView = GetNextView(pos);
//
// This example uses CDocument::GetFirstViewPosition
// and GetNextView to repaint each view.
// An easier way to accomplish the same result is to call
// UpdateAllViews(NULL);
void CExampleDoc::OnRepaintAllViews()
{
   POSITION pos = GetFirstViewPosition();
   while (pos != NULL)
   {
      CView *pView = GetNextView(pos);
      pView->UpdateWindow();
   }
}

CDocument::GetPathName

A függvény meghívásával lekérheti a dokumentum lemezfájljának teljes elérési útját.

const CString& GetPathName() const;

Visszaadott érték

A dokumentum teljes elérési útja. Ez a sztring üres, ha a dokumentum nincs mentve, vagy nincs hozzá társítva lemezfájl.

CDocument::GetThumbnail

Létrehoz egy bitképet, amelyet a miniatűr-szolgáltató használ a miniatűr megjelenítéséhez.

virtual BOOL GetThumbnail(
    UINT cx,
    HBITMAP* phbmp,
    DWORD* pdwAlpha);

Paraméterek

cx
Megadja a bitkép szélességét és magasságát.

phbmp
Egy bitképhez tartozó leírót tartalmaz, amikor a függvény sikeresen visszatér.

pdwAlpha
DWORD Az alfa csatorna értékét adja meg, amikor a függvény sikeresen visszatér.

Visszaadott érték

Visszaadja TRUE , ha a miniatűrhöz tartozó bitkép sikeresen létrejött, ellenkező esetben FALSE.

Megjegyzések

CDocument::GetTitle

Hívja meg ezt a függvényt a dokumentum címének lekéréséhez, amely általában a dokumentum fájlnevéből származik.

const CString& GetTitle() const;

Visszaadott érték

A dokumentum címe.

CDocument::InitializeSearchContent

A Keresési kezelő keresési tartalmának inicializálására van meghívva.

virtual void InitializeSearchContent ();

Megjegyzések

Felülbírálja ezt a metódust egy származtatott osztályban a keresési tartalom inicializálásához. A tartalomnak olyan sztringnek kell lennie, amely ";" által tagolt részeket tartalmaz. Például: "pont; Téglalap; ole item".

CDocument::IsModified

Hívja meg ezt a függvényt annak megállapításához, hogy a dokumentum módosult-e a legutóbbi mentés óta.

virtual BOOL IsModified();

Visszaadott érték

Nem érvényes, ha a dokumentumot a legutóbbi mentés óta módosították; egyéb esetben 0.

CDocument::IsSearchAndOrganizeHandler

Azt jelzi, hogy ez a CDocument példány a Keresés és rendszerezés kezelőhöz lett-e létrehozva.

BOOL IsSearchAndOrganizeHandler() const;

Visszaadott érték

Visszaadja TRUE , ha ez a CDocument példány a Keresés és rendszerezés kezelőhöz lett létrehozva.

Megjegyzések

Ez a függvény jelenleg csak a folyamaton kívüli kiszolgálón implementált Rich Preview kezelőknek ad vissza TRUE . Az alkalmazás szintjén beállíthatja a megfelelő jelzőket (m_bPreviewHandlerMode, m_bSearchMode, m_bGetThumbnailMode) a függvény visszatéréséhez TRUE.

CDocument::LoadDocumentFromStream

Meghívva a dokumentumadatok streamből való betöltésére.

virtual HRESULT LoadDocumentFromStream(
    IStream* pStream,
    DWORD dwGrfMode);

Paraméterek

pStream
Egy streamre mutató mutató. Ezt a streamet a Shell biztosítja.

dwGrfMode
Hozzáférési mód a streamhez.

Visszaadott érték

S_OK ha a terhelési művelet sikeres, ellenkező esetben HRESULT hibakóddal.

Megjegyzések

Ezt a metódust felülbírálhatja egy származtatott osztályban az adatok streamből való betöltésének testreszabásához.

CDocument::m_bGetThumbnailMode

Megadja, hogy az objektumot a CDocument dllhost hozta létre miniatűrökhöz. Be kell jelentkeznie CView::OnDraw.

BOOL m_bGetThumbnailMode;

Megjegyzések

TRUE azt jelzi, hogy a dokumentumot a dllhost hozta létre miniatűrök számára.

CDocument::m_bPreviewHandlerMode

Megadja, hogy az objektumot a CDocument prevhost hozta létre a Rich Preview számára. Be kell jelentkeznie CView::OnDraw.

BOOL m_bPreviewHandlerMode;

Megjegyzések

TRUE azt jelzi, hogy a dokumentumot a prevhost hozta létre a Rich Preview számára.

CDocument::m_bSearchMode

Azt adja meg, hogy az CDocument objektumot indexelő vagy egy másik keresőalkalmazás hozta létre.

BOOL m_bSearchMode;

Megjegyzések

TRUE azt jelzi, hogy a dokumentumot az indexelő vagy egy másik keresőalkalmazás hozta létre.

CDocument::m_clrRichPreviewBackColor

A Rich Preview ablak háttérszínét adja meg. Ezt a színt a gazdagép állítja be.

COLORREF m_clrRichPreviewBackColor;

Megjegyzések

CDocument::m_clrRichPreviewTextColor

A Rich Preview ablak előtérszínét adja meg. Ezt a színt a gazdagép állítja be.

COLORREF m_clrRichPreviewTextColor;

Megjegyzések

CDocument::m_lfRichPreviewFont

A Rich Preview ablak szöveg betűtípusát adja meg. Ezt a betűtípus-információt a gazdagép állítja be.

CFont m_lfRichPreviewFont;

Megjegyzések

CDocument::OnBeforeRichPreviewFontChanged

A Rich Preview betűtípus módosítása előtt hívható meg.

virtual void OnBeforeRichPreviewFontChanged();

Megjegyzések

CDocument::OnChangedViewList

A keretrendszer meghívta, miután hozzáadtak vagy eltávolítottak egy nézetet a dokumentumból.

virtual void OnChangedViewList();

Megjegyzések

A függvény alapértelmezett implementációja ellenőrzi, hogy az utolsó nézet el lett-e távolítva, és ha igen, törli a dokumentumot. Bírálja felül ezt a függvényt, ha speciális feldolgozást szeretne végezni, amikor a keretrendszer hozzáad vagy eltávolít egy nézetet. Ha például azt szeretné, hogy egy dokumentum akkor is nyitva maradjon, ha nincs hozzá csatolt nézet, felülbírálja ezt a függvényt.

CDocument::OnCloseDocument

A keretrendszer meghívja a dokumentum bezárásakor, általában a Fájlbezárás parancs részeként.

virtual void OnCloseDocument();

Megjegyzések

A függvény alapértelmezett implementációja megsemmisíti a dokumentum megtekintéséhez használt összes keretet, bezárja a nézetet, megtisztítja a dokumentum tartalmát, majd meghívja a DeleteContents tagfüggvényt a dokumentum adatainak törlésére.

Bírálja felül ezt a függvényt, ha speciális törlési feldolgozást szeretne végezni, amikor a keretrendszer bezár egy dokumentumot. Ha például a dokumentum egy rekordot jelöl egy adatbázisban, érdemes lehet felülírni ezt a függvényt az adatbázis bezárásához. A felülbírálásból meg kell hívnia ennek a függvénynek az alaposztály-verzióját.

CDocument::OnCreatePreviewFrame

A keretrendszer meghívja, amikor előképkeretet kell létrehoznia a Rich Preview számára.

virtual BOOL OnCreatePreviewFrame();

Visszaadott érték

Visszaadja TRUE , ha a keret sikeresen létrejött, ellenkező esetben FALSE.

Megjegyzések

CDocument::OnDocumentEvent

A keretrendszer meghívta egy dokumentumeseményre válaszul.

virtual void OnDocumentEvent(DocumentEvent deEvent);

Paraméterek

deEvent
[in] Az esemény típusát leíró számbavételes adattípus.

Megjegyzések

A dokumentumesemények több osztályt is érinthetnek. Ez a módszer felelős az osztálytól eltérő osztályokat érintő dokumentumesemények kezeléséértCDocument. Jelenleg csak az osztálynak kell válaszolnia a CDataRecoveryHandlerdokumentumeseményekre. Az CDocument osztály más felülbírálható metódusokat is használ a hatás kezeléséért.CDocument

Az alábbi táblázat a lehetséges értékeket deEvent és az azoknak megfelelő eseményeket sorolja fel.

Érték	Megfelelő esemény
onAfterNewDocument	Létre lett hozva egy új dokumentum.
onAfterOpenDocument	Megnyílt egy új dokumentum.
onAfterSaveDocument	A dokumentum mentése megtörtént.
onAfterCloseDocument	A dokumentumot bezárták.

CDocument::OnDrawThumbnail

Felülbírálja ezt a metódust egy származtatott osztályban a miniatűr rajzolásához.

virtual void OnDrawThumbnail(
    CDC& dc,
    LPRECT lprcBounds);

Paraméterek

dc
Eszközkörnyezetre mutató hivatkozás.

lprcBounds
Megadja annak a területnek a határoló téglalapját, ahol a miniatűrt meg kell rajzolni.

Megjegyzések

CDocument::OnFileSendMail

Üzenet küldése a rezidens levelezési állomáson keresztül (ha van ilyen), mellékletként a dokumentummal.

void OnFileSendMail();

Megjegyzések

OnFileSendMail meghívja OnSaveDocument a névtelen és módosított dokumentumok szerializálására (mentésére) egy ideiglenes fájlba, amelyet aztán elektronikus levélben küld el. Ha a dokumentum nem lett módosítva, nincs szükség ideiglenes fájlra; a rendszer elküldi az eredetit. OnFileSendMail betölti MAPI32.DLL, ha még nincs betöltve.

Az összetett fájlok helyes kezelésére szolgáló COleDocument speciális implementációOnFileSendMail.

CDocument támogatja a dokumentum e-mailben történő küldését, ha a levéltámogatás (MAPI) jelen van. Lásd a MAPI-témakörök és a MAPI-támogatás az MFC-ben című cikket.

CDocument::OnLoadDocumentFromStream

A keretrendszer meghívja, amikor be kell töltenie a dokumentumadatokat egy streamből.

virtual HRESULT OnLoadDocumentFromStream(
    IStream* pStream,
    DWORD grfMode);

Paraméterek

pStream
Egy bejövő streamre mutató mutató.

grfMode
Hozzáférési mód a streamhez.

Visszaadott érték

S_OK ha a terhelés sikeres; egyéb esetben hibakód.

Megjegyzések

CDocument::OnNewDocument

A keretrendszer meghívta az Új fájl parancs részeként.

virtual BOOL OnNewDocument();

Visszaadott érték

Nem érvényes, ha a dokumentum inicializálása sikeresen megtörtént; egyéb esetben 0.

Megjegyzések

A függvény alapértelmezett implementációja meghívja a DeleteContents tagfüggvényt annak biztosítására, hogy a dokumentum üres legyen, majd az új dokumentumot tisztaként jelölje meg. Felülbírálja ezt a függvényt egy új dokumentum adatstruktúrájának inicializálásához. A felülbírálásból meg kell hívnia ennek a függvénynek az alaposztály-verzióját.

Ha a felhasználó az Új fájl parancsot választja egy SDI-alkalmazásban, a keretrendszer ezt a függvényt használja a meglévő dokumentum újraincializálására ahelyett, hogy újat hoz létre. Ha a felhasználó az Új fájl lehetőséget választja több dokumentumfelületi (MDI-) alkalmazásban, a keretrendszer minden alkalommal létrehoz egy új dokumentumot, majd meghívja ezt a függvényt az inicializálására. Az inicializálási kódot ebben a függvényben kell elhelyeznie, nem pedig az Új fájl parancs konstruktorában ahhoz, hogy az SDI-alkalmazásokban hatékony legyen.

Vegye figyelembe, hogy vannak olyan esetek, amikor OnNewDocument kétszer hívjuk meg. Ez akkor fordul elő, ha a dokumentum ActiveX-dokumentumkiszolgálóként van beágyazva. A függvényt először a CreateInstance metódus hívja meg (a COleObjectFactory-származtatott osztály teszi elérhetővé), másodszor pedig a InitNew metódus (a COleServerDoc-származtatott osztály teszi közzé).

Example

Az alábbi példák egy dokumentumobjektum inicializálásának alternatív módszereit szemléltetik.

// Method 1: In an MDI application, the simplest place to do
// initialization is in the document constructor.  The framework
// always creates a new document object for File New or File Open.
CExampleDoc::CExampleDoc()
{
   // Do initialization of MDI document here.
}

 

// Method 2: In an SDI or MDI application, do all initialization
// in an override of OnNewDocument, if you are certain that
// the initialization is effectively saved upon File Save
// and fully restored upon File Open, via serialization.
BOOL CMyDoc::OnNewDocument()
{
   if (!CDocument::OnNewDocument())
   {
      return FALSE;
   }

   // Do initialization of new document here.

   return TRUE;
}

 

// Method 3: If the initialization of your document is not
// effectively saved and restored by serialization (during File Save
// and File Open), then implement the initialization in single
// function (named InitMyDocument in this example).  Call the
// shared initialization function from overrides of both
// OnNewDocument and OnOpenDocument.
BOOL CExampleDoc::OnNewDocument()
{
   if (!CDocument::OnNewDocument())
   {
      return FALSE;
   }

   InitMyDocument(); // call your shared initialization function

   // If your new document object requires additional initialization
   // not necessary when the document is deserialized via File Open,
   // then perform that additional initialization here.

   return TRUE;
}

CDocument::OnOpenDocument

A keretrendszer meghívja a Fájlmegnyitás parancs részeként.

virtual BOOL OnOpenDocument(LPCTSTR lpszPathName);

Paraméterek

lpszPathName
A megnyitni kívánt dokumentum elérési útjára mutat.

Visszaadott érték

Sikertelen, ha a dokumentum betöltése sikeresen megtörtént; egyéb esetben 0.

Megjegyzések

A függvény alapértelmezett implementációja megnyitja a megadott fájlt, meghívja a DeleteContents tagfüggvényt annak biztosítására, hogy a dokumentum üres legyen, felhívja CObject::Serialize a fájl tartalmának olvasására, majd jelölje meg a dokumentumot tisztaként. Bírálja felül ezt a függvényt, ha nem az archív mechanizmust vagy a fájlmechanizmust szeretné használni. Írhat például olyan alkalmazást, amelyben a dokumentumok nem különálló fájlokat, hanem egy adatbázisban lévő rekordokat jelölnek.

Ha a felhasználó a Fájlmegnyitás parancsot választja egy SDI-alkalmazásban, a keretrendszer ezt a függvényt használja a meglévő CDocument objektum újraincializálására ahelyett, hogy újat hoz létre. Ha a felhasználó egy MDI-alkalmazásban a Fájlmegnyitás lehetőséget választja, a keretrendszer minden alkalommal létrehoz egy új CDocument objektumot, majd meghívja ezt a függvényt az inicializálásához. Az inicializálási kódot ebben a függvényben kell elhelyeznie, nem pedig a Fájlmegnyitás parancs konstruktorában ahhoz, hogy az SDI-alkalmazásokban érvényes legyen.

Example

Az alábbi példák egy dokumentumobjektum inicializálásának alternatív módszereit szemléltetik.

// Method 1: In an MDI application, the simplest place to do
// initialization is in the document constructor.  The framework
// always creates a new document object for File New or File Open.
CExampleDoc::CExampleDoc()
{
   // Do initialization of MDI document here.
}

 

// Method 2: In an SDI or MDI application, do all initialization
// in an override of OnNewDocument, if you are certain that
// the initialization is effectively saved upon File Save
// and fully restored upon File Open, via serialization.
BOOL CMyDoc::OnNewDocument()
{
   if (!CDocument::OnNewDocument())
   {
      return FALSE;
   }

   // Do initialization of new document here.

   return TRUE;
}

 

// Method 3: If the initialization of your document is not
// effectively saved and restored by serialization (during File Save
// and File Open), then implement the initialization in single
// function (named InitMyDocument in this example).  Call the
// shared initialization function from overrides of both
// OnNewDocument and OnOpenDocument.
BOOL CExampleDoc::OnNewDocument()
{
   if (!CDocument::OnNewDocument())
   {
      return FALSE;
   }

   InitMyDocument(); // call your shared initialization function

   // If your new document object requires additional initialization
   // not necessary when the document is deserialized via File Open,
   // then perform that additional initialization here.

   return TRUE;
}

 

// Additional example of OnOpenDocument()
BOOL CExampleDoc::OnOpenDocument(LPCTSTR lpszPathName)
{
   if (!CDocument::OnOpenDocument(lpszPathName))
   {
      return FALSE;
   }

   InitMyDocument(); // call your shared initialization function

   return TRUE;
}

CDocument::OnPreviewHandlerQueryFocus

Az előnézeti kezelőt arra utasítja, hogy visszaadja a HWND függvény meghívásából GetFocus lekért adatokat.

virtual HRESULT OnPreviewHandlerQueryFocus(HWND* phwnd);

Paraméterek

phwnd
[kifelé] Amikor ez a metódus visszatér, egy mutatót tartalmaz a HWND-hez, amely az GetFocus előnézeti kezelő előtérszálából hívja meg a függvényt.

Visszaadott érték

S_OK Eredmény, ha sikeres; vagy egyéb hibaérték.

Megjegyzések

CDocument::OnPreviewHandlerTranslateAccelerator

Az előnézeti kezelőt arra irányítja, hogy kezelje a folyamat üzenetpumpa által átadott billentyűleütést, amelyben az előzetes kezelő fut.

virtual HRESULT OnPreviewHandlerTranslateAccelerator(MSG* pmsg);

Paraméterek

pmsg
[in] Egy ablaküzenetre mutató mutató.

Visszaadott érték

Ha a billentyűleütési üzenetet az előnézeti kezelő feldolgozhatja, a kezelő feldolgozza és visszaadja S_OK. Ha az előnézeti kezelő nem tudja feldolgozni a billentyűleütési üzenetet, felajánlja a gazdagépnek a következőn keresztül IPreviewHandlerFrame::TranslateAccelerator: . Ha a gazdagép feldolgozza az üzenetet, ez a metódus ad vissza S_OK. Ha a gazdagép nem dolgozza fel az üzenetet, ez a metódus ad vissza S_FALSE.

Megjegyzések

CDocument::OnRichPreviewBackColorChanged

A Rich Preview háttérszínének módosításakor hívható meg.

virtual void OnRichPreviewBackColorChanged();

Megjegyzések

CDocument::OnRichPreviewFontChanged

A Rich Preview betűtípus módosításakor hívható meg.

virtual void OnRichPreviewFontChanged();

Megjegyzések

CDocument::OnRichPreviewSiteChanged

A Rich Preview webhely módosításakor hívható meg.

virtual void OnRichPreviewSiteChanged();

Megjegyzések

CDocument::OnRichPreviewTextColorChanged

A Rich Preview szövegszínének módosításakor hívható meg.

virtual void OnRichPreviewTextColorChanged();

Megjegyzések

CDocument::OnSaveDocument

A keretrendszer meghívja a Fájlmentés vagy a Fájlmentés másként parancs részeként.

virtual BOOL OnSaveDocument(LPCTSTR lpszPathName);

Paraméterek

lpszPathName
Arra a teljes elérési útra mutat, amelyre a fájlt menteni kell.

Visszaadott érték

Nem érvényes, ha a dokumentum mentése sikeresen megtörtént; egyéb esetben 0.

Megjegyzések

A függvény alapértelmezett implementációja megnyitja a megadott fájlt, meghívja CObject::Serialize a dokumentum adatainak a fájlba írását, majd tisztaként jelöli meg a dokumentumot. Bírálja felül ezt a függvényt, ha speciális feldolgozást szeretne végezni, amikor a keretrendszer ment egy dokumentumot. Írhat például olyan alkalmazást, amelyben a dokumentumok nem különálló fájlokat, hanem egy adatbázisban lévő rekordokat jelölnek.

CDocument::OnUnloadHandler

Az előzetes verzió kezelőjének eltávolításakor a keretrendszer hívja meg.

virtual void OnUnloadHandler();

Megjegyzések

CDocument::OnUpdateFileSendMail

Engedélyezi a ID_FILE_SEND_MAIL parancsot, ha a levelezési támogatás (MAPI) jelen van.

void OnUpdateFileSendMail(CCmdUI* pCmdUI);

Paraméterek

pCmdUI
A parancshoz ID_FILE_SEND_MAIL társított objektumra mutató mutatóCCmdUI.

Megjegyzések

Ellenkező esetben a függvény eltávolítja a ID_FILE_SEND_MAIL parancsot a menüből, beleértve a menüelem feletti vagy alatti elválasztókat is. A MAPI engedélyezve van, ha MAPI32.DLL szerepel a fájl elérési útjának és a fájl [Mail] szakaszában a WIN.INI MAPI=1. A legtöbb alkalmazás ezt a parancsot a Fájl menübe helyezi.

CDocument támogatja a dokumentum e-mailben történő küldését, ha a levéltámogatás (MAPI) jelen van. Lásd a MAPI-témakörök és a MAPI-támogatás az MFC-ben című cikket.

CDocument::PreCloseFrame

Ezt a tagfüggvényt a keretrendszer hívja meg a keretablak megsemmisítése előtt.

virtual void PreCloseFrame(CFrameWnd* pFrame);

Paraméterek

pFrame
Mutasson a CFrameWnd társított objektumot tartalmazó objektumra CDocument .

Megjegyzések

Felül lehet bírálni az egyéni törlést, de mindenképpen hívja meg az alaposztályt is.

Az alapértelmezett beállítás PreCloseFrame nem tartalmaz semmit.CDocument A CDocument-származtatott osztályok COleDocument , és CRichEditDoc ezt a tagfüggvényt használják.

CDocument::ReadNextChunkValue

Beolvassa a következő adattömbértéket.

virtual BOOL ReadNextChunkValue(IFilterChunkValue** ppValue);

Paraméterek

ppValue
[kifelé] Amikor a függvény visszatér, ppValue az olvasott értéket tartalmazza.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

CDocument::ReleaseFile

Ezt a tagfüggvényt a keretrendszer meghívja egy fájl kiadásához, így az más alkalmazások számára is elérhetővé válik.

virtual void ReleaseFile(
    CFile* pFile,
    BOOL bAbort);

Paraméterek

pFile
Mutató a CFile felszabadítani kívánt objektumra.

bAbort
Azt határozza meg, hogy a fájlt vagy a használatával CFile::CloseCFile::Abortkell-e kiadni. FALSE ha a fájlt a következővel CFile::Closekell kiadni: ha TRUE a fájlt a következővel CFile::Abortkell kiadni: .

Megjegyzések

Ha bAbort igen TRUE, ReleaseFile hívások CFile::Abort, és a fájl ki van adva. CFile::Abort nem fog kivételt kivenni.

Ha bAbort igen FALSE, ReleaseFile akkor a hívások CFile::Close és a fájl ki lesz adva.

Bírálja felül ezt a tagfüggvényt, hogy a felhasználónak a fájl kiadása előtt műveletet kelljen elvégeznie.

CDocument::RemoveChunk

Eltávolítja a megadott GUIDadattömböket.

virtual void RemoveChunk(
    REFCLSID guid,
    DWORD pid);

Paraméterek

Guid
Megadja az GUID eltávolítandó adattömböket.

Pid
Megadja az PID eltávolítandó adattömböket.

Megjegyzések

CDocument::RemoveView

Hívja meg ezt a függvényt, hogy leválasztsa a nézetet egy dokumentumról.

void RemoveView(CView* pView);

Paraméterek

pView
Az eltávolított nézetre mutat.

Megjegyzések

Ez a függvény eltávolítja a megadott nézetet a dokumentumhoz társított nézetek listájából; a nézet dokumentummutatóját is a következőre NULLállítja: . Ezt a függvényt a keretrendszer hívja meg, ha egy keretablak bezárul, vagy egy elválasztó ablak ablaktábla van bezárva.

Ezt a függvényt csak akkor hívja meg, ha manuálisan leválaszt egy nézetet. A keretrendszer általában egy objektum definiálásával CDocTemplate leválasztja a dokumentumokat és nézeteket a dokumentumosztály, a nézetosztály és a keretablak-osztály társításához.

Tekintse meg a példát AddView egy minta implementációhoz.

CDocument::ReportSaveLoadException

Akkor hívható meg, ha a dokumentum mentése vagy betöltése során kivételt (általában egy CFileException vagy CArchiveException) ad ki.

virtual void ReportSaveLoadException(
    LPCTSTR lpszPathName,
    CException* e,
    BOOL bSaving,
    UINT nIDPDefault);

Paraméterek

lpszPathName
A mentett vagy betöltött dokumentum nevére mutat.

e
A kidobott kivételre mutat. NULLLehet .

bSaving
A folyamatban lévő műveletet jelző jelző; nonzero, ha a dokumentum mentése folyamatban van, 0, ha a dokumentum betöltése folyamatban van.

nIDPDefault
A megjelenítendő hibaüzenet azonosítója, ha a függvény nem ad meg konkrétabbat.

Megjegyzések

Az alapértelmezett implementáció megvizsgálja a kivételobjektumot, és egy olyan hibaüzenetet keres, amely kifejezetten leírja az okot. Ha egy adott üzenet nem található, vagy ha e igen NULL, akkor a paraméter által megadott általános üzenetet használja a nIDPDefault rendszer. A függvény ekkor megjeleníti a hibaüzenetet tartalmazó üzenetmezőt. Felülbírálja ezt a függvényt, ha további, testre szabott hibaüzeneteket szeretne küldeni. Ez egy speciális felülírható.

CDocument::SaveModified

A keretrendszer meghívta, mielőtt egy módosított dokumentumot be kellene zárni.

virtual BOOL SaveModified();

Visszaadott érték

Nonzero, ha biztonságos a dokumentum folytatása és bezárása; 0, ha a dokumentumot nem szabad bezárni.

Megjegyzések

A függvény alapértelmezett implementációja egy üzenetmezőt jelenít meg, amely megkérdezi a felhasználót, hogy menti-e a dokumentum módosításait, ha történt ilyen. Bírálja felül ezt a függvényt, ha a program más kérési eljárást igényel. Ez egy speciális felülírható.

CDocument::SetChunkValue

Adattömbértéket állít be.

virtual BOOL SetChunkValue (IFilterChunkValue* pValue);

Paraméterek

pValue
Megadja a beállítani kívánt adattömbértéket.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

CDocument::SetModifiedFlag

Hívja meg ezt a függvényt, miután módosította a dokumentumot.

virtual void SetModifiedFlag(BOOL bModified = TRUE);

Paraméterek

bModified
Jelző, amely jelzi, hogy a dokumentum módosult-e.

Megjegyzések

A függvény konzisztens meghívásával győződjön meg arról, hogy a keretrendszer arra kéri a felhasználót, hogy mentse a módosításokat a dokumentum bezárása előtt. Általában a paraméter alapértelmezett értékét TRUEbModified kell használnia. Ha tisztaként (nem módosítottként) szeretne megjelölni egy dokumentumot, hívja meg ezt a függvényt a "" FALSEértékkel.

CDocument::SetPathName

Hívja meg ezt a függvényt a dokumentum lemezfájljának teljes elérési útjának megadásához.

virtual void SetPathName(
    LPCTSTR lpszPathName,
    BOOL bAddToMRU = TRUE);

Paraméterek

lpszPathName
A dokumentum elérési útjaként használandó sztringre mutat.

bAddToMRU
Meghatározza, hogy a fájlnév hozzáadva van-e a legutóbb használt (MRU) fájllistához. Ha TRUE, a fájlnév hozzáadva; ha FALSE, akkor nincs hozzáadva.

Megjegyzések

Az elérési út értékétől bAddToMRU függően a rendszer hozzáadja vagy nem adja hozzá az alkalmazás által fenntartott MRU-listához. Vegye figyelembe, hogy egyes dokumentumok nincsenek lemezfájlhoz társítva. Ezt a függvényt csak akkor hívja meg, ha felülírja a keretrendszer által használt fájlok megnyitásának és mentésének alapértelmezett implementációját.

CDocument::SetTitle

Hívja meg ezt a függvényt a dokumentum címének megadásához (a keretablak címsorában megjelenő sztring).

virtual void SetTitle(LPCTSTR lpszTitle);

Paraméterek

lpszTitle
A dokumentum címeként használandó sztringre mutat.

Megjegyzések

A függvény meghívása frissíti a dokumentumot megjelenítő összes keretablak címét.

CDocument::UpdateAllViews

A függvény meghívása a dokumentum módosítása után.

void UpdateAllViews(
    CView* pSender,
    LPARAM lHint = 0L,
    CObject* pHint = NULL);

Paraméterek

pSender
A dokumentumot módosító nézetre mutat, vagy NULL ha minden nézetet frissíteni szeretne.

lHint
A módosítással kapcsolatos információkat tartalmaz.

pHint
Egy objektumra mutat, amely a módosítással kapcsolatos információkat tárolja.

Megjegyzések

A tagfüggvény meghívása után ezt a függvényt SetModifiedFlag kell meghívnia. Ez a függvény tájékoztatja a dokumentumhoz csatolt nézeteket, kivéve a megadott pSendernézetet, hogy a dokumentum módosult. Ezt a függvényt általában a nézetosztályból hívhatja meg, miután a felhasználó egy nézetben módosította a dokumentumot.

Ez a függvény meghívja a CView::OnUpdate tagfüggvényt a dokumentum minden nézetéhez, kivéve a küldési nézetet, a továbbítást pHint és lHinta . Ezekkel a paraméterekkel információkat adhat át a dokumentum módosításaival kapcsolatos nézeteknek. Az adatokat lHint kódolhatja és/vagy definiálhat egy CObject-származtatott osztályt, amellyel információkat tárolhat a módosításokról, és átadhat egy objektumot az osztálynak a használatával pHint. Felülbírálja a CView::OnUpdate tagfüggvényt a CViewszármaztatott osztályban, hogy optimalizálja a nézet megjelenítésének frissítését az átadott információk alapján.

Example

void CExampleDoc::OnUpdateAllViews()
{
   UpdateAllViews(NULL);
}

Lásd még

MFC-minta MDIDOCVW
MFC-minta SNAPVW
MFC-minta NPP
CCmdTarget osztály
hierarchiadiagram
CCmdTarget osztály
CView osztály
CDocTemplate osztály