Méthode IRichEditOleCallback ::GetContextMenu (richole.h)

Article
03/01/2024

Interroge l’application pour obtenir un menu contextuel à utiliser sur un événement contextuel.

Syntaxe

HRESULT GetContextMenu(
  WORD        seltype,
  LPOLEOBJECT lpoleobj,
  CHARRANGE   *lpchrg,
  HMENU       *lphmenu
);

Paramètres

seltype

Type : WORD

Type de sélection. La valeur, qui spécifie le contenu de la nouvelle sélection, peut être une ou plusieurs des valeurs suivantes.

Valeur	Signification
SEL_EMPTY	La sélection est vide.
SEL_TEXT	Texte.
SEL_OBJECT	Au moins un objet COM.
SEL_MULTICHAR	Plusieurs caractères de texte.
SEL_MULTIOBJECT	Plusieurs objets COM.
GCM_RIGHTMOUSEDROP	Indique qu’un menu contextuel pour un glisser-déplacer de la souris droite doit être généré. Le paramètre lpoleobj est un pointeur vers l’interface IDataObject pour l’objet supprimé.

lpoleobj

Type : LPOLEOBJECT

Pointeur vers une interface. Si le paramètre seltype inclut l’indicateur SEL_OBJECT , lpoleobj est un pointeur vers l’interface IOleObject pour le premier objet COM sélectionné. Si seltype inclut l’indicateur GCM_RIGHTMOUSEDROP , lpoleobj est un pointeur vers une interface IDataObject . Sinon, lpoleobj a la valeur NULL. Si vous conservez le pointeur d’interface, vous devez appeler la méthode AddRef pour incrémenter le nombre de références de l’objet.

lpchrg

Type : CHARRANGE*

Pointeur vers une structure CHARRANGE contenant la sélection actuelle.

lphmenu

Type : HMENU*

Handle d’un menu contextuel à utiliser. Ce paramètre est ignoré si une erreur est retournée. Un contrôle d’édition enrichi détruit le menu lorsqu’il est terminé. Le client ne doit donc pas le faire.

Valeur retournée

Type : HRESULT

Renvoie S_OK en cas de réussite. Si la méthode échoue, il peut s’agir de la valeur suivante.

Code de retour	Description
E_INVALIDARG	Il n’y avait pas d’argument non valide.

Remarques

Lorsque l’utilisateur sélectionne un élément dans la fenêtre de contexte, un message WM_COMMAND est envoyé à la fenêtre parente du contrôle d’édition enrichi.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	richole.h
DLL	Msftedit.dll

Voir aussi

CHARRANGE

GETCONTEXTMENUEX

IRichEditOleCallback

Référence

Partager via