CDocObjectServerItem – třída

Implementuje příkazy serveru OLE speciálně pro servery DocObject.

Syntaxe

class CDocObjectServerItem : public COleServerItem

Členové

Chráněné konstruktory

Jméno	popis
CDocObjectServerItem::CDocObjectServerItem	CDocObjectServerItem Vytvoří objekt.

Veřejné metody

Jméno	popis
CDocObjectServerItem::GetDocument	Načte ukazatel na dokument, který obsahuje položku.

Chráněné metody

Jméno	popis
CDocObjectServerItem::OnDoVerb	Volá se ke spuštění příkazu.
CDocObjectServerItem::OnHide	Vyvolá výjimku, pokud se rozhraní pokusí skrýt položku DocObject.
CDocObjectServerItem::OnShow	Volá se rozhraním, aby byla položka DocObject na místě aktivní. Pokud položka není DocObject, zavolá COleServerItem::OnShow.

Poznámky

CDocObjectServerItemdefinuje přepisovatelné členské funkce: OnHide, OnDoVerb a OnShow.

Chcete-li použít CDocObjectServerItem, ujistěte se, že OnGetEmbeddedItem přepsání ve vaší COleServerDoc-odvozené třídě vrátí nový CDocObjectServerItem objekt. Pokud potřebujete změnit jakékoli funkce v položce, můžete vytvořit novou instanci vlastní CDocObjectServerItem-odvozené třídy.

Další informace o DocObjects naleznete v tématu CDocObjectServer a COleCmdUI v referenční dokumentaci MFC.

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

CDocItem

COleServerItem

CDocObjectServerItem

Požadavky

Hlavička: afxdocob.h

CDocObjectServerItem::CDocObjectServerItem

CDocObjectServerItem Vytvoří objekt.

CDocObjectServerItem(COleServerDoc* pServerDoc, BOOL bAutoDelete);

Parametry

pServerDoc
Ukazatel na dokument, který bude obsahovat novou položku DocObject.

bAutoDelete
Určuje, zda lze objekt odstranit při uvolnění odkazu na objekt. Pokud je objekt nedílnou součástí dat dokumentu, nastavte argument na HODNOTU NEPRAVDA CDocObjectServerItem . Nastavte hodnotu TRUE, pokud je objekt sekundární strukturou, která slouží k identifikaci rozsahu v datech dokumentu, která lze odstranit rozhraním.

CDocObjectServerItem::GetDocument

Načte ukazatel na dokument, který obsahuje položku.

COleServerDoc* GetDocument() const;

Vrácená hodnota

Ukazatel na dokument, který obsahuje položku; HODNOTA NULL, pokud položka není součástí dokumentu.

Poznámky

To umožňuje přístup k dokumentu serveru, který jste předali jako argument konstruktoru CDocObjectServerItem .

CDocObjectServerItem::OnDoVerb

Volá se rozhraním ke spuštění zadaného příkazu.

virtual void OnDoVerb(LONG iVerb);

Parametry

iVerb
Určuje příkaz, který se má provést. Možné hodnoty najdete v tématu IOleObject::D oVerb v sadě Windows SDK.

Poznámky

Výchozí implementace volá členská funkce OnShow , pokud je položka DocObject a je zadán OLEIVERB_INPLACEACTIVATE nebo OLEIVERB_SHOW. Pokud položka není DocObject nebo je zadán jiný příkaz, výchozí implementace volá COleServerItem::OnDoVerb.

CDocObjectServerItem::OnHide

Volá se rozhraním pro skrytí položky.

virtual void OnHide();

Poznámky

Výchozí implementace vyvolá výjimku, pokud je položka DocObject. Aktivní položku DocObject nelze skrýt, protože přebírá celé zobrazení. Aby položka DocObject zmizela, musíte ji deaktivovat. Pokud položka není DocObject, výchozí implementace volá COleServerItem::OnHide.

CDocObjectServerItem::OnShow

Volá se architekturou, která dává serverové aplikaci pokyn, aby byla položka DocObject aktivní.

virtual void OnShow();

Poznámky

Pokud položka není DocObject, výchozí implementace volá COleServerItem::OnShow. Tuto funkci přepište, pokud chcete při otevření položky DocObject provést speciální zpracování.

Viz také

COleServerItem – třída
Graf hierarchie
CDocObjectServer – třída
COleDocObjectItem – třída