Share via

CDocument-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Biedt de basisfunctionaliteit voor door de gebruiker gedefinieerde documentklassen.

Syntaxis

class CDocument : public CCmdTarget

Leden

Openbare constructors

Naam Description
CDocument::CDocument Maakt een CDocument object.

Openbare methoden

Naam Description
CDocument::AddView Hiermee wordt een weergave aan het document gekoppeld.
CDocument::BeginReadChunks Initialiseert segmentleesbewerkingen.
CDocument::CanCloseFrame Geavanceerd overschrijven; wordt aangeroepen voordat u een framevenster sluit dat dit document bekijkt.
CDocument::ClearChunkList Hiermee wist u de segmentlijst.
CDocument::ClearPathName Hiermee wist u het pad van het documentobject.
CDocument::DeleteContents Aangeroepen om het document op te ruimen.
CDocument::FindChunk Hiermee wordt gezocht naar een segment met de opgegeven GUID.
CDocument::GetAdapter Hiermee wordt een aanwijzer geretourneerd voor het implementeren van IDocument objecten.
CDocument::GetDocTemplate Retourneert een aanwijzer naar de documentsjabloon waarin het type van het document wordt beschreven.
CDocument::GetFile Retourneert een aanwijzer naar het gewenste CFile object.
CDocument::GetFirstViewPosition Retourneert de positie van de eerste in de lijst met weergaven; wordt gebruikt om te beginnen met iteratie.
CDocument::GetNextView Doorloopt de lijst met weergaven die aan het document zijn gekoppeld.
CDocument::GetPathName Retourneert het pad van het gegevensbestand van het document.
CDocument::GetThumbnail Wordt aangeroepen om een bitmap te maken die door de miniatuurprovider moet worden gebruikt om miniatuur weer te geven.
CDocument::GetTitle Retourneert de titel van het document.
CDocument::InitializeSearchContent Aangeroepen om zoekinhoud voor zoekhandler te initialiseren.
CDocument::IsModified Hiermee wordt aangegeven of het document is gewijzigd sinds het voor het laatst is opgeslagen.
CDocument::IsSearchAndOrganizeHandler Hiermee wordt aangegeven of dit exemplaar van CDocument het object is gemaakt voor de handler Search & Organize.
CDocument::LoadDocumentFromStream Aangeroepen om documentgegevens uit de stream te laden.
CDocument::OnBeforeRichPreviewFontChanged Aangeroepen voordat het lettertype Rich Preview wordt gewijzigd.
CDocument::OnChangedViewList Aangeroepen nadat een weergave is toegevoegd aan of verwijderd uit het document.
CDocument::OnCloseDocument Aangeroepen om het document te sluiten.
CDocument::OnCreatePreviewFrame Aangeroepen door het framework wanneer er een voorbeeldframe moet worden gemaakt voor Uitgebreide preview.
CDocument::OnDocumentEvent Aangeroepen door het framework als reactie op een document gebeurtenis.
CDocument::OnDrawThumbnail Overschrijf deze methode in een afgeleide klasse om inhoud van miniatuur te tekenen.
CDocument::OnLoadDocumentFromStream Aangeroepen door het framework wanneer de documentgegevens uit de stroom moeten worden geladen.
CDocument::OnNewDocument Aangeroepen om een nieuw document te maken.
CDocument::OnOpenDocument Wordt aangeroepen om een bestaand document te openen.
CDocument::OnPreviewHandlerQueryFocus Hiermee wordt de preview-handler om terug HWND te keren van het aanroepen van de GetFocus functie.
CDocument::OnPreviewHandlerTranslateAccelerator Stuurt de preview-handler om een toetsaanslag af te handelen die is doorgegeven vanaf de berichtpomp van het proces waarin de preview-handler wordt uitgevoerd.
CDocument::OnRichPreviewBackColorChanged Wordt aangeroepen wanneer de achtergrondkleur van rich preview is gewijzigd.
CDocument::OnRichPreviewFontChanged Aangeroepen wanneer het lettertype Rich Preview is gewijzigd.
CDocument::OnRichPreviewSiteChanged Aangeroepen wanneer de rich preview-site is gewijzigd.
CDocument::OnRichPreviewTextColorChanged Aangeroepen wanneer de tekstkleur van het rtf-voorbeeld is gewijzigd.
CDocument::OnSaveDocument Wordt aangeroepen om het document op schijf op te slaan.
CDocument::OnUnloadHandler Aangeroepen door het framework wanneer de preview-handler wordt uitgepakt.
CDocument::PreCloseFrame Aangeroepen voordat het framevenster wordt gesloten.
CDocument::ReadNextChunkValue Leest de volgende segmentwaarde.
CDocument::ReleaseFile Hiermee wordt een bestand vrijgegeven om het beschikbaar te maken voor gebruik door andere toepassingen.
CDocument::RemoveChunk Hiermee verwijdert u een segment met de opgegeven GUID.
CDocument::RemoveView Er wordt een weergave losgekoppeld van het document.
CDocument::ReportSaveLoadException Geavanceerd overschrijven; wordt aangeroepen wanneer een bewerking voor openen of opslaan niet kan worden voltooid vanwege een uitzondering.
CDocument::SaveModified Geavanceerd overschrijven; wordt aangeroepen om de gebruiker te vragen of het document moet worden opgeslagen.
CDocument::SetChunkValue Hiermee stelt u een segmentwaarde in.
CDocument::SetModifiedFlag Hiermee stelt u een vlag in die aangeeft dat u het document hebt gewijzigd sinds het voor het laatst is opgeslagen.
CDocument::SetPathName Hiermee stelt u het pad in van het gegevensbestand dat door het document wordt gebruikt.
CDocument::SetTitle Hiermee stelt u de titel van het document in.
CDocument::UpdateAllViews Alle weergaven die het document heeft gewijzigd, worden op de hoogte gebracht.

