Partager via


COleClientItem::DoVerb

Appel DoVerb pour exécuter le verbe spécifié.

virtual BOOL DoVerb( 
   LONG nVerb, 
   CView* pView,
   LPMSG lpMsg = NULL  
);

Paramètres

  • nVerb
    Spécifie le verbe pour exécuter. Il peut inclure un des éléments suivants :

    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 d'affichage ; utilisé par le serveur pour l'activation sur place. Ce paramètre doit être NULL si l'application conteneur ne permet pas l'activation sur place.

  • lpMsg
    Pointeur vers le message qui a causé l'élément d'être lancé.

Valeur de retour

Une valeur différente de zéro si le verbe a été correctement exécutée ; sinon 0.

Notes

Appel de cette fonction la fonction membre d' Exécutez pour exécuter le verbe. Il intercepte également des exceptions et affiche un message à l'utilisateur s'il est levée.

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 .

Configuration requise

Header: afxole.h

Voir aussi

Référence

COleClientItem, classe

Graphique de la hiérarchie

COleClientItem::Activate