Kombinationsfeld (Windows Ribbon Framework)
Das Kombinationsfeld besteht aus einem einspaltigen Listenfeld, das eine Sammlung sich gegenseitig ausschließenden Elementen oder Befehlen enthält, kombiniert mit einem statischen Steuerelement oder Bearbeitungssteuerelement und einem Dropdownpfeil. Der Listenfeldteil des Steuerelements wird angezeigt, wenn der Benutzer auf den Dropdownpfeil klickt.
Details
Das aktuell ausgewählte Element oder befehl (sofern vorhanden) im Listenfeld wird im statischen oder Bearbeitungssteuerelement angezeigt. Wenn der Benutzer mit einem Bearbeitungssteuerelement die Anfangszeichen eines vorhandenen Elements oder Befehls eingibt, wird das erste Element mit diesen Anfangszeichen hervorgehoben und der Eintrag im Bearbeitungssteuerelement automatisch abgeschlossen.
Unterstützt nur einen vertikalen Ziehpunkt oder einen Ziehpunkt zum Ändern der Größe.
Dieses Steuerelement ist nützlich, um einfache, eng verwandte Textelemente verfügbar zu macht.
Der folgende Screenshot veranschaulicht das Menüband-Kombinationsfeld in Live Movie Maker.
Eigenschaften des Kombinationsfelds
Das Menübandframework definiert eine Auflistung von Eigenschaftentasten für das Kombinationsfeld-Steuerelement.
In der Regel wird eine Kombinationsfeld-Eigenschaft in 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 Kombinationsfeld-Steuerelement zugeordnet sind.
| Eigenschaftsschlüssel | Notizen |
|---|---|
| UI_PKEY_Categories | Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty. |
| UI_PKEY_Enabled | Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty. |
| UI_PKEY_ItemsSource | Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty. |
| UI_PKEY_Keytip | Kann nur durch Ungültigheit aktualisiert werden. |
| 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_SelectedItem | Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty. |
| UI_PKEY_SmallHighContrastImage | Kann nur durch Ungültigheit aktualisiert werden. |
| UI_PKEY_SmallImage | Kann nur durch Ungültigheit aktualisiert werden. |
| UI_PKEY_StringValue | Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty.
Hinweis: Wenn der dem Steuerelement zugeordnete Befehl durch einen Aufruf von IUIFramework::InvalidateUICommandungültig wird, fragt das Framework diese Eigenschaft ab, wenn UI_INVALIDATIONS_VALUE als Wert von Flagsübergeben wird. |
| UI_PKEY_TooltipDescription | Kann nur durch Ungültigheit aktualisiert werden. |
| UI_PKEY_TooltipTitle | Kann nur durch Ungültigheit aktualisiert werden. |