Beveiligde methoden

Naam Description
CDocument::OnFileSendMail Hiermee wordt een e-mailbericht verzonden waaraan het document is gekoppeld.
CDocument::OnUpdateFileSendMail Hiermee schakelt u de opdracht E-mail verzenden in als er ondersteuning voor e-mail aanwezig is.

Leden van openbare gegevens

Naam Description
CDocument::m_bGetThumbnailMode Hiermee geeft u op dat CDocument het object is gemaakt door dllhost voor miniaturen. Moet worden ingecheckt CView::OnDraw.
CDocument::m_bPreviewHandlerMode Hiermee geeft u op dat CDocument het object is gemaakt door prevhost voor Rich Preview. Moet worden ingecheckt CView::OnDraw.
CDocument::m_bSearchMode Hiermee geeft u op dat CDocument het object is gemaakt door de indexeerfunctie of een andere zoektoepassing.
CDocument::m_clrRichPreviewBackColor Hiermee geeft u de achtergrondkleur van het venster Rich Preview op. Deze kleur wordt ingesteld door de host.
CDocument::m_clrRichPreviewTextColor Hiermee geeft u de voorgrondkleur van het venster Rich Preview op. Deze kleur wordt ingesteld door de host.
CDocument::m_lfRichPreviewFont Hiermee geeft u het tekstlettertype voor het venster Rich Preview op. Deze lettertypegegevens worden ingesteld door de host.

Opmerkingen

Een document vertegenwoordigt de gegevenseenheid die de gebruiker doorgaans opent met de opdracht Bestand openen en wordt opgeslagen met de opdracht Bestand opslaan.

CDocument ondersteunt standaardbewerkingen, zoals het maken van een document, het laden ervan en het opslaan ervan. Het framework bewerkt documenten met behulp van de interface die is gedefinieerd door CDocument.

Een toepassing kan meer dan één type document ondersteunen; Een toepassing ondersteunt bijvoorbeeld zowel spreadsheets als tekstdocumenten. Elk type document heeft een bijbehorende documentsjabloon; de documentsjabloon geeft aan welke resources (bijvoorbeeld menu, pictogram of acceleratortabel) worden gebruikt voor dat type document. Elk document bevat een aanwijzer naar het bijbehorende CDocTemplate object.

Gebruikers communiceren met een document via de CView objecten die eraan zijn gekoppeld. Een weergave geeft een afbeelding van het document weer in een framevenster en interpreteert gebruikersinvoer als bewerkingen in het document. Aan een document kunnen meerdere weergaven zijn gekoppeld. Wanneer de gebruiker een venster in een document opent, wordt er een weergave gemaakt en aan het document gekoppeld. De documentsjabloon geeft aan welk type weergave- en framevenster wordt gebruikt om elk type document weer te geven.

Documenten maken deel uit van de standaardopdrachtroutering van het framework en ontvangen daarom opdrachten van standaardonderdelen van de gebruikersinterface (zoals het menu-item Bestand opslaan). Een document ontvangt opdrachten die worden doorgestuurd door de actieve weergave. Als het document een bepaalde opdracht niet verwerkt, wordt de opdracht doorgestuurd naar de documentsjabloon waarmee het wordt beheerd.

Wanneer de gegevens van een document worden gewijzigd, moeten deze wijzigingen in elk van de weergaven worden weergegeven. CDocument biedt de UpdateAllViews lidfunctie zodat u de weergaven van dergelijke wijzigingen kunt melden, zodat de weergaven zo nodig opnieuw kunnen worden weergegeven. Het framework vraagt de gebruiker ook om een gewijzigd bestand op te slaan voordat het wordt gesloten.

Als u documenten in een typische toepassing wilt implementeren, moet u het volgende doen:

  • Een klasse afleiden van CDocument elk type document.

  • Voeg lidvariabelen toe om de gegevens van elk document op te slaan.

  • Implementeer lidfuncties voor het lezen en wijzigen van de gegevens van het document. De weergaven van het document zijn de belangrijkste gebruikers van deze lidfuncties.

  • Overschrijf de CObject::Serialize lidfunctie in uw documentklasse om de gegevens van het document naar en van schijf te schrijven en te lezen.

CDocument ondersteunt het verzenden van uw document via e-mail als er e-mailondersteuning (MAPI) aanwezig is. Zie de artikelen MAPI en MAPI Support in MFC.

Zie Voor meer informatie over CDocumentserialisatie, onderwerpen over document-/weergavearchitectuur en het maken van documenten/weergaven.

Overnamehiërarchie

CObject

CCmdTarget

CDocument

Requirements

Rubriek:afxwin.h

CDocument::AddView

Roep deze functie aan om een weergave aan het document toe te voegen.

void AddView(CView* pView);

Parameterwaarden

pView
Verwijst naar de weergave die wordt toegevoegd.

Opmerkingen

