CommandBar.ShowPopup-Methode (Office)

Artikel
10/16/2024

Zeigt eine Befehlsleiste als Kontextmenü an den angegebenen Koordinaten oder an den aktuellen Zeigerkoordinaten an.

Hinweis

[!HINWEIS] "CommandBar"-Objekte wurden in einigen Microsoft Office-Anwendungen durch die neue Menüband-Komponente der Microsoft Office Fluent-Benutzeroberfläche abgelöst. Weitere Informationen finden Sie unter Übersicht über das Office Fluent-Menüband.

Syntax

Ausdruck. ShowPopup(x, y)

Ausdruck Eine Variable, die ein CommandBar-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
x	Optional	Variant	Die x-Koordinate, auf der die Position des Kontextmenüs basiert. Wenn dieses Argument nicht angegeben wird, wird die aktuelle x-Koordinate des Zeigers verwendet.
y	Optional	Variant	Die y-Koordinate, auf der die Position des Kontextmenüs basiert. Wenn dieses Argument nicht angegeben wird, wird die aktuelle y-Koordinate des Zeigers verwendet.

Hinweise

Wenn Menüs linksbündig ausgerichtet sind, hat das von der ShowPopup-Methode angezeigte Kontextmenü die obere linke Ecke (x, y + 1); Wenn Menüs rechtsbündig ausgerichtet sind, hat das Kontextmenü seine obere rechte Ecke bei (x + 1, y + 1). Verwenden Sie die Windows-Funktion GetSystemMetrics(SM_MENUDROPALIGNMENT), um die Systemmetrik auf die Ausrichtung des Dropdownmenüs zu überprüfen.

Wenn die Bildschirmposition der Koordinaten (x, y) dazu führt, dass das Popupmenü ganz oder teilweise über den Rand des sichtbaren Bildschirms hinaus angezeigt wird, wird das Popupmenü so verschoben, dass es in den sichtbaren Bereich passt.

Beispiel

In diesem Beispiel wird ein Kontextmenü mit zwei Steuerelementen erstellt. Das Kontextmenü wird mit der ShowPopup-Methode sichtbar gemacht.

Set myBar = CommandBars _ 
    .Add(Name:="Custom", Position:=msoBarPopup, Temporary:=False) 
With myBar 
    .Controls.Add Type:=msoControlButton, Id:=3 
    .Controls.Add Type:=msoControlComboBox 
End With 
myBar.ShowPopup

Hinweis

Wenn die Position-Eigenschaft der Befehlsleiste nicht auf msoBarPopup festgelegt ist, kann diese Methode nicht angewendet werden.

Siehe auch

Elemente des CommandBar-Objekts

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.

Freigeben über