IMenuPopup::P opup-Methode (shobjidl_core.h)

  • Artikel

Ruft das Kontextmenü an einem angegebenen Speicherort auf dem Bildschirm auf.

Syntax

HRESULT Popup(
  [in] POINTL        *ppt,
  [in] RECTL         *prcExclude,
  [in] MP_POPUPFLAGS dwFlags
);

Parameter

[in] ppt

Typ: POINTL*

Ein Zeiger auf eine POINTL-Struktur , der die Position des Popupmenüs in Bildschirmkoordinaten angibt. Das Popupmenü wird in Bezug auf diesen Punkt angezeigt, wie es durch die in dwFlags festgelegten Positionsflags bestimmt wird.

[in] prcExclude

Typ: RECTL*

Ein Zeiger auf eine RECTL-Struktur , der das Rechteck angibt, das beim Positionieren des Menüs ausgeschlossen werden soll. In Windows Vista wird die Ausrichtung des Menüs in Bezug auf diesen Bereich durch die in dwFlags festgelegten Ausrichtungsflags bestimmt. Dieser Parameter kann NULL sein, um den gesamten Bildschirm einzuschließen.

[in] dwFlags

Typ: MP_POPUPFLAGS

Mindestens eine der folgenden Konstanten, die die Anzeige des Popupmenüs steuern.

MPPF_SETFOCUS (0x00000001)

Das Menü sollte den Fokus haben, wenn es angezeigt wird.

MPPF_INITIALSELECT (0x00000002)

Das erste Element im Menü sollte ausgewählt sein.

MPPF_NOANIMATE (0x00000004)

Animieren Sie diese Show nicht.

MPPF_KEYBOARD (0x00000010)

Das Menü wird über die Tastatur aktiviert.

MPPF_REPOSITION (0x00000020)

Positionieren Sie die angezeigte Leiste neu.

MPPF_FORCEZORDER (0x00000040)

Die Menüleiste sollte Untermenüpositionen ignorieren.

MPPF_FINALSELECT (0x00000080)

Das letzte Element im Menü sollte ausgewählt sein.

MPPF_TOP (0x20000000)

Zeigt das Popupmenü über dem in ppt angegebenen Punkt an.

MPPF_LEFT (0x40000000)

Zeigen Sie das Popupmenü links neben dem in ppt angegebenen Punkt an.

MPPF_RIGHT (0x60000000)

Zeigen Sie das Popupmenü rechts neben dem in ppt angegebenen Punkt an.

MPPF_BOTTOM (0x80000000)

Zeigt das Popupmenü unterhalb des in ppt angegebenen Punkts an.

MPPF_POS_MASK (0xE0000000)

Maskierung für Positionswerte MPPF_TOP, MPPF_LEFT und MPPF_RIGHT.

MPPF_ALIGN_LEFT (0x02000000)

Standardausrichtung.

MPPF_ALIGN_RIGHT (0x04000000)

Das Popupmenü sollte rechts neben dem durch prcExclude angegebenen ausgeschlossenen Rechteck ausgerichtet werden.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn das Objekt das Popupmenü als modusloses Menü implementiert. Andernfalls wird S_FALSE zurückgegeben, der das Ende der Implementierung für das Menü angibt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)
DLL Shell32.dll (Version 5.0 oder höher)