Met deze functie wordt de opgegeven weergave toegevoegd aan de lijst met weergaven die aan het document zijn gekoppeld; met de functie wordt ook de documentaanwijzer van de weergave ingesteld op dit document. Het framework roept deze functie aan bij het koppelen van een nieuw gemaakt weergaveobject aan een document; dit treedt op als reactie op een opdracht Bestand nieuw, Bestand openen of Nieuw venster of wanneer een splitsvenster wordt gesplitst.

Roep deze functie alleen aan als u handmatig een weergave maakt en koppelt. Normaal gesproken laat u het framework documenten en weergaven verbinden door een object te definiëren om een CDocTemplate documentklasse, weergaveklasse en framevensterklasse te koppelen.

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

Initialiseert segmentleesbewerkingen.

virtual void BeginReadChunks ();

Opmerkingen

CDocument::CanCloseFrame

Aangeroepen door het framework voordat een framevenster met het document wordt gesloten.

virtual BOOL CanCloseFrame(CFrameWnd* pFrame);

Parameterwaarden

pFrame
Verwijst naar het framevenster van een weergave die aan het document is gekoppeld.

Retourwaarde

Nonzero als het veilig is om het framevenster te sluiten; anders 0.

Opmerkingen

De standaard implementatie controleert of er andere framevensters zijn die het document weergeven. Als het opgegeven framevenster het laatste venster is dat het document weergeeft, wordt de gebruiker gevraagd het document op te slaan als het is gewijzigd. Overschrijf deze functie als u speciale verwerking wilt uitvoeren wanneer een framevenster wordt gesloten. Dit is een geavanceerd overschrijfbaar.

CDocument::CDocument

Maakt een CDocument object.

CDocument();

Opmerkingen

Het framework verwerkt het maken van documenten voor u. Overschrijf de OnNewDocument lidfunctie om initialisatie per document uit te voeren. Dit is met name belangrijk in SDI-toepassingen (Single Document Interface).

CDocument::ClearChunkList

Hiermee wist u de segmentlijst.

virtual void ClearChunkList ();

Opmerkingen

CDocument::ClearPathName

Hiermee wist u het pad van het documentobject.

virtual void ClearPathName();

Opmerkingen

Als u het pad van een CDocument object wist, wordt de gebruiker door de toepassing gevraagd wanneer het document vervolgens wordt opgeslagen. Hierdoor gedraagt een opdracht Opslaan zich als een opdracht Opslaan als .

CDocument::DeleteContents

Aangeroepen door het framework om de gegevens van het document te verwijderen zonder het CDocument object zelf te vernietigen.

virtual void DeleteContents();

Opmerkingen

Het wordt net voordat het document moet worden vernietigd. Het wordt ook aangeroepen om ervoor te zorgen dat een document leeg is voordat het opnieuw wordt gebruikt. Dit is met name belangrijk voor een SDI-toepassing, die slechts één document gebruikt; het document wordt opnieuw gebruikt wanneer de gebruiker een ander document maakt of opent. Roep deze functie aan om een opdracht 'Alles bewerken' of een vergelijkbare opdracht te implementeren waarmee alle gegevens van het document worden verwijderd. De standaard implementatie van deze functie doet niets. Overschrijf deze functie om de gegevens in uw document te verwijderen.

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

Hiermee wordt gezocht naar een segment met een opgegeven GUID.

virtual POSITION FindChunk(
    REFCLSID guid,
    DWORD pid);

Parameterwaarden

guid
Hiermee geeft u de GUID van een segment te zoeken.

pid
Hiermee geeft u een PID van een segment te zoeken.

Retourwaarde

Plaats de positie in de interne segmentlijst als dit lukt. Anders NULL.

Opmerkingen

CDocument::GetAdapter

Retourneert een aanwijzer naar een object dat de IDocument interface implementeert.

virtual ATL::IDocument* GetAdapter();

Retourwaarde

Een aanwijzer naar een object dat de IDocument interface implementeert.

Opmerkingen

CDocument::GetDocTemplate

Roep deze functie aan om een aanwijzer op te halen naar de documentsjabloon voor dit documenttype.

CDocTemplate* GetDocTemplate() const;

Retourwaarde

Een aanwijzer naar de documentsjabloon voor dit documenttype of NULL als het document niet wordt beheerd door een documentsjabloon.

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

Roep deze lidfunctie aan om een aanwijzer naar een CFile object te krijgen.

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

Parameterwaarden

lpszFileName
Een tekenreeks die het pad naar het gewenste bestand is. Het pad kan relatief of absoluut zijn.

pError
Een aanwijzer naar een bestaand bestands-uitzonderingsobject dat de voltooiingsstatus van de bewerking aangeeft.

nOpenFlags
De modus Delen en openen. Hiermee geeft u de actie die moet worden uitgevoerd bij het openen van het bestand. U kunt opties combineren die worden vermeld in de CFile-constructor CFile::CFile met behulp van de operator bitwise OR (|). Eén toegangsmachtiging en één shareoptie zijn vereist; de modeCreate en modeNoInherit modi zijn optioneel.

Retourwaarde

Een aanwijzer naar een CFile object.

CDocument::GetFirstViewPosition

Roep deze functie aan om de positie van de eerste weergave op te halen in de lijst met weergaven die aan het document zijn gekoppeld.

virtual POSITION GetFirstViewPosition() const;

Retourwaarde

Een POSITION waarde die kan worden gebruikt voor iteratie met de GetNextView lidfunctie.

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

Roep deze functie aan om alle weergaven van het document te doorlopen.

virtual CView* GetNextView(POSITION& rPosition) const;

