Share via

CDocTemplate-klasse

Opmerking

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

Een abstracte basisklasse die de basisfunctionaliteit voor documentsjablonen definieert.

Syntaxis

class CDocTemplate : public CCmdTarget

Leden

Beveiligde constructors

Naam Description
CDocTemplate::CDocTemplate Maakt een CDocTemplate object.

Openbare methoden

Naam Description
CDocTemplate::AddDocument Hiermee voegt u een document toe aan een sjabloon.
CDocTemplate::CloseAllDocuments Hiermee sluit u alle documenten die aan deze sjabloon zijn gekoppeld.
CDocTemplate::CreateNewDocument Hiermee maakt u een nieuw document.
CDocTemplate::CreateNewFrame Hiermee maakt u een nieuw framevenster met een document en weergave.
CDocTemplate::CreateOleFrame Hiermee maakt u een framevenster met OLE-functionaliteit.
CDocTemplate::CreatePreviewFrame Hiermee maakt u een onderliggend frame dat wordt gebruikt voor Uitgebreide preview.
CDocTemplate::GetDocString Hiermee wordt een tekenreeks opgehaald die is gekoppeld aan het documenttype.
CDocTemplate::GetFirstDocPosition Hiermee wordt de positie opgehaald van het eerste document dat aan deze sjabloon is gekoppeld.
CDocTemplate::GetNextDoc Hiermee haalt u een document en de positie van de volgende op.
CDocTemplate::InitialUpdateFrame Initialiseert het framevenster en maakt het optioneel zichtbaar.
CDocTemplate::LoadTemplate Laadt de resources voor een bepaalde CDocTemplate of afgeleide klasse.
CDocTemplate::MatchDocType Bepaalt de mate van betrouwbaarheid in de overeenkomst tussen een documenttype en deze sjabloon.
CDocTemplate::OpenDocumentFile Hiermee opent u een bestand dat is opgegeven door een padnaam.
CDocTemplate::RemoveDocument Hiermee verwijdert u een document uit een sjabloon.
CDocTemplate::SaveAllModified Hiermee worden alle documenten opgeslagen die zijn gekoppeld aan deze sjabloon, die zijn gewijzigd.
CDocTemplate::SetContainerInfo Bepaalt de resources voor OLE-containers bij het bewerken van een in-place OLE-item.
CDocTemplate::SetDefaultTitle Geeft de standaardtitel weer in de titelbalk van het documentvenster.
CDocTemplate::SetPreviewInfo Setups out of process preview handler.
CDocTemplate::SetServerInfo Bepaalt de resources en klassen wanneer het serverdocument ter plaatse is ingesloten of bewerkt.

Opmerkingen

Meestal maakt u een of meer documentsjablonen in de implementatie van de functie van uw toepassing InitInstance . Een documentsjabloon definieert de relaties tussen drie typen klassen:

  • Een documentklasse die u hebt afgeleid van CDocument.

  • Een weergaveklasse, waarin gegevens uit de hierboven vermelde documentklasse worden weergegeven. U kunt deze klasse afleiden van CView, CScrollViewof CFormViewCEditView. (U kunt ook rechtstreeks gebruiken CEditView .)

  • Een framevensterklasse, die de weergave bevat. Voor een SDI-toepassing (Single Document Interface) hebt u deze klasse afgeleid van CFrameWnd. Voor een MDI-toepassing (Multiple Document Interface) hebt u deze klasse afgeleid van CMDIChildWnd. Als u het gedrag van het framevenster niet hoeft aan te passen, kunt u deze gebruiken CFrameWnd of CMDIChildWnd rechtstreeks zonder uw eigen klas af te leiden.

Uw toepassing heeft één documentsjabloon voor elk type document dat wordt ondersteund. Als uw toepassing bijvoorbeeld zowel spreadsheets als tekstdocumenten ondersteunt, heeft de toepassing twee documentsjabloonobjecten. Elke documentsjabloon is verantwoordelijk voor het maken en beheren van alle documenten van het type.

In de documentsjabloon worden aanwijzers opgeslagen voor de CRuntimeClass objecten voor de klassen document-, weergave- en framevensters. Deze CRuntimeClass objecten worden opgegeven bij het maken van een documentsjabloon.

