Klasa CDocObjectServerItem

Implementuje czasowniki serwera OLE przeznaczone specjalnie dla serwerów DocObject.

Składnia

class CDocObjectServerItem : public COleServerItem

Elementy członkowskie

Konstruktory chronione

Nazwa/nazwisko	opis
CDocObjectServerItem::CDocObjectServerItem	CDocObjectServerItem Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CDocObjectServerItem::GetDocument	Pobiera wskaźnik do dokumentu zawierającego element.

Metody chronione

Nazwa/nazwisko	opis
CDocObjectServerItem::OnDoVerb	Wywoływana w celu wykonania zlecenia.
CDocObjectServerItem::OnHide	Zgłasza wyjątek, jeśli struktura próbuje ukryć element DocObject.
CDocObjectServerItem::OnShow	Wywoływana przez strukturę w celu aktywowania elementu DocObject w miejscu. Jeśli element nie jest obiektem DocObject, wywołuje metodę COleServerItem::OnShow.

Uwagi

CDocObjectServerItem definiuje funkcje składowych, które można zastąpić: OnHide, OnDoVerb i OnShow.

Aby użyć CDocObjectServerItemmetody , upewnij się, że przesłonięcia OnGetEmbeddedItem w COleServerDocklasie -pochodnej zwraca nowy CDocObjectServerItem obiekt. Jeśli musisz zmienić jakiekolwiek funkcje w elemencie, możesz utworzyć nowe wystąpienie własnej CDocObjectServerItemklasy pochodnej.

Aby uzyskać więcej informacji na temat obiektów DocObjects, zobacz CDocObjectServer i COleCmdUI w dokumentacji MFC.

Hierarchia dziedziczenia

Obiekt CObject

CCmdTarget

CDocItem

COleServerItem

CDocObjectServerItem

Wymagania

Nagłówek: afxdocob.h

CDocObjectServerItem::CDocObjectServerItem

CDocObjectServerItem Tworzy obiekt.

CDocObjectServerItem(COleServerDoc* pServerDoc, BOOL bAutoDelete);

Parametry

pServerDoc
Wskaźnik do dokumentu, który będzie zawierać nowy element DocObject.

bAutoDelete
Wskazuje, czy obiekt można usunąć, gdy zostanie zwolniony link. Ustaw argument na FALSE, jeśli CDocObjectServerItem obiekt jest integralną częścią danych dokumentu. Ustaw wartość TRUE, jeśli obiekt jest strukturą pomocniczą służącą do identyfikowania zakresu w danych dokumentu, które mogą zostać usunięte przez platformę.

CDocObjectServerItem::GetDocument

Pobiera wskaźnik do dokumentu zawierającego element.

COleServerDoc* GetDocument() const;

Wartość zwracana

Wskaźnik do dokumentu zawierającego element; Wartość NULL, jeśli element nie jest częścią dokumentu.

Uwagi

Umożliwia to dostęp do dokumentu serwera przekazanego jako argument konstruktora CDocObjectServerItem .

CDocObjectServerItem::OnDoVerb

Wywoływana przez strukturę w celu wykonania określonego zlecenia.

virtual void OnDoVerb(LONG iVerb);

Parametry

iVerb
Określa czasownik do wykonania. Aby uzyskać możliwe wartości, zobacz IOleObject::D oVerb w zestawie Windows SDK.

Uwagi

Domyślna implementacja wywołuje funkcję składową OnShow , jeśli element jest obiektem DocObject, a OLEIVERB_INPLACEACTIVATE lub OLEIVERB_SHOW jest określony. Jeśli element nie jest obiektem DocObject lub określono inny czasownik, domyślna implementacja wywołuje COleServerItem::OnDoVerb.

CDocObjectServerItem::OnHide

Wywoływana przez strukturę w celu ukrycia elementu.

virtual void OnHide();

Uwagi

Domyślna implementacja zgłasza wyjątek, jeśli element jest obiektem DocObject. Nie można ukryć aktywnego elementu DocObject, ponieważ przyjmuje cały widok. Aby zniknąć, należy dezaktywować element DocObject. Jeśli element nie jest obiektem DocObject, domyślna implementacja wywołuje element COleServerItem::OnHide.

CDocObjectServerItem::OnShow

Wywoływana przez platformę w celu poinstruowania aplikacji serwera, aby element DocObject był aktywny w miejscu.

virtual void OnShow();

Uwagi

Jeśli element nie jest obiektem DocObject, domyślna implementacja wywołuje metodę COleServerItem::OnShow. Zastąpi tę funkcję, jeśli chcesz wykonać specjalne przetwarzanie podczas otwierania elementu DocObject.

Zobacz też

Klasa COleServerItem
Wykres hierarchii
Klasa CDocObjectServer
Klasa COleDocObjectItem