Parameterwaarden

rPosition
Een verwijzing naar een POSITION waarde die wordt geretourneerd door een eerdere aanroep naar de GetNextView functies of GetFirstViewPosition leden. Deze waarde mag niet zijn NULL.

Retourwaarde

Een aanwijzer naar de weergave die is geïdentificeerd door rPosition.

Opmerkingen

De functie retourneert de weergave die is geïdentificeerd door rPosition en wordt vervolgens ingesteld rPosition op de POSITION waarde van de volgende weergave in de lijst. Als de opgehaalde weergave de laatste in de lijst is, rPosition wordt deze ingesteld op 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

Roep deze functie aan om het volledig gekwalificeerde pad van het schijfbestand van het document op te halen.

const CString& GetPathName() const;

Retourwaarde

Het volledig gekwalificeerde pad van het document. Deze tekenreeks is leeg als het document niet is opgeslagen of er geen schijfbestand aan is gekoppeld.

CDocument::GetThumbnail

Hiermee maakt u een bitmap die door de miniatuurprovider moet worden gebruikt om de miniatuur weer te geven.

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

Parameterwaarden

cx
Hiermee geeft u de breedte en hoogte van de bitmap.

phbmp
Bevat een greep naar een bitmap wanneer de functie wordt geretourneerd.

pdwAlpha
Bevat een DWORD opgeven van de alfakanaalwaarde wanneer de functie met succes wordt geretourneerd.

Retourwaarde

Retourneert TRUE als er een bitmap voor de miniatuur is gemaakt; anders FALSE.

Opmerkingen

CDocument::GetTitle

Roep deze functie aan om de titel van het document op te halen, die meestal wordt afgeleid van de bestandsnaam van het document.

const CString& GetTitle() const;

Retourwaarde

De titel van het document.

CDocument::InitializeSearchContent

Aangeroepen om zoekinhoud voor de zoekhandler te initialiseren.

virtual void InitializeSearchContent ();

Opmerkingen

Overschrijf deze methode in een afgeleide klasse om zoekinhoud te initialiseren. De inhoud moet een tekenreeks zijn met delen die zijn gescheiden door ';'. Bijvoorbeeld ' punt; Rechthoek; ole-item".

CDocument::IsModified

Roep deze functie aan om te bepalen of het document is gewijzigd sinds het voor het laatst is opgeslagen.

virtual BOOL IsModified();

Retourwaarde

Niet-nul als het document is gewijzigd sinds het voor het laatst is opgeslagen; anders 0.

CDocument::IsSearchAndOrganizeHandler

Hiermee wordt aangegeven of dit exemplaar is CDocument gemaakt voor de handler Search & Organize.

BOOL IsSearchAndOrganizeHandler() const;

Retourwaarde

Retourneert TRUE als dit exemplaar is CDocument gemaakt voor de handler Search & Organize.

Opmerkingen

Deze functie retourneert TRUE momenteel alleen voor Rich Preview-handlers die zijn geïmplementeerd op een niet-processerver. U kunt de juiste vlaggen (m_bPreviewHandlerMode, m_bSearchMode, m_bGetThumbnailMode) instellen op toepassingsniveau om deze functie te retourneren TRUE.

CDocument::LoadDocumentFromStream

Wordt aangeroepen om documentgegevens uit een stream te laden.

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

Parameterwaarden

pStream
Een aanwijzer naar een stroom. Deze stream wordt geleverd door de Shell.

dwGrfMode
Toegangsmodus voor de stream.

Retourwaarde

S_OK als de laadbewerking slaagt, anders HRESULT met een foutcode.

Opmerkingen

U kunt deze methode in een afgeleide klasse overschrijven om aan te passen hoe u gegevens uit de stream laadt.

CDocument::m_bGetThumbnailMode

Hiermee geeft u op dat het CDocument object is gemaakt door dllhost voor miniaturen. Moet worden ingecheckt CView::OnDraw.

BOOL m_bGetThumbnailMode;

Opmerkingen

TRUE geeft aan dat het document is gemaakt door dllhost voor miniaturen.

CDocument::m_bPreviewHandlerMode

Hiermee geeft u op dat het CDocument object is gemaakt door prevhost voor Rich Preview. Moet worden ingecheckt CView::OnDraw.

BOOL m_bPreviewHandlerMode;

Opmerkingen

TRUE geeft aan dat het document is gemaakt door prevhost voor Rich Preview.

CDocument::m_bSearchMode

Hiermee geeft u op dat het CDocument object is gemaakt door de indexeerfunctie of door een andere zoektoepassing.

BOOL m_bSearchMode;

Opmerkingen

TRUE geeft aan dat het document is gemaakt door de indexeerfunctie of door een andere zoektoepassing.

CDocument::m_clrRichPreviewBackColor

Hiermee geeft u de achtergrondkleur van het venster Rich Preview op. Deze kleur wordt ingesteld door de host.

COLORREF m_clrRichPreviewBackColor;

Opmerkingen

CDocument::m_clrRichPreviewTextColor

Hiermee geeft u de voorgrondkleur van het venster Rich Preview op. Deze kleur wordt ingesteld door de host.

COLORREF m_clrRichPreviewTextColor;

Opmerkingen

CDocument::m_lfRichPreviewFont

Hiermee geeft u het tekstlettertype voor het venster Rich Preview op. Deze lettertypegegevens worden ingesteld door de host.

CFont m_lfRichPreviewFont;

