CDocObjectServerItem 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.

Kifejezetten DocObject-kiszolgálókhoz implementálja az OLE-kiszolgálói parancsokat.

Szemantika

class CDocObjectServerItem : public COleServerItem

Tagok

Védett konstruktorok

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

Nyilvános metódusok

Név	Description
CDocObjectServerItem::GetDocument	Az elemet tartalmazó dokumentumra mutató mutatót kér le.

Védett metódusok

Név	Description
CDocObjectServerItem::OnDoVerb	Egy ige végrehajtására van meghívva.
CDocObjectServerItem::OnHide	Kivételt eredményez, ha a keretrendszer megpróbál elrejteni egy DocObject-elemet.
CDocObjectServerItem::OnShow	A keretrendszer meghívta, hogy a DocObject elem helyben legyen aktív. Ha az elem nem DocObject, hívja meg a COleServerItem::OnShow parancsot.

Megjegyzések

CDocObjectServerItem Felülbírírozható tagfüggvényeket határoz meg: OnHide, OnDoVerb és OnShow.

A használathoz CDocObjectServerItemgyőződjön meg arról, hogy a származtatott osztály OnGetEmbeddedItemCOleServerDocfelülbírálása egy új CDocObjectServerItem objektumot ad vissza. Ha módosítania kell az elem bármely funkcióját, létrehozhat egy új példányt a saját CDocObjectServerItemszármaztatott osztályából.

További információ a DocObjectsről: CDocObjectServer és COleCmdUI az MFC-referenciaban.

Öröklési hierarchia

CObject

CCmdTarget

CDocItem

COleServerItem

CDocObjectServerItem

Requirements

Fejléc: afxdocob.h

CDocObjectServerItem::CDocObjectServerItem

Egy CDocObjectServerItem objektumot hoz létre.

CDocObjectServerItem(COleServerDoc* pServerDoc, BOOL bAutoDelete);

Paraméterek

pServerDoc
Az új DocObject elemet tartalmazó dokumentumra mutató mutató.

bAutoDelete
Azt jelzi, hogy az objektum törölhető-e, amikor megjelenik egy rá mutató hivatkozás. Állítsa az argumentumot HAMIS értékre, ha az CDocObjectServerItem objektum a dokumentum adatainak szerves része. Állítsa IGAZ értékre, ha az objektum egy másodlagos struktúra, amely a dokumentum adatainak egy olyan tartományát azonosítja, amelyet a keretrendszer törölhet.

CDocObjectServerItem::GetDocument

Az elemet tartalmazó dokumentumra mutató mutatót kér le.

COleServerDoc* GetDocument() const;

Visszaadott érték

Mutató az elemet tartalmazó dokumentumra; NULL érték, ha az elem nem része a dokumentumnak.

Megjegyzések

Ez lehetővé teszi a CDocObjectServerItem konstruktor számára argumentumként átadott kiszolgálódokumentum elérését.

CDocObjectServerItem::OnDoVerb

A keretrendszer meghívta a megadott igét.

virtual void OnDoVerb(LONG iVerb);

Paraméterek

iVerb
A végrehajtandó igét adja meg. A lehetséges értékekért lásd: IOleObject::D oVerb a Windows SDK-ban.

Megjegyzések

Az alapértelmezett implementáció meghívja az OnShow tagfüggvényt, ha az elem DocObject, és a OLEIVERB_INPLACEACTIVATE vagy OLEIVERB_SHOW meg van adva. Ha az elem nem DocObject, vagy egy másik parancs van megadva, az alapértelmezett implementáció meghívja a COleServerItem::OnDoVerb parancsot.

CDocObjectServerItem::OnHide

A keretrendszer meghívta, hogy elrejtse az elemet.

virtual void OnHide();

Megjegyzések

Az alapértelmezett implementáció kivételt eredményez, ha az elem DocObject. Az aktív DocObject elem nem rejthető el, mert az a teljes nézetet elfoglalja. A DocObject elemet inaktiválnia kell, hogy eltűnjön. Ha az elem nem DocObject, az alapértelmezett implementáció meghívja a COleServerItem::OnHide parancsot.

CDocObjectServerItem::OnShow

A keretrendszer meghívta, hogy utasítsa a kiszolgálóalkalmazást a DocObject elem helyben történő aktívvá tételére.

virtual void OnShow();

Megjegyzések

Ha az elem nem DocObject, az alapértelmezett implementáció meghívja a COleServerItem::OnShow parancsot. Bírálja felül ezt a függvényt, ha speciális feldolgozást szeretne végezni a DocObject elem megnyitásakor.

Lásd még

COleServerItem osztály
hierarchiadiagram
CDocObjectServer osztály
COleDocObjectItem osztály