CDocObjectServerItem-klasse

Opmerking

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

Implementeert OLE-serverwoorden specifiek voor DocObject-servers.

Syntaxis

class CDocObjectServerItem : public COleServerItem

Leden

Beveiligde constructors

Naam	Description
CDocObjectServerItem::CDocObjectServerItem	Maakt een CDocObjectServerItem object.

Openbare methoden

Naam	Description
CDocObjectServerItem::GetDocument	Hiermee wordt een aanwijzer opgehaald naar het document dat het item bevat.

Beveiligde methoden

Naam	Description
CDocObjectServerItem::OnDoVerb	Aangeroepen om een werkwoord uit te voeren.
CDocObjectServerItem::OnHide	Genereert een uitzondering als het framework probeert een DocObject-item te verbergen.
CDocObjectServerItem::OnShow	Aangeroepen door het framework om het DocObject-item in-place actief te maken. Als het item geen DocObject is, roept u COleServerItem::OnShow aan.

Opmerkingen

CDocObjectServerItem definieert overschrijfbare lidfuncties: OnHide, OnDoVerb en OnShow.

Om te gebruiken CDocObjectServerItem, zorgt u ervoor dat de OnGetEmbeddedItem-onderdrukking in uw COleServerDoc-afgeleide klasse een nieuw CDocObjectServerItem object retourneert. Als u functionaliteit in uw item wilt wijzigen, kunt u een nieuw exemplaar van uw eigen CDocObjectServerItemafgeleide klasse maken.

Zie CDocObjectServer en COleCmdUI in de MFC Reference voor meer informatie over DocObjects.

Overnamehiërarchie

CObject

CCmdTarget

CDocItem

COleServerItem

CDocObjectServerItem

Requirements

Koptekst: afxdocob.h

CDocObjectServerItem::CDocObjectServerItem

Maakt een CDocObjectServerItem object.

CDocObjectServerItem(COleServerDoc* pServerDoc, BOOL bAutoDelete);

Parameterwaarden

pServerDoc
Een aanwijzer naar het document dat het nieuwe DocObject-item bevat.

bAutoDelete
Hiermee wordt aangegeven of het object kan worden verwijderd wanneer er een koppeling naar het object wordt vrijgegeven. Stel het argument in op FALSE als het CDocObjectServerItem object een integraal onderdeel is van de gegevens van uw document. Stel deze optie in op TRUE als het object een secundaire structuur is die wordt gebruikt om een bereik in de gegevens van uw document te identificeren die door het framework kunnen worden verwijderd.

CDocObjectServerItem::GetDocument

Hiermee wordt een aanwijzer opgehaald naar het document dat het item bevat.

COleServerDoc* GetDocument() const;

Retourwaarde

Een aanwijzer naar het document dat het item bevat; NULL als het item geen deel uitmaakt van een document.

Opmerkingen

Hiermee hebt u toegang tot het serverdocument dat u als argument hebt doorgegeven aan de CDocObjectServerItem-constructor .

CDocObjectServerItem::OnDoVerb

Aangeroepen door het framework om het opgegeven werkwoord uit te voeren.

virtual void OnDoVerb(LONG iVerb);

Parameterwaarden

iVerb
Hiermee geeft u het werkwoord dat moet worden uitgevoerd. Zie IOleObject::D oVerb in de Windows SDK voor mogelijke waarden.

Opmerkingen

De standaard implementatie roept de functie OnShow-lid aan als het item een DocObject is en de OLEIVERB_INPLACEACTIVATE of OLEIVERB_SHOW is opgegeven. Als het item geen DocObject is of een ander werkwoord is opgegeven, roept de standaardimplementatie COleServerItem::OnDoVerb aan.

CDocObjectServerItem::OnHide

Aangeroepen door het framework om het item te verbergen.

virtual void OnHide();

Opmerkingen

De standaardimplementatie genereert een uitzondering als het item een DocObject is. U kunt een actief DocObject-item niet verbergen omdat het de hele weergave heeft. U moet het DocObject-item deactiveren om het te laten verdwijnen. Als het item geen DocObject is, roept de standaardimplementatie COleServerItem::OnHide aan.

CDocObjectServerItem::OnShow

Aangeroepen door het framework om de servertoepassing opdracht te geven om het DocObject-item in-place actief te maken.

virtual void OnShow();

Opmerkingen

Als het item geen DocObject is, roept de standaardimplementatie COleServerItem::OnShow aan. Overschrijf deze functie als u speciale verwerking wilt uitvoeren bij het openen van een DocObject-item.

Zie ook

COleServerItem-klasse
Hiërarchiegrafiek
CDocObjectServer-klasse
COleDocObjectItem-klasse