Opmerkingen

CDocument::OnBeforeRichPreviewFontChanged

Aangeroepen voordat het lettertype Rich Preview wordt gewijzigd.

virtual void OnBeforeRichPreviewFontChanged();

Opmerkingen

CDocument::OnChangedViewList

Aangeroepen door het framework nadat een weergave is toegevoegd aan of verwijderd uit het document.

virtual void OnChangedViewList();

Opmerkingen

Met de standaard implementatie van deze functie wordt gecontroleerd of de laatste weergave wordt verwijderd en, als dat het zo is, wordt het document verwijderd. Overschrijf deze functie als u speciale verwerking wilt uitvoeren wanneer het framework een weergave toevoegt of verwijdert. Als u bijvoorbeeld wilt dat een document geopend blijft, zelfs wanneer er geen weergaven aan het document zijn gekoppeld, overschrijft u deze functie.

CDocument::OnCloseDocument

Aangeroepen door het framework wanneer het document wordt gesloten, meestal als onderdeel van de opdracht Bestand sluiten.

virtual void OnCloseDocument();

Opmerkingen

De standaard implementatie van deze functie vernietigt alle frames die worden gebruikt voor het weergeven van het document, sluit de weergave, schoont de inhoud van het document op en roept vervolgens de lidfunctie aan om de DeleteContents gegevens van het document te verwijderen.

Overschrijf deze functie als u speciale opschoningsverwerking wilt uitvoeren wanneer het framework een document sluit. Als het document bijvoorbeeld een record in een database vertegenwoordigt, kunt u deze functie overschrijven om de database te sluiten. U moet de basisklasseversie van deze functie aanroepen vanaf uw onderdrukking.

CDocument::OnCreatePreviewFrame

Aangeroepen door het framework wanneer er een voorbeeldframe moet worden gemaakt voor Uitgebreide preview.

virtual BOOL OnCreatePreviewFrame();

Retourwaarde

Retourneert TRUE als het frame is gemaakt; anders FALSE.

Opmerkingen

CDocument::OnDocumentEvent

Aangeroepen door het framework als reactie op een document gebeurtenis.

virtual void OnDocumentEvent(DocumentEvent deEvent);

Parameterwaarden

deEvent
[in] Een geïnventariseerd gegevenstype dat het type gebeurtenis beschrijft.

Opmerkingen

Document gebeurtenissen kunnen van invloed zijn op meerdere klassen. Deze methode is verantwoordelijk voor het verwerken van document gebeurtenissen die van invloed zijn op andere klassen dan de CDocument klasse. Momenteel is CDataRecoveryHandler de klasse de enige klasse die moet reageren op documentevenementen. De CDocument klasse heeft andere onderdrukkingsmethoden die verantwoordelijk zijn voor het verwerken van het effect op de CDocumentklasse.

De volgende tabel bevat de mogelijke waarden voor deEvent en de gebeurtenissen waarmee ze overeenkomen.

Waarde Bijbehorende gebeurtenis
onAfterNewDocument Er is een nieuw document gemaakt.
onAfterOpenDocument Er is een nieuw document geopend.
onAfterSaveDocument Het document is opgeslagen.
onAfterCloseDocument Het document is gesloten.

CDocument::OnDrawThumbnail

Overschrijf deze methode in een afgeleide klasse om de miniatuur te tekenen.

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

Parameterwaarden

dc
Een verwijzing naar een apparaatcontext.

lprcBounds
Hiermee geeft u een begrenzingsrechthoek op van het gebied waar de miniatuur moet worden getekend.

Opmerkingen

CDocument::OnFileSendMail

Hiermee wordt een bericht verzonden via de lokale e-mailhost (indien aanwezig) met het document als bijlage.

void OnFileSendMail();

Opmerkingen

OnFileSendMail aanroepen OnSaveDocument om naamloze en gewijzigde documenten te serialiseren (opslaan) naar een tijdelijk bestand, dat vervolgens via elektronische e-mail wordt verzonden. Als het document niet is gewijzigd, is er geen tijdelijk bestand nodig; het origineel wordt verzonden. OnFileSendMail laadt MAPI32.DLL als deze nog niet is geladen.

Een speciale implementatie van OnFileSendMail voor COleDocument handles samengestelde bestanden correct.

CDocument ondersteunt het verzenden van uw document via e-mail als er e-mailondersteuning (MAPI) aanwezig is. Zie de artikelen MAPI Topics and MAPI Support in MFC.

CDocument::OnLoadDocumentFromStream

Wordt aangeroepen door het framework wanneer de documentgegevens uit een stroom moeten worden geladen.

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

Parameterwaarden

pStream
Een aanwijzer naar een binnenkomende stroom.

grfMode
Toegangsmodus voor de stream.

Retourwaarde

S_OK als de belasting is geslaagd; anders een foutcode.

Opmerkingen

CDocument::OnNewDocument

Aangeroepen door het framework als onderdeel van de opdracht Bestand nieuw.

virtual BOOL OnNewDocument();

Retourwaarde

Niet-nul als het document is geïnitialiseerd; anders 0.

Opmerkingen

De standaard implementatie van deze functie roept de DeleteContents lidfunctie aan om ervoor te zorgen dat het document leeg is en het nieuwe document vervolgens als schoon markeert. Overschrijf deze functie om de gegevensstructuur voor een nieuw document te initialiseren. U moet de basisklasseversie van deze functie aanroepen vanaf uw onderdrukking.

