IRichEditOleCallback::GetContextMenu-Methode (richole.h)

Artikel
03/04/2024

Fragt die Anwendung ab, um ein Kontextmenü für ein Rechtsklickereignis zu verwenden.

Syntax

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

Parameter

seltype

Typ: WORD

Auswahltyp. Der Wert, der den Inhalt der neuen Auswahl angibt, kann mindestens einer der folgenden Werte sein.

Wert	Bedeutung
SEL_EMPTY	Die Auswahl ist leer.
SEL_TEXT	Text.
SEL_OBJECT	Mindestens ein COM-Objekt.
SEL_MULTICHAR	Mehr als ein Textzeichen.
SEL_MULTIOBJECT	Mehr als ein COM-Objekt.
GCM_RIGHTMOUSEDROP	Gibt an, dass ein Kontextmenü für einen Drop mit der rechten Maustaste generiert werden soll. Der lpoleobj-Parameter ist ein Zeiger auf die IDataObject-Schnittstelle für das objekt, das gelöscht wird.

lpoleobj

Typ: LPOLEOBJECT

Zeiger auf eine Schnittstelle. Wenn der seltype-Parameter das flag SEL_OBJECT enthält, ist lpoleobj ein Zeiger auf die IOleObject-Schnittstelle für das erste ausgewählte COM-Objekt. Wenn seltype das flag GCM_RIGHTMOUSEDROP enthält, ist lpoleobj ein Zeiger auf eine IDataObject-Schnittstelle . Andernfalls ist lpoleobjNULL. Wenn Sie den Schnittstellenzeiger behalten, müssen Sie die AddRef-Methode aufrufen, um die Verweisanzahl des Objekts zu erhöhen.

lpchrg

Typ: CHARRANGE*

Zeiger auf eine CHARRANGE-Struktur , die die aktuelle Auswahl enthält.

lphmenu

Typ: HMENU*

Das Handle eines zu verwendenden Kontextmenüs. Dieser Parameter wird ignoriert, wenn ein Fehler zurückgegeben wird. Ein umfangreiches Bearbeitungssteuerelement zerstört das Menü, wenn es damit fertig ist, sodass der Client dies nicht tut.

Rückgabewert

Typ: HRESULT

Gibt bei Erfolg S_OK zurück. Wenn die Methode fehlschlägt, kann dies der folgende Wert sein.

Rückgabecode	Beschreibung
E_INVALIDARG	Es gab ein ungültiges Argument.

Hinweise

Wenn der Benutzer ein Element aus dem Kontextfenster auswählt, wird eine WM_COMMAND Nachricht an das übergeordnete Fenster des Rich-Bearbeitungssteuerelements gesendet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	richole.h
DLL	Msftedit.dll

Weitere Informationen

CHARRANGE

GETCONTEXTMENUEX

IRichEditOleCallback

Referenz

Freigeben über