Freigeben über


Gruppe (Windows Ribbon Framework)

Die Gruppe organisiert verwandte Befehle und Steuerelemente in einer Tab-.

Details

Der folgende Screenshot veranschaulicht das Menübandgruppen-Steuerelement.

Screenshot mit Beschriftungen mit einer Gruppe.

Gruppeneigenschaften

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

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

Die IUICommandHandler::UpdateProperty- Rückrufmethode wird nicht ausgeführt, und die Anwendung wird nach einem aktualisierten Eigenschaftswert abgefragt, bis die Eigenschaft vom Framework benötigt wird. Wenn beispielsweise eine Registerkarte aktiviert und ein Steuerelement in der Menüband-Benutzeroberfläche angezeigt wird, oder wenn eine QuickInfo angezeigt wird.

Anmerkung

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.

Eigenschaftsschlüssel Notizen
UI_PKEY_Keytip Kann nur durch Ungültigheit aktualisiert werden. Hinweis: 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 im IUICommandHandler::UpdateProperty Rückrufmethode bereitgestellte Wert nicht mit dem Buchstaben Z beginnt, wird dieser Wert ignoriert, und stattdessen wird ein Wert vom Framework generiert. Der Rahmenwert ist der Buchstabe Z gefolgt von einem numerischen Wert, der bei 1 beginnt und nach Bedarf für nachfolgende Gruppensteuerelemente (Z1, Z2, ..., Zx) nacheinander erhöht wird.
UI_PKEY_Label Kann nur durch Ungültigheit aktualisiert werden.
UI_PKEY_LargeHighContrastImage Kann nur durch Ungültigheit aktualisiert werden.
UI_PKEY_LargeImage Kann nur durch Ungültigheit aktualisiert werden.
UI_PKEY_SmallHighContrastImage Kann nur durch Ungültigheit aktualisiert werden.
UI_PKEY_SmallImage Kann nur durch Ungültigheit aktualisiert werden.
UI_PKEY_TooltipDescription Kann nur durch Ungültigheit aktualisiert werden.
UI_PKEY_TooltipTitle Kann nur durch Ungültigheit aktualisiert werden.

Windows Ribbon Framework-Steuerelementbibliothek

Group-Element