Als de gebruiker de opdracht Bestand nieuw kiest in een SDI-toepassing, gebruikt het framework deze functie om het bestaande document opnieuw te initialiseren in plaats van een nieuw document te maken. Als de gebruiker File New in een MDI-toepassing (File New) kiest, maakt het framework elke keer een nieuw document en roept deze functie vervolgens aan om deze te initialiseren. U moet de initialisatiecode in deze functie plaatsen in plaats van in de constructor voor de opdracht Bestand nieuw om effectief te zijn in SDI-toepassingen.

Houd er rekening mee dat er gevallen zijn waarbij OnNewDocument twee keer wordt aangeroepen. Dit gebeurt wanneer het document is ingesloten als een ActiveX-documentserver. De functie wordt eerst aangeroepen door de CreateInstance methode (beschikbaar gemaakt door de COleObjectFactory-afgeleide klasse) en een tweede keer door de InitNew methode (beschikbaar gemaakt door de COleServerDoc-afgeleide klasse).

Example

In de volgende voorbeelden ziet u alternatieve methoden voor het initialiseren van een documentobject.

// 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

Aangeroepen door het framework als onderdeel van de opdracht Bestand openen.

virtual BOOL OnOpenDocument(LPCTSTR lpszPathName);

Parameterwaarden

lpszPathName
Verwijst naar het pad van het document dat moet worden geopend.

Retourwaarde

Niet-nul als het document is geladen; anders 0.

Opmerkingen

De standaard implementatie van deze functie opent het opgegeven bestand, roept de DeleteContents lidfunctie aan om ervoor te zorgen dat het document leeg is, roept CObject::Serialize aan om de inhoud van het bestand te lezen en markeert het document vervolgens als schoon. Overschrijf deze functie als u iets anders wilt gebruiken dan het archiefmechanisme of het bestandsmechanisme. U kunt bijvoorbeeld een toepassing schrijven waarin documenten records in een database vertegenwoordigen in plaats van afzonderlijke bestanden.

Als de gebruiker de opdracht Bestand openen kiest in een SDI-toepassing, gebruikt het framework deze functie om het bestaande CDocument object opnieuw te initialiseren in plaats van een nieuw object te maken. Als de gebruiker Bestand openen kiest in een MDI-toepassing, wordt er elke keer een nieuw CDocument object gemaakt en wordt deze functie vervolgens aangeroepen om deze te initialiseren. U moet uw initialisatiecode in deze functie plaatsen in plaats van in de constructor voor de opdracht Bestand openen om effectief te zijn in SDI-toepassingen.

Example

In de volgende voorbeelden ziet u alternatieve methoden voor het initialiseren van een documentobject.

// 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

Hiermee wordt de preview-handler om het HWND opgehaalde resultaat te geven van het aanroepen van de GetFocus functie.

virtual HRESULT OnPreviewHandlerQueryFocus(HWND* phwnd);

Parameterwaarden

phwnd
[uit] Wanneer deze methode wordt geretourneerd, bevat deze een aanwijzer naar de HWND die wordt geretourneerd door het aanroepen van de GetFocus functie vanuit de voorgrondthread van de preview-handler.

Retourwaarde

Retourneert S_OK indien geslaagd; of een foutwaarde anders.

Opmerkingen

CDocument::OnPreviewHandlerTranslateAccelerator

Stuurt de preview-handler om een toetsaanslag af te handelen die is doorgegeven vanaf de berichtpomp van het proces waarin de preview-handler wordt uitgevoerd.

virtual HRESULT OnPreviewHandlerTranslateAccelerator(MSG* pmsg);

Parameterwaarden

pmsg
[in] Een aanwijzer naar een vensterbericht.

Retourwaarde

Als het toetsaanslagbericht kan worden verwerkt door de preview-handler, verwerkt de handler het en retourneert S_OKhet. Als de preview-handler het toetsaanslagbericht niet kan verwerken, wordt het aan de host aangeboden via IPreviewHandlerFrame::TranslateAccelerator. Als de host het bericht verwerkt, retourneert S_OKdeze methode . Als het bericht niet door de host wordt verwerkt, retourneert S_FALSEdeze methode .

Opmerkingen

CDocument::OnRichPreviewBackColorChanged

Wordt aangeroepen wanneer de achtergrondkleur rich preview is gewijzigd.

virtual void OnRichPreviewBackColorChanged();

Opmerkingen

CDocument::OnRichPreviewFontChanged

Aangeroepen wanneer het lettertype Rich Preview is gewijzigd.

virtual void OnRichPreviewFontChanged();

Opmerkingen

CDocument::OnRichPreviewSiteChanged

Aangeroepen wanneer de uitgebreide preview-site is gewijzigd.

virtual void OnRichPreviewSiteChanged();

Opmerkingen

CDocument::OnRichPreviewTextColorChanged

Aangeroepen wanneer de tekstkleur van het rtf-voorbeeld is gewijzigd.

virtual void OnRichPreviewTextColorChanged();

Opmerkingen

CDocument::OnSaveDocument

Aangeroepen door het framework als onderdeel van de opdracht Bestand opslaan of Opslaan als.

virtual BOOL OnSaveDocument(LPCTSTR lpszPathName);

Parameterwaarden

lpszPathName
Verwijst naar het volledig gekwalificeerde pad waarnaar het bestand moet worden opgeslagen.

Retourwaarde

Niet-nul als het document is opgeslagen; anders 0.

Opmerkingen