De documentsjabloon bevat de id van de resources die worden gebruikt met het documenttype (zoals menu-, pictogram- of acceleratortabelbronnen). De documentsjabloon bevat ook tekenreeksen met aanvullende informatie over het documenttype. Deze omvatten de naam van het documenttype (bijvoorbeeld Werkblad) en de bestandsextensie (bijvoorbeeld ".xls"). Optioneel kan het andere tekenreeksen bevatten die worden gebruikt door de gebruikersinterface van de toepassing, Windows File Manager en OLE-ondersteuning (Object Linking and Embedding).

Als uw toepassing een OLE-container en/of server is, definieert de documentsjabloon ook de id van het menu dat wordt gebruikt tijdens in-place activering. Als uw toepassing een OLE-server is, definieert de documentsjabloon de id van de werkbalk en het menu dat wordt gebruikt tijdens in-place activering. U geeft deze extra OLE-resources op door aan te roepen SetContainerInfo en SetServerInfo.

Omdat CDocTemplate dit een abstracte klasse is, kunt u de klasse niet rechtstreeks gebruiken. Een typische toepassing maakt gebruik van een van de twee CDocTemplate-afgeleide klassen die worden geleverd door de Microsoft Foundation Class Library: CSingleDocTemplate, waarmee SDI en CMultiDocTemplateMDI worden geïmplementeerd. Zie deze klassen voor meer informatie over het gebruik van documentsjablonen.

Als uw toepassing een paradigma voor de gebruikersinterface vereist die fundamenteel verschilt van SDI of MDI, kunt u uw eigen klasse afleiden van CDocTemplate.

Zie Documentsjablonen en het proces voor het maken van documenten/weergaven voor meer informatieCDocTemplate.

Overnamehiërarchie

CObject

CCmdTarget

CDocTemplate

Requirements

Rubriek:afxwin.h

CDocTemplate::AddDocument

Gebruik deze functie om een document toe te voegen aan een sjabloon.

virtual void AddDocument(CDocument* pDoc);

Parameterwaarden

pDoc
Een aanwijzer naar het document dat moet worden toegevoegd.

Opmerkingen

De afgeleide klassen CMultiDocTemplate en CSingleDocTemplate overschrijven deze functie. Als u uw eigen documentsjabloonklasse hebt afgeleid van CDocTemplate, moet uw afgeleide klasse deze functie overschrijven.

CDocTemplate::CDocTemplate

Maakt een CDocTemplate object.

CDocTemplate (
    UINT nIDResource,
    CRuntimeClass* pDocClass,
    CRuntimeClass* pFrameClass,
    CRuntimeClass* pViewClass);

Parameterwaarden

nIDResource
Hiermee geeft u de id op van de resources die worden gebruikt met het documenttype. Dit kan bestaan uit menu-, pictogram-, acceleratortabel- en tekenreeksbronnen.

De tekenreeksresource bestaat uit maximaal zeven subtekenreeksen, gescheiden door het \n teken (het \n teken is nodig als tijdelijke aanduiding als een subtekenreeks niet is opgenomen; volgtekeningen \n zijn echter niet nodig); deze subtekenreeksen beschrijven het documenttype. Zie voor meer informatie over de subtekenreeksen GetDocString. Deze tekenreeksresource vindt u in het resourcebestand van de toepassing. Voorbeeld:

// MYCALC.RC
STRINGTABLE PRELOAD DISCARDABLE
BEGIN
  IDR_SHEETTYPE "\nSheet\nWorksheet\nWorksheets (*.myc)\n.myc\n MyCalcSheet\nMyCalc Worksheet"
END

De tekenreeks begint met een \n teken. Dit komt doordat de eerste subtekenreeks niet wordt gebruikt voor MDI-toepassingen en dus niet is opgenomen. U kunt deze tekenreeks bewerken met behulp van de tekenreekseditor; de hele tekenreeks wordt weergegeven als één item in de tekenreekseditor, niet als zeven afzonderlijke vermeldingen.

