Gruppe (Windows Menübandframework)

Die Gruppe organisiert verwandte Befehle und Steuerelemente innerhalb einer Registerkarte.

Details

Der folgende Screenshot veranschaulicht das Menübandgruppen-Steuerelement.

Screenshot mit Callouts, die eine Gruppe anzeigen.

Gruppeneigenschaften

Das Menübandframework definiert eine Auflistung von Eigenschaftsschlüsseln für das Gruppensteuerelement.

In der Regel wird eine Group-Eigenschaft auf der Menübandbenutzeroberfläche aktualisiert, indem der dem Steuerelement zugeordnete Befehl durch einen Aufruf der IUIFramework::InvalidateUICommand-Methode ungültig wird. Das Invalidierungsereignis wird von der IUICommandHandler::UpdateProperty-Rückrufmethode behandelt und die Eigenschaft aktualisiert.

Die IUICommandHandler::UpdateProperty-Rückrufmethode wird nicht ausgeführt, und die Anwendung fragt einen aktualisierten Eigenschaftswert ab, bis die Eigenschaft vom Framework benötigt wird. Beispielsweise, wenn eine Registerkarte aktiviert und ein Steuerelement auf der Menüband-Benutzeroberfläche angezeigt wird oder wenn eine QuickInfo angezeigt wird.

Hinweis

In einigen Fällen kann eine Eigenschaft über die IUIFramework::GetUICommandProperty-Methode abgerufen und mit der IUIFramework::SetUICommandProperty-Methode festgelegt werden.

In der folgenden Tabelle sind die Eigenschaftenschlüssel aufgeführt, die dem Gruppensteuerelement zugeordnet sind.

Eigenschaftenschlüssel Hinweise
UI_PKEY_Keytip Kann nur durch Ungültigkeit aktualisiert werden.
[!Note]
Das Framework erfordert, dass der Wert von UI_PKEY_Keytip für ein Gruppensteuerelement mit dem Großbuchstaben Z beginnt. Wenn der von der Anwendung in der IUICommandHandler::UpdateProperty-Rückrufmethode angegebene Wert nicht mit dem Buchstaben Z beginnt, wird dieser Wert ignoriert, und stattdessen wird ein Wert vom Framework generiert. Der Frameworkwert ist der Buchstabe Z, gefolgt von einem numerischen Wert, der bei 1 beginnt und nach Bedarf für nachfolgende Gruppensteuerelemente (Z1, Z2, ..., Zx) sequenziell zunimmt.

UI_PKEY_Label Kann nur durch Ungültigkeit aktualisiert werden.
UI_PKEY_LargeHighContrastImage Kann nur durch Ungültigkeit aktualisiert werden.
UI_PKEY_LargeImage Kann nur durch Ungültigkeit aktualisiert werden.
UI_PKEY_SmallHighContrastImage Kann nur durch Ungültigkeit aktualisiert werden.
UI_PKEY_SmallImage Kann nur durch Ungültigkeit aktualisiert werden.
UI_PKEY_TooltipDescription Kann nur durch Ungültigkeit aktualisiert werden.
UI_PKEY_TooltipTitle Kann nur durch Ungültigkeit aktualisiert werden.

Windows Menüband-Framework-Steuerelementbibliothek

Group-Element