De standaard implementatie van deze functie opent het opgegeven bestand, roept CObject::Serialize aan om de gegevens van het document naar het bestand te schrijven en markeert het document als schoon. Overschrijf deze functie als u speciale verwerking wilt uitvoeren wanneer het framework een document opslaat. U kunt bijvoorbeeld een toepassing schrijven waarin documenten records in een database vertegenwoordigen in plaats van afzonderlijke bestanden.

CDocument::OnUnloadHandler

Aangeroepen door het framework wanneer de preview-handler wordt uitgeladen.

virtual void OnUnloadHandler();

Opmerkingen

CDocument::OnUpdateFileSendMail

Hiermee schakelt u de ID_FILE_SEND_MAIL opdracht in als er e-mailondersteuning (MAPI) aanwezig is.

void OnUpdateFileSendMail(CCmdUI* pCmdUI);

Parameterwaarden

pCmdUI
Een aanwijzer naar het CCmdUI object dat is gekoppeld aan de ID_FILE_SEND_MAIL opdracht.

Opmerkingen

Anders verwijdert de functie de ID_FILE_SEND_MAIL opdracht uit het menu, inclusief scheidingstekens boven of onder het menu-item, indien van toepassing. MAPI is ingeschakeld als MAPI32.DLL deze aanwezig is in het pad en, in de sectie [Mail] van het WIN.INI bestand, MAPI=1. De meeste toepassingen plaatsen deze opdracht in het menu Bestand.

CDocument ondersteunt het verzenden van uw document via e-mail als er e-mailondersteuning (MAPI) aanwezig is. Zie de artikelen MAPI Topics and MAPI Support in MFC.

CDocument::PreCloseFrame

Deze lidfunctie wordt aangeroepen door het framework voordat het framevenster wordt vernietigd.

virtual void PreCloseFrame(CFrameWnd* pFrame);

Parameterwaarden

pFrame
Aanwijzer naar het CFrameWnd object dat het bijbehorende CDocument object bevat.

Opmerkingen

Het kan worden overschreven om aangepaste opschoning te bieden, maar zorg er ook voor dat u de basisklasse aanroept.

De standaardwaarde van PreCloseFrame doet niets in CDocument. De CDocument-afgeleide klassen COleDocument en CRichEditDoc gebruiken deze lidfunctie.

CDocument::ReadNextChunkValue

Hiermee wordt de volgende segmentwaarde gelezen.

virtual BOOL ReadNextChunkValue(IFilterChunkValue** ppValue);

Parameterwaarden

ppValue
[uit] Wanneer de functie wordt geretourneerd, ppValue bevat deze de waarde die is gelezen.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

CDocument::ReleaseFile

Deze lidfunctie wordt aangeroepen door het framework om een bestand vrij te geven, waardoor het beschikbaar wordt gemaakt voor gebruik door andere toepassingen.

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

Parameterwaarden

pFile
Een aanwijzer naar het CFile object dat moet worden vrijgegeven.

bAbort
Hiermee geeft u op of het bestand moet worden vrijgegeven met behulp van CFile::Close of CFile::Abort. FALSE als het bestand moet worden vrijgegeven met behulp van CFile::Close; TRUE als het bestand moet worden vrijgegeven met behulp van CFile::Abort.

Opmerkingen

Als bAbort dat het is TRUE, ReleaseFile roept u aan CFile::Aborten wordt het bestand vrijgegeven. CFile::Abort genereert geen uitzondering.

Als bAbort dat het is FALSE, ReleaseFile roept u aan CFile::Close en wordt het bestand vrijgegeven.

Overschrijf deze lidfunctie om een actie van de gebruiker te vereisen voordat het bestand wordt vrijgegeven.

CDocument::RemoveChunk

Hiermee verwijdert u een segment met de opgegeven GUID.

virtual void RemoveChunk(
    REFCLSID guid,
    DWORD pid);

Parameterwaarden

Guid
Hiermee geeft u het GUID segment dat moet worden verwijderd.

Pid
Hiermee geeft u het PID segment dat moet worden verwijderd.

Opmerkingen

CDocument::RemoveView

Roep deze functie aan om een weergave los te koppelen van een document.

void RemoveView(CView* pView);

Parameterwaarden

pView
Verwijst naar de weergave die wordt verwijderd.

Opmerkingen

Met deze functie wordt de opgegeven weergave verwijderd uit de lijst met weergaven die aan het document zijn gekoppeld; ook wordt de documentaanwijzer van de weergave ingesteld op NULL. Deze functie wordt aangeroepen door het framework wanneer een framevenster wordt gesloten of een deelvenster van een splitsvenster wordt gesloten.

Roep deze functie alleen aan als u handmatig een weergave loskoppelt. Normaal gesproken kunt u documenten en weergaven loskoppelen door een object te definiëren om een CDocTemplate documentklasse, weergaveklasse en framevensterklasse te koppelen.

Zie het voorbeeld voor AddView een voorbeeld van een implementatie.

CDocument::ReportSaveLoadException

Wordt aangeroepen als er een uitzondering wordt gegenereerd (meestal een CFileException of CArchiveException) tijdens het opslaan of laden van het document.

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

Parameterwaarden

lpszPathName
Verwijst naar de naam van het document dat is opgeslagen of geladen.

e
Verwijst naar de uitzondering die is gegenereerd. Misschien wel NULL.