pDocClass
Verwijst naar het CRuntimeClass object van de documentklasse. Deze klasse is een CDocumentafgeleide klasse die u definieert om uw documenten weer te geven.

pFrameClass
Verwijst naar het CRuntimeClass object van de framevensterklasse. Deze klasse kan een CFrameWnd-afgeleide klasse zijn of kan zelf zijn CFrameWnd als u standaardgedrag wilt voor uw hoofdframevenster.

pViewClass
Verwijst naar het CRuntimeClass object van de weergaveklasse. Deze klasse is een CViewafgeleide klasse die u definieert om uw documenten weer te geven.

Opmerkingen

Gebruik deze lidfunctie om een CDocTemplate object te maken. Wijs dynamisch een CDocTemplate object toe en geef dit door vanuit CWinApp::AddDocTemplate de InitInstance lidfunctie van uw toepassingsklasse.

CDocTemplate::CloseAllDocuments

Roep deze lidfunctie aan om alle geopende documenten te sluiten.

virtual void CloseAllDocuments(BOOL bEndSession);

Parameterwaarden

bEndSession
Niet gebruikt.

Opmerkingen

Deze lidfunctie wordt doorgaans gebruikt als onderdeel van de opdracht Bestandsafsluiten. De standaard implementatie van deze functie roept de CDocument::DeleteContents lidfunctie aan om de gegevens van het document te verwijderen en sluit vervolgens de framevensters voor alle weergaven die aan het document zijn gekoppeld.

Overschrijf deze functie als u wilt vereisen dat de gebruiker speciale opschoonverwerking uitvoert voordat het document wordt gesloten. Als het document bijvoorbeeld een record in een database vertegenwoordigt, kunt u deze functie overschrijven om de database te sluiten.

CDocTemplate::CreateNewDocument

Roep deze lidfunctie aan om een nieuw document te maken van het type dat is gekoppeld aan deze documentsjabloon.

virtual CDocument* CreateNewDocument();

Retourwaarde

Een aanwijzer naar het zojuist gemaakte document of NULL als er een fout optreedt.

CDocTemplate::CreateNewFrame

Hiermee maakt u een nieuw framevenster met een document en weergave.

virtual CFrameWnd* CreateNewFrame(
    CDocument* pDoc,
    CFrameWnd* pOther);

Parameterwaarden

pDoc
Het document waarnaar het nieuwe framevenster moet verwijzen. Kan zijn NULL.

pOther
Het framevenster waarop het nieuwe framevenster moet worden gebaseerd. Kan zijn NULL.

Retourwaarde

Een aanwijzer naar het zojuist gemaakte framevenster of NULL als er een fout optreedt.

Opmerkingen

CreateNewFrame gebruikt de CRuntimeClass objecten die aan de constructor worden doorgegeven om een nieuw framevenster te maken met een weergave en document bijgevoegd. Als de pDoc parameter is NULL, voert het framework een TRACE bericht uit.

De pOther parameter wordt gebruikt om de opdracht Window New te implementeren. Het biedt een framevenster waarop het nieuwe framevenster kan worden gemodelleerd. Het nieuwe framevenster wordt meestal onzichtbaar gemaakt. Roep deze functie aan om framevensters te maken buiten de standaardframework-implementatie van Bestand nieuw en Bestand openen.

CDocTemplate::CreateOleFrame

Hiermee maakt u een OLE-framevenster.

CFrameWnd* CreateOleFrame(
    CWnd* pParentWnd,
    CDocument* pDoc,
    BOOL bCreateView);

Parameterwaarden

pParentWnd
Een aanwijzer naar het bovenliggende venster van het frame.

pDoc
Een aanwijzer naar het document waarnaar het nieuwe OLE-framevenster moet verwijzen.

bCreateView
Bepaalt of er een weergave samen met het frame wordt gemaakt.

Retourwaarde

Een aanwijzer naar een framevenster indien geslaagd; anders NULL.

Opmerkingen

Als bCreateView nul is, wordt er een leeg frame gemaakt.

CDocTemplate::GetDocString

Hiermee wordt een tekenreeks opgehaald die is gekoppeld aan het documenttype.

virtual BOOL GetDocString(
    CString& rString,
    enum DocStringIndex index) const;

