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
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