CDocObjectServerItem – třída
Implementuje příkazy serveru OLE speciálně pro servery DocObject.
Syntaxe
class CDocObjectServerItem : public COleServerItem
Členové
Chráněné konstruktory
| Název | Popis |
|---|---|
| CDocObjectServerItem::CDocObjectServerItem | CDocObjectServerItem Vytvoří objekt. |
Veřejné metody
| Název | Popis |
|---|---|
| CDocObjectServerItem::GetDocument | Načte ukazatel na dokument, který obsahuje položku. |
Chráněné metody
| Název | 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
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;
Návratová 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