Parameterwaarden

rString
Een verwijzing naar een CString object dat de tekenreeks bevat wanneer de functie wordt geretourneerd.

index
Een index van de subtekenreeks die wordt opgehaald uit de tekenreeks die het documenttype beschrijft. Deze parameter kan een van de volgende waarden hebben:

  • CDocTemplate::windowTitle Naam die wordt weergegeven in de titelbalk van het toepassingsvenster (bijvoorbeeld 'Microsoft Excel'). Alleen aanwezig in de documentsjabloon voor SDI-toepassingen.

  • CDocTemplate::docName Hoofdmap voor de standaarddocumentnaam (bijvoorbeeld 'Blad'). Deze hoofdmap, plus een getal, wordt gebruikt voor de standaardnaam van een nieuw document van dit type wanneer de gebruiker de opdracht Nieuw kiest in het menu Bestand (bijvoorbeeld 'Blad1' of 'Blad2'). Als dit niet is opgegeven, wordt 'Naamloos' gebruikt als de standaardwaarde.

  • CDocTemplate::fileNewName Naam van dit documenttype. Als de toepassing meer dan één type document ondersteunt, wordt deze tekenreeks weergegeven in het dialoogvenster Bestand nieuw (bijvoorbeeld 'Werkblad'). Als dit niet is opgegeven, is het documenttype niet toegankelijk met behulp van de opdracht Bestand nieuw .

  • CDocTemplate::filterName Beschrijving van het documenttype en een jokertekenfilter dat overeenkomt met documenten van dit type. Deze tekenreeks wordt weergegeven in de vervolgkeuzelijst Lijstbestanden van het type in het dialoogvenster Bestand openen (bijvoorbeeld Werkbladen (*.xls)). Als dit niet is opgegeven, is het documenttype niet toegankelijk met behulp van de opdracht Bestand openen .

  • CDocTemplate::filterExt Uitbreiding voor documenten van dit type (bijvoorbeeld ".xls"). Als dit niet is opgegeven, is het documenttype niet toegankelijk met behulp van de opdracht Bestand openen .

  • CDocTemplate::regFileTypeId Id voor het documenttype dat moet worden opgeslagen in de registratiedatabase die wordt onderhouden door Windows. Deze tekenreeks is alleen bedoeld voor intern gebruik (bijvoorbeeld 'ExcelWorksheet'). Als dit niet is opgegeven, kan het documenttype niet worden geregistreerd bij Windows File Manager.

  • CDocTemplate::regFileTypeName De naam van het documenttype dat moet worden opgeslagen in de registratiedatabase. Deze tekenreeks kan worden weergegeven in dialoogvensters van toepassingen die toegang hebben tot de registratiedatabase (bijvoorbeeld 'Microsoft Excel-werkblad').

Retourwaarde

Niet-nul als de opgegeven subtekenreeks is gevonden; anders 0.

Opmerkingen

Roep deze functie aan om een specifieke subtekenreeks op te halen waarin het documenttype wordt beschreven. De tekenreeks met deze subtekenreeksen wordt opgeslagen in de documentsjabloon en is afgeleid van een tekenreeks in het resourcebestand voor de toepassing. Dit framework roept deze functie aan om de tekenreeksen op te halen die nodig zijn voor de gebruikersinterface van de toepassing. Als u een bestandsnaamextensie hebt opgegeven voor de documenten van uw toepassing, roept het framework deze functie ook aan bij het toevoegen van een vermelding aan de Windows-registratiedatabase; Hierdoor kunnen documenten worden geopend vanuit Windows Bestandsbeheer.

Roep deze functie alleen aan als u uw eigen klasse vandaan CDocTemplatekrijgt.

CDocTemplate::GetFirstDocPosition

Hiermee wordt de positie opgehaald van het eerste document dat aan deze sjabloon is gekoppeld.

virtual POSITION GetFirstDocPosition() const = 0;

Retourwaarde

Een POSITION waarde die kan worden gebruikt voor het doorlopen van de lijst met documenten die aan deze documentsjabloon zijn gekoppeld, of NULL als de lijst leeg is.

Opmerkingen

