In-Ribbon-Katalog

  • Artikel

Das In-Ribbon Katalog ist ein Steuerelement, das eine Auflistung verwandter Elemente oder Befehle im Menüband anzeigt. Wenn zu viele Elemente im Katalog vorhanden sind, wird ein Erweiterungspfeil bereitgestellt, um den Rest der Sammlung in einem erweiterten Bereich anzuzeigen.

Details

Der folgende Screenshot veranschaulicht das Menüband In-Ribbon-Katalog-Steuerelement in Microsoft Paint.

Screenshot eines inribbongallery-Steuerelements im Microsoft Paint-Menüband.

Das Menübandframework definiert eine Auflistung von Eigenschaftenschlüsseln für das In-Ribbon Gallery-Steuerelement.

In der Regel wird eine In-Ribbon Gallery-Eigenschaft auf der Menübandbenutzeroberfläche aktualisiert, indem der dem Steuerelement zugeordnete Befehl durch einen Aufruf der IUIFramework::InvalidateUICommand-Methode ungültig wird. Das Invalidation-Ereignis 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 In-Ribbon Gallery-Steuerelement zugeordnet sind.

Eigenschaftenschlüssel Hinweise
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ültige aktualisiert werden.
UI_PKEY_Label Kann nur durch Ungültige aktualisiert werden.
UI_PKEY_LargeHighContrastImage Kann nur durch Ungültige aktualisiert werden.
UI_PKEY_LargeImage Kann nur durch Ungültige aktualisiert werden.
UI_PKEY_SelectedItem(nur gültig für einen Elementkatalog)
 Unterstützt IUIFramework::GetUICommandProperty und IUIFramework::SetUICommandProperty. Hinweis: Wenn der dem Steuerelement zugeordnete Befehl durch einen Aufruf von IUIFramework::InvalidateUICommand ungültig wird, fragt das Framework diese Eigenschaft ab, wenn UI_INVALIDATIONS_VALUE als Wert von Flags übergeben wird.
UI_PKEY_SmallHighContrastImage Kann nur durch Ungültige aktualisiert werden.
UI_PKEY_SmallImage Kann nur durch Ungültige aktualisiert werden.
UI_PKEY_TooltipDescription Kann nur durch Ungültige aktualisiert werden.
UI_PKEY_TooltipTitle Kann nur durch Ungültige aktualisiert werden.

Windows-Menüband-Framework-Steuerelementbibliothek

InRibbonGallery-Element

Arbeiten mit Katalogen

Katalogbeispiel