Classe CDocObjectServerItem
Implementa i verbi del server OLE in modo specifico per i server DocObject.
Sintassi
class CDocObjectServerItem : public COleServerItem
Membri
Costruttori protetti
| Nome | Descrizione |
|---|---|
| CDocObjectServerItem::CDocObjectServerItem | Costruisce un oggetto CDocObjectServerItem. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CDocObjectServerItem::GetDocument | Recupera un puntatore al documento che contiene l'elemento. |
Metodi protetti
| Nome | Descrizione |
|---|---|
| CDocObjectServerItem::OnDoVerb | Chiamato per eseguire un verbo. |
| CDocObjectServerItem::OnHide | Genera un'eccezione se il framework tenta di nascondere un elemento DocObject. |
| CDocObjectServerItem::OnShow | Chiamato dal framework per rendere attivo l'elemento DocObject sul posto. Se l'elemento non è un DocObject, chiama COleServerItem::OnShow. |
Osservazioni:
CDocObjectServerItem definisce le funzioni membro sostituibili: OnHide, OnDoVerb e OnShow.
Per usare CDocObjectServerItem, assicurarsi che l'override OnGetEmbeddedItem nella COleServerDocclasse derivata da restituisca un nuovo CDocObjectServerItem oggetto. Se è necessario modificare qualsiasi funzionalità nell'elemento, è possibile creare una nuova istanza della propria CDocObjectServerItemclasse derivata.
Per altre informazioni su DocObjects, vedere CDocObjectServer e COleCmdUI nelle informazioni di riferimento su MFC.
Gerarchia di ereditarietà
CDocObjectServerItem
Requisiti
Intestazione: afxdocob.h
CDocObjectServerItem::CDocObjectServerItem
Costruisce un oggetto CDocObjectServerItem.
CDocObjectServerItem(COleServerDoc* pServerDoc, BOOL bAutoDelete);
Parametri
pServerDoc
Puntatore al documento che conterrà il nuovo elemento DocObject.
bAutoDelete
Indica se l'oggetto può essere eliminato quando viene rilasciato un collegamento. Impostare l'argomento su FALSE se l'oggetto CDocObjectServerItem è una parte integrante dei dati del documento. Impostarla su TRUE se l'oggetto è una struttura secondaria usata per identificare un intervallo nei dati del documento che possono essere eliminati dal framework.
CDocObjectServerItem::GetDocument
Recupera un puntatore al documento che contiene l'elemento.
COleServerDoc* GetDocument() const;
Valore restituito
Puntatore al documento che contiene l'elemento; NULL se l'elemento non fa parte di un documento.
Osservazioni:
In questo modo è possibile accedere al documento del server passato come argomento al costruttore CDocObjectServerItem .
CDocObjectServerItem::OnDoVerb
Chiamato dal framework per eseguire il verbo specificato.
virtual void OnDoVerb(LONG iVerb);
Parametri
iVerb
Specifica il verbo da eseguire. Per i valori possibili, vedere IOleObject::D oVerb in Windows SDK.
Osservazioni:
L'implementazione predefinita chiama la funzione membro OnShow se l'elemento è un DocObject e viene specificato il OLEIVERB_INPLACEACTIVATE o OLEIVERB_SHOW. Se l'elemento non è un DocObject o viene specificato un verbo diverso, l'implementazione predefinita chiama COleServerItem::OnDoVerb.
CDocObjectServerItem::OnHide
Chiamato dal framework per nascondere l'elemento.
virtual void OnHide();
Osservazioni:
L'implementazione predefinita genera un'eccezione se l'elemento è un DocObject. Non è possibile nascondere un elemento DocObject attivo perché accetta l'intera visualizzazione. Per renderlo scomparso, è necessario disattivare l'elemento DocObject. Se l'elemento non è un DocObject, l'implementazione predefinita chiama COleServerItem::OnHide.
CDocObjectServerItem::OnShow
Chiamato dal framework per indicare all'applicazione server di rendere attivo l'elemento DocObject sul posto.
virtual void OnShow();
Osservazioni:
Se l'elemento non è un DocObject, l'implementazione predefinita chiama COleServerItem::OnShow. Eseguire l'override di questa funzione se si desidera eseguire un'elaborazione speciale quando si apre un elemento DocObject.
Vedi anche
Classe COleServerItem
Grafico della gerarchia
Classe CDocObjectServer
Classe COleDocObjectItem