COleClientItem::Activate

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

Paramètres

nVerb

Spécifie le verbe à exécuter. Il peut être l'une des opérations suivantes:

Valeur Sens Symbole
– 0 Verbe principal OLEIVERB_PRIMARY
– 1 Verbe secondaire (Aucun)
– 1 Élément d'affichage pour l'édition OLEIVERB_SHOW
– 2 Modifiez l'élément dans une fenêtre distincte OLEIVERB_OPEN
– 3 Masquer les articles OLEIVERB_HIDE

La valeur – 1 est généralement un alias pour un autre verbe. Si l'édition ouverte n'est pas pris en charge, – 2 a le même effet que 1. Pour les valeurs supplémentaires, voir IOleObject::DoVerb dans la documentation OLE.

pView

Pointeur vers la fenêtre d'affichage conteneur qui contient l'élément OLE ; Ceci est utilisé par l'application serveur pour l'activation sur place. Ce paramètre doit être NULL si le conteneur ne supporte pas l'activation sur place.

lpMsg

Pointeur vers le message qui a provoqué l'élément à être activé.

Remarques

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

Si l'application serveur a été écrite à l'aide de la bibliothèque Microsoft Foundation Class, cette fonction provoque la fonction membre OnDoVerb de l'objet de COleServerItem correspondant doit être exécuté.

Si le verbe principal est de modifier et de zéro est spécifié dans le paramètre nVerb , l'application serveur est lancée pour permettre à l'élément OLE doit être modifié. Si l'application conteneur prend en charge l'activation sur place, montage peut se faire en place. Si le conteneur ne supporte pas l'activation in-place (ou si le verbe Open est spécifié), le serveur est lancé dans une fenêtre séparée et montage peut se faire en y. Généralement, lorsque l'utilisateur de l'application conteneur double-clique sur l'élément OLE, le verbe principal dans le paramètre nVerb la valeur détermine l'action que l'utilisateur peut prendre. Cependant, si le serveur prend en charge qu'une seule action, il faut que l'action, n'importe qui la valeur est spécifiée dans le paramètre nVerb.

Pour plus d'informations, voir IOleObject::DoVerb dans la documentation OLE.

Aperçu de COleClientItem |nbsp ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;COleClientItem::DoVerb, COleServerItem::OnDoVerb

Index