COleClientItem::Activate

Article
03/04/2013

Appelez cette fonction pour exécuter le verbe spécifié au lieu de DoVerb afin que vous puissiez créer votre propre traitement lorsqu'une exception est levée.

void Activate(
   LONG nVerb,
   CView* pView,
   LPMSG lpMsg = NULL 
);

Paramètres

nVerb
Spécifie le verbe pour exécuter.Elle peut avoir l'une des opérations suivantes :

Valeur	Signification	Symbole
– 0	Verbe principal	OLEIVERB_PRIMARY
– 1	Verbe secondaire	(Aucun)
– 1	Élément d'affichage pour modifier	OLEIVERB_SHOW
– 2	Élément de modification dans la fenêtre séparée	OLEIVERB_OPEN
– 3	Élément de masquage	OLEIVERB_HIDE

– 1 Valeur est généralement un alias pour un autre verbe.Si la modification ouverte n'est pas prise en charge, – 2 a le même effet que – 1.Pour les valeurs supplémentaires, consultez l' IOleObject::DoVerb dans Kit de développement logiciel Windows.

pView
Pointeur vers la fenêtre affichage de conteneur contenant l'élément OLE ; utilisé par l'application serveur pour l'activation sur place.Ce paramètre doit être NULL si le conteneur ne prend pas en charge l'activation sur place.
lpMsg
Pointeur vers le message qui a causé l'élément d'être lancé.

Notes

Si l'application serveur est écrite en utilisant la bibliothèque MFC, les causes de cette la fonction membre d' OnDoVerb de l'objet correspondant d' COleServerItem à exécuter.

Si le verbe principal est modification et zéro est spécifié dans le paramètre d' nVerb , l'application serveur est activée pour permettre le élément OLE à modifier.Si l'application conteneur prend en charge l'activation sur place, la modification peut être effectuée en place.Si le conteneur ne prend pas en charge l'activation sur place (ou si le verbe ouvert est spécifié), le serveur est activé dans une fenêtre séparée et la modification peut être effectuée à cet endroit.En général, lorsque l'utilisateur de l'application conteneur double-cliquez sur l'élément OLE, la valeur du verbe principal dans le paramètre d' nVerb détermine que l'action l'utilisateur peut prendre.Toutefois, si le serveur prend en charge une seule action, elle prend cette mesure, quelle que soit la valeur est spécifié dans le paramètre d' nVerb .

Pour plus d'informations, consultez l' IOleObject::DoVerb dans Kit de développement logiciel Windows.