IRichEditOleCallback::GetContextMenu-Methode (richole.h)

  • Artikel

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