bSaving
Vlag die aangeeft welke bewerking wordt uitgevoerd; niet-nul als het document werd opgeslagen, 0 als het document werd geladen.

nIDPDefault
De id van het foutbericht dat moet worden weergegeven als de functie geen specifieker bericht opgeeft.

Opmerkingen

De standaard implementatie onderzoekt het uitzonderingsobject en zoekt naar een foutbericht dat specifiek de oorzaak beschrijft. Als een specifiek bericht niet wordt gevonden of als e dat het is NULL, wordt het algemene bericht gebruikt dat is opgegeven door de nIDPDefault parameter. De functie geeft vervolgens een berichtvak weer met het foutbericht. Overschrijf deze functie als u aanvullende, aangepaste foutberichten wilt opgeven. Dit is een geavanceerd overschrijfbaar.

CDocument::SaveModified

Aangeroepen door het framework voordat een gewijzigd document moet worden gesloten.

virtual BOOL SaveModified();

Retourwaarde

Niet-nul als het veilig is om door te gaan en het document te sluiten; 0 als het document niet mag worden gesloten.

Opmerkingen

Bij de standaard implementatie van deze functie wordt een berichtvak weergegeven waarin de gebruiker wordt gevraagd of de wijzigingen in het document moeten worden opgeslagen, indien aanwezig. Overschrijf deze functie als uw programma een andere promptprocedure vereist. Dit is een geavanceerd overschrijfbaar.

CDocument::SetChunkValue

Hiermee stelt u een segmentwaarde in.

virtual BOOL SetChunkValue (IFilterChunkValue* pValue);

Parameterwaarden

pValue
Hiermee geeft u een segmentwaarde op die moet worden ingesteld.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

CDocument::SetModifiedFlag

Roep deze functie aan nadat u wijzigingen hebt aangebracht in het document.

virtual void SetModifiedFlag(BOOL bModified = TRUE);

Parameterwaarden

bModified
Vlag die aangeeft of het document is gewijzigd.

Opmerkingen

Door deze functie consistent aan te roepen, zorgt u ervoor dat de gebruiker wordt gevraagd om wijzigingen op te slaan voordat u een document sluit. Normaal gesproken moet u de standaardwaarde voor TRUE de bModified parameter gebruiken. Als u een document wilt markeren als schoon (ongewijzigd), roept u deze functie aan met een waarde van FALSE.

CDocument::SetPathName

Roep deze functie aan om het volledig gekwalificeerde pad van het schijfbestand van het document op te geven.

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

Parameterwaarden

lpszPathName
Verwijst naar de tekenreeks die moet worden gebruikt als het pad voor het document.

bAddToMRU
Bepaalt of de bestandsnaam wordt toegevoegd aan de meest recent gebruikte (MRU)-bestandslijst. Als TRUE, de bestandsnaam wordt toegevoegd; als FALSE, wordt het niet toegevoegd.

Opmerkingen

Afhankelijk van de waarde van bAddToMRU het pad wordt toegevoegd of niet toegevoegd aan de MRU-lijst die door de toepassing wordt onderhouden. Sommige documenten zijn niet gekoppeld aan een schijfbestand. Roep deze functie alleen aan als u de standaard implementatie overschrijft voor het openen en opslaan van bestanden die door het framework worden gebruikt.

CDocument::SetTitle

Roep deze functie aan om de titel van het document op te geven (de tekenreeks die wordt weergegeven in de titelbalk van een framevenster).

virtual void SetTitle(LPCTSTR lpszTitle);

Parameterwaarden

lpszTitle
Verwijst naar de tekenreeks die moet worden gebruikt als titel van het document.

Opmerkingen

Als u deze functie aanroept, worden de titels bijgewerkt van alle framevensters waarin het document wordt weergegeven.

CDocument::UpdateAllViews

Roep deze functie aan nadat het document is gewijzigd.

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

Parameterwaarden

pSender
Verwijst naar de weergave die het document heeft gewijzigd of NULL als alle weergaven moeten worden bijgewerkt.

lHint
Bevat informatie over de wijziging.

pHint
Verwijst naar een object dat informatie over de wijziging opslaat.

Opmerkingen

U moet deze functie aanroepen nadat u de SetModifiedFlag lidfunctie hebt aangeroepen. Deze functie informeert elke weergave die aan het document is gekoppeld, met uitzondering van de weergave die is opgegeven door pSender, dat het document is gewijzigd. Meestal roept u deze functie aan vanuit uw weergaveklasse nadat de gebruiker het document heeft gewijzigd via een weergave.

Met deze functie wordt de CView::OnUpdate lidfunctie aangeroepen voor elk van de weergaven van het document, met uitzondering van de verzendende weergave, doorgeven pHint en lHint. Gebruik deze parameters om informatie door te geven aan de weergaven over de wijzigingen die in het document zijn aangebracht. U kunt gegevens coderen met behulp van lHint en/of u kunt een CObject-afgeleide klasse definiëren om informatie over de wijzigingen op te slaan en een object van die klasse door te geven met behulp pHintvan . Overschrijf de CView::OnUpdate lidfunctie in uw CView-afgeleide klasse om het bijwerken van de weergave te optimaliseren op basis van de doorgegeven informatie.

Example

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

Zie ook

MFC-voorbeeld MDIDOCVW
MFC-voorbeeld SNAPVW
MFC-voorbeeld NPP
CCmdTarget klasse
Hiërarchiegrafiek
CCmdTarget klasse
CView klasse
CDocTemplate klasse

  • Last updated on