Partager via


COleClientItem::Activate

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.

Configuration requise

Header: afxole.h

Voir aussi

Référence

COleClientItem, classe

Graphique de la hiérarchie

COleClientItem::DoVerb

COleServerItem::OnDoVerb