Gebruik deze functie om de positie van het eerste document op te halen in de lijst met documenten die aan deze sjabloon zijn gekoppeld. Gebruik de POSITION waarde als argument om CDocTemplate::GetNextDoc de lijst met documenten te doorlopen die aan de sjabloon zijn gekoppeld.

CSingleDocTemplate en CMultiDocTemplate beide overschrijven deze pure virtuele functie. Elke klasse die u hebt CDocTemplate afgeleid, moet deze functie ook overschrijven.

CDocTemplate::GetNextDoc

Hiermee haalt u het lijstelement op dat is geïdentificeerd door rPosen wordt vervolgens ingesteld rPos op de POSITION waarde van het volgende item in de lijst.

virtual CDocument* GetNextDoc(POSITION& rPos) const = 0;

Retourwaarde

Een aanwijzer naar het volgende document in de lijst met documenten die aan deze sjabloon zijn gekoppeld.

Parameterwaarden

rPos
Een verwijzing naar een POSITION waarde die wordt geretourneerd door een eerdere aanroep naar GetFirstDocPosition of GetNextDoc.

Opmerkingen

Als het opgehaalde element de laatste in de lijst is, wordt de nieuwe waarde rPos ingesteld op NULL.

U kunt in een doorstuurlus gebruiken GetNextDoc als u de initiële positie met een aanroep naar GetFirstDocPosition.

U moet ervoor zorgen dat uw POSITION waarde een geldige positie in de lijst vertegenwoordigt. Als deze ongeldig is, wordt de foutopsporingsversie van de Microsoft Foundation Class Library asserts.

CDocTemplate::InitialUpdateFrame

Initialiseert het framevenster en maakt het optioneel zichtbaar.

virtual void InitialUpdateFrame(
    CFrameWnd* pFrame,
    CDocument* pDoc,
    BOOL bMakeVisible = TRUE);

Parameterwaarden

pFrame
Het framevenster dat de eerste update nodig heeft.

pDoc
Het document waaraan het frame is gekoppeld. Kan zijn NULL.

bMakeVisible
Hiermee wordt aangegeven of het frame zichtbaar en actief moet worden.

Opmerkingen

Aanroepen IntitialUpdateFrame na het maken van een nieuw frame met CreateNewFrame. Als u deze functie aanroept, worden de weergaven in dat framevenster hun OnInitialUpdate aanroepen ontvangen. Als er nog geen actieve weergave was, wordt de primaire weergave van het framevenster ook actief gemaakt; de primaire weergave is een weergave met een onderliggende id van AFX_IDW_PANE_FIRST. Ten slotte wordt het framevenster zichtbaar gemaakt als bMakeVisible het niet-nul is. Als bMakeVisible dit nul is, blijft de huidige focus en de zichtbare status van het framevenster ongewijzigd.

Het is niet nodig om deze functie aan te roepen bij het gebruik van de implementatie van bestand nieuw en bestand openen van het framework.

CDocTemplate::LoadTemplate

Laadt de resources voor een bepaalde CDocTemplate of afgeleide klasse.

virtual void LoadTemplate();

Opmerkingen

Deze lidfunctie wordt aangeroepen door het framework om de resources voor een bepaalde CDocTemplate of afgeleide klasse te laden. Normaal gesproken wordt deze aangeroepen tijdens de bouw, behalve wanneer de sjabloon wereldwijd wordt samengesteld. In dat geval wordt de aanroep uitgesteld LoadTemplate totdat CWinApp::AddDocTemplate deze wordt aangeroepen.

CDocTemplate::MatchDocType

Bepaalt de mate van betrouwbaarheid in de overeenkomst tussen een documenttype en deze sjabloon.

virtual Confidence MatchDocType(
    LPCTSTR lpszPathName,
    CDocument*& rpDocMatch);

Parameterwaarden

lpszPathName
Padnaam van het bestand waarvan het type moet worden bepaald.

rpDocMatch
Wijs een document aan waaraan het overeenkomende document is toegewezen, als het bestand dat is opgegeven door lpszPathName is al geopend.

Retourwaarde

Een waarde uit de Confidence opsomming, die als volgt wordt gedefinieerd:

enum Confidence
    {
    noAttempt,
    maybeAttemptForeign,
    maybeAttemptNative,
    yesAttemptForeign,
    yesAttemptNative,
    yesAlreadyOpen
    };

Opmerkingen

Gebruik deze functie om het type documentsjabloon te bepalen dat moet worden gebruikt voor het openen van een bestand. Als uw toepassing bijvoorbeeld meerdere bestandstypen ondersteunt, kunt u deze functie gebruiken om te bepalen welke van de beschikbare documentsjablonen geschikt is voor een bepaald bestand door elke sjabloon op zijn beurt aan te roepen MatchDocType en een sjabloon te kiezen op basis van de geretourneerde betrouwbaarheidswaarde.

Als het bestand dat is opgegeven lpszPathName door is al geopend, retourneert en kopieert CDocTemplate::yesAlreadyOpen deze functie het object van CDocument het bestand naar het object op rpDocMatch.

Als het bestand niet is geopend, maar de extensie overeenkomt lpszPathName met de extensie die is opgegeven door CDocTemplate::filterExt, wordt deze functie geretourneerd CDocTemplate::yesAttemptNative en ingesteld rpDocMatch op NULL. Zie voor meer informatie over CDocTemplate::filterExtCDocTemplate::GetDocString.

Als geen van beide gevallen waar is, retourneert CDocTemplate::yesAttemptForeignde functie .

De standaard implementatie retourneert of CDocTemplate::maybeAttemptForeignCDocTemplate::maybeAttemptNative. Overschrijf deze functie om typekoppelingslogica te implementeren die geschikt is voor uw toepassing, mogelijk met behulp van deze twee waarden uit de Confidence opsomming.

CDocTemplate::OpenDocumentFile

Hiermee opent u een bestand dat is opgegeven door een pad.

virtual CDocument* OpenDocumentFile(LPCTSTR lpszPathName) = 0;

virtual CDocument* OpenDocumentFile(
    LPCTSTR lpszPathName,
    BOOL bAddToMRU) = 0;

Parameterwaarden

lpszPathName
[in] Aanwijzer naar het pad van het bestand dat het document bevat dat moet worden geopend.

bAddToMRU
[in] TRUE geeft aan dat het document een van de meest recente bestanden is; FALSE geeft aan dat het document niet een van de meest recente bestanden is.

Retourwaarde

Een aanwijzer naar het document waarvan het bestand de naam lpszPathNameheeft; NULL indien mislukt.

Opmerkingen

Hiermee opent u het bestand waarvan het pad is opgegeven door lpszPathName. Als lpszPathName dat het is NULL, wordt een nieuw bestand gemaakt dat een document bevat van het type dat aan deze sjabloon is gekoppeld.

CDocTemplate::RemoveDocument

Hiermee verwijdert u het document waarop wordt verwezen pDoc uit de lijst met documenten die aan deze sjabloon zijn gekoppeld.

virtual void RemoveDocument(CDocument* pDoc);

Parameterwaarden

pDoc
Wijs het document aan dat moet worden verwijderd.

Opmerkingen

De afgeleide klassen CMultiDocTemplate en CSingleDocTemplate overschrijven deze functie. Als u uw eigen documentsjabloonklasse hebt afgeleid van CDocTemplate, moet uw afgeleide klasse deze functie overschrijven.

CDocTemplate::SaveAllModified

Slaat alle documenten op die zijn gewijzigd.

virtual BOOL SaveAllModified();

Retourwaarde

Niet-nul indien geslaagd; anders 0.

CDocTemplate::SetContainerInfo

Bepaalt de resources voor OLE-containers bij het bewerken van een in-place OLE-item.

void SetContainerInfo(UINT nIDOleInPlaceContainer);

Parameterwaarden

nIDOleInPlaceContainer
De id van de resources die worden gebruikt wanneer een ingesloten object wordt geactiveerd.

Opmerkingen

Roep deze functie aan om de resources in te stellen die moeten worden gebruikt wanneer een OLE-object is geactiveerd. Deze resources kunnen menu's en acceleratortabellen bevatten. Deze functie wordt meestal aangeroepen in de CWinApp::InitInstance functie van uw toepassing.

Het menu dat is gekoppeld aan nIDOleInPlaceContainer scheidingstekens waarmee het menu van het geactiveerde in-place item kan worden samengevoegd met het menu van de containertoepassing. Zie het artikel Menu's en resources (OLE) voor meer informatie over het samenvoegen van server- en containermenu's.

CDocTemplate::SetDefaultTitle

Roep deze functie aan om de standaardtitel van het document te laden en weer te geven op de titelbalk van het document.

virtual void SetDefaultTitle(CDocument* pDocument) = 0;

Parameterwaarden

pDocument
Wijs het document aan waarvan de titel moet worden ingesteld.

Opmerkingen

Zie de beschrijving van CDocTemplate::docName in CDocTemplate::GetDocStringvoor meer informatie over de standaardtitel.

CDocTemplate::SetServerInfo

Bepaalt de resources en klassen wanneer het serverdocument ter plaatse is ingesloten of bewerkt.

void SetServerInfo(
    UINT nIDOleEmbedding,
    UINT nIDOleInPlaceServer = 0,
    CRuntimeClass* pOleFrameClass = NULL,
    CRuntimeClass* pOleViewClass = NULL);

Parameterwaarden

nIDOleEmbedding
De id van de resources die worden gebruikt wanneer een ingesloten object wordt geopend in een afzonderlijk venster.

nIDOleInPlaceServer
De id van de resources die worden gebruikt wanneer een ingesloten object in-place wordt geactiveerd.

pOleFrameClass
Wijs een CRuntimeClass structuur aan met klasse-informatie voor het framevensterobject dat is gemaakt wanneer in-place activering plaatsvindt.

pOleViewClass
Wijs een CRuntimeClass structuur aan met klassegegevens voor het weergaveobject dat is gemaakt wanneer in-place activering plaatsvindt.

Opmerkingen

Roep deze lidfunctie aan om resources te identificeren die door de servertoepassing worden gebruikt wanneer de gebruiker activering van een ingesloten object aanvraagt. Deze resources bestaan uit menu's en acceleratortabellen. Deze functie wordt meestal aangeroepen in de InitInstance toepassing.

Het menu dat is gekoppeld aan nIDOleInPlaceServer bevat scheidingstekens waarmee het servermenu kan worden samengevoegd met het menu van de container. Zie het artikel Menu's en resources (OLE) voor meer informatie over het samenvoegen van server- en containermenu's.

CDocTemplate::CreatePreviewFrame

Hiermee maakt u een onderliggend frame dat wordt gebruikt voor Uitgebreide preview.

CFrameWnd* CreatePreviewFrame(
    CWnd* pParentWnd,
    CDocument* pDoc);

Parameterwaarden

pParentWnd
Een aanwijzer naar een bovenliggend venster (meestal geleverd door de Shell).

pDoc
Een aanwijzer naar een documentobject waarvan de inhoud wordt bekeken.

Retourwaarde

Een geldige aanwijzer naar een CFrameWnd object of NULL als het maken mislukt.

Opmerkingen

CDocTemplate::SetPreviewInfo

Hiermee stelt u de out-of-process preview-handler in.

void SetPreviewInfo(
    UINT nIDPreviewFrame,
    CRuntimeClass* pPreviewFrameClass = NULL,
    CRuntimeClass* pPreviewViewClass = NULL);

Parameterwaarden

nIDPreviewFrame
Hiermee geeft u een resource-id van het voorbeeldframe op.

pPreviewFrameClass
Hiermee geeft u een aanwijzer naar een informatiestructuur van de runtimeklasse van het voorbeeldframe.

pPreviewViewClass
Hiermee geeft u een aanwijzer naar een informatiestructuur van de runtimeklasse van de preview-weergave.

Opmerkingen

Zie ook

CCmdTarget klasse
Hiërarchiegrafiek
CSingleDocTemplate klasse
CMultiDocTemplate klasse
CDocument klasse
CView klasse
CScrollView klasse
CEditView klasse
CFormView klasse
CFrameWnd klasse
CMDIChildWnd klasse

  • Last updated on