Gruppe (Windows-Menübandframework)
Die Gruppe organisiert verwandte Befehle und Steuerelemente auf einer Registerkarte.
Details
Der folgende Screenshot veranschaulicht das Menübandgruppen-Steuerelement.
Gruppeneigenschaften
Das Menübandframework definiert eine Auflistung von Eigenschaftenschlüsseln für das Group-Steuerelement.
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 Invaliditätsereignis wird von der IUICommandHandler::UpdateProperty-Rückrufmethode behandelt und die Eigenschaft aktualisiert.
Die IUICommandHandler::UpdateProperty-Rückrufmethode wird nicht ausgeführt, und die Anwendung wird nach einem aktualisierten Eigenschaftswert abgefragt, bis die Eigenschaft vom Framework erforderlich ist. Beispielsweise, wenn eine Registerkarte aktiviert ist 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 Group-Steuerelement zugeordnet sind.
| Eigenschaftenschlüssel | Hinweise |
|---|---|
| UI_PKEY_Keytip | Kann nur durch ungültige Aktualisierung 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 in der IUICommandHandler::UpdateProperty-Rückrufmethode angegebene Wert nicht mit dem Buchstaben Z beginnt, wird dieser Wert ignoriert und stattdessen vom Framework ein Wert generiert. Der Frameworkwert ist der Buchstabe Z, gefolgt von einem numerischen Wert, der bei 1 beginnt und bei Bedarf sequenziell für nachfolgende Gruppensteuerelemente (Z1, Z2, ..., Zx) erhöht wird. |
| UI_PKEY_Label | Kann nur durch ungültige Aktualisierung aktualisiert werden. |
| UI_PKEY_LargeHighContrastImage | Kann nur durch ungültige Aktualisierung aktualisiert werden. |
| UI_PKEY_LargeImage | Kann nur durch ungültige Aktualisierung aktualisiert werden. |
| UI_PKEY_SmallHighContrastImage | Kann nur durch ungültige Aktualisierung aktualisiert werden. |
| UI_PKEY_SmallImage | Kann nur durch ungültige Aktualisierung aktualisiert werden. |
| UI_PKEY_TooltipDescription | Kann nur durch ungültige Aktualisierung aktualisiert werden. |
| UI_PKEY_TooltipTitle | Kann nur durch ungültige Aktualisierung aktualisiert werden. |