Partager via


CDocObjectServerItem, classe

Implémente les verbes de serveur OLE , en particulier pour les serveurs DocObject.

Syntaxe

class CDocObjectServerItem : public COleServerItem

Membres

Constructeurs protégés

Nom Description
CDocObjectServerItem ::CDocObjectServerItem Construit un objet CDocObjectServerItem.

Méthodes publiques

Nom Description
CDocObjectServerItem ::GetDocument Récupère un pointeur vers le document qui contient l’élément.

Méthodes protégées

Nom Description
CDocObjectServerItem ::OnDoVerb Appelé pour exécuter un verbe.
CDocObjectServerItem ::OnHide Lève une exception si l’infrastructure tente de masquer un élément DocObject.
CDocObjectServerItem ::OnShow Appelé par l’infrastructure pour rendre l’élément DocObject actif sur place. Si l’élément n’est pas un DocObject, appelle COleServerItem ::OnShow.

Notes

CDocObjectServerItem définit les fonctions membres substituables : OnHide, OnDoVerb et OnShow.

Pour utiliser CDocObjectServerItem, assurez-vous que le remplacement OnGetEmbeddedItem dans votre COleServerDocclasse dérivée renvoie un nouvel CDocObjectServerItem objet. Si vous devez modifier les fonctionnalités de votre élément, vous pouvez créer une instance de votre propre CDocObjectServerItemclasse dérivée.

Pour plus d’informations sur DocObjects, consultez CDocObjectServer et COleCmdUI dans la référence MFC.

Hiérarchie d'héritage

CObject

CCmdTarget

CDocItem

COleServerItem

CDocObjectServerItem

Spécifications

En-tête : afxdocob.h

CDocObjectServerItem ::CDocObjectServerItem

Construit un objet CDocObjectServerItem.

CDocObjectServerItem(COleServerDoc* pServerDoc, BOOL bAutoDelete);

Paramètres

pServerDoc
Pointeur vers le document qui contiendra le nouvel élément DocObject.

bAutoDelete
Indique si l’objet peut être supprimé lorsqu’un lien vers celui-ci est libéré. Définissez l’argument sur FALSE si l’objet CDocObjectServerItem fait partie intégrante des données de votre document. Définissez-la sur TRUE si l’objet est une structure secondaire utilisée pour identifier une plage dans les données de votre document qui peuvent être supprimées par l’infrastructure.

CDocObjectServerItem ::GetDocument

Récupère un pointeur vers le document qui contient l’élément.

COleServerDoc* GetDocument() const;

Valeur de retour

Pointeur vers le document qui contient l’élément ; NULL si l’élément ne fait pas partie d’un document.

Notes

Cela permet d’accéder au document serveur que vous avez passé en tant qu’argument au constructeur CDocObjectServerItem .

CDocObjectServerItem ::OnDoVerb

Appelé par l’infrastructure pour exécuter le verbe spécifié.

virtual void OnDoVerb(LONG iVerb);

Paramètres

iVerb
Spécifie le verbe à exécuter. Pour connaître les valeurs possibles, consultez IOleObject ::D oVerb dans le Kit de développement logiciel (SDK) Windows.

Notes

L’implémentation par défaut appelle la fonction membre OnShow si l’élément est un DocObject et que le OLEIVERB_INPLACEACTIVATE ou OLEIVERB_SHOW est spécifié. Si l’élément n’est pas un DocObject ou un verbe différent est spécifié, l’implémentation par défaut appelle COleServerItem ::OnDoVerb.

CDocObjectServerItem ::OnHide

Appelé par l’infrastructure pour masquer l’élément.

virtual void OnHide();

Notes

L’implémentation par défaut lève une exception si l’élément est un DocObject. Vous ne pouvez pas masquer un élément DocObject actif, car il prend l’ensemble de l’affichage. Vous devez désactiver l’élément DocObject pour le faire disparaître. Si l’élément n’est pas un DocObject, l’implémentation par défaut appelle COleServerItem ::OnHide.

CDocObjectServerItem ::OnShow

Appelé par l’infrastructure pour indiquer à l’application serveur de rendre l’élément DocObject actif sur place.

virtual void OnShow();

Notes

Si l’élément n’est pas un DocObject, l’implémentation par défaut appelle COleServerItem ::OnShow. Remplacez cette fonction si vous souhaitez effectuer un traitement spécial lors de l’ouverture d’un élément DocObject.

Voir aussi

COleServerItem, classe
Graphique hiérarchique
CDocObjectServer, classe
COleDocObjectItem, classe