Back to all docs
API Reference / Telerik.Windows.Controls / RadRibbonGallery
New to Telerik UI for WPF? Start a free 30-day trial

RadRibbonGallery

Class

Represents a gallery control designed for use within a ribbon interface, providing a customizable and interactive way to display and select items. The RadRibbonGallery supports features such as compression thresholds, popup menus, and scrolling.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.RibbonView.dll

Syntax:
C#
[Themable]
[TelerikToolboxCategory("Navigation")]
public class RadRibbonGallery : RadGallery, IMultiSelector, ISelector, ISelectorInteraction, IAutocomplete, IListControl, ICommandSource, IScrollingServiceCore, IScrollingInfo, IVariantControl

Inheritance: objectItemsControlSelectorListControlRadListBoxRadGalleryRadRibbonGallery...

Implements: IAutocompleteICommandSourceIListControlIMultiSelectorIScrollingInfoIScrollingServiceCoreISelectorISelectorInteractionIVariantControl...

Inherited Members RadGallery.ItemHeightPropertyRadGallery.ItemWidthPropertyRadGallery.ViewportWidthPropertyRadGallery.ResetTheme()RadGallery.GetContainerForItemOverride()RadGallery.IsItemItsOwnContainerOverride(object)RadGallery.PrepareContainerForItemOverride(DependencyObject, object)RadGallery.CanPerformSelection()RadGallery.ItemHeightRadGallery.ItemWidthRadGallery.ViewportWidthRadGallery.DeactivatePreviewRadGallery.ActivatePreviewRadListBox.DropVisualProviderPropertyRadListBox.DragDropBehaviorPropertyRadListBox.DragVisualProviderPropertyRadListBox.DataConverterPropertyRadListBox.IsItemSelectable(object)RadListBox.OnKeyDown(KeyEventArgs)RadListBox.HandleKeyboardInput(Key)RadListBox.OnTextInput(TextCompositionEventArgs)RadListBox.InitializeTextRetriever()RadListBox.GetDataItem(UIElement)RadListBox.UpdateItems(NotifyCollectionChangedAction, IList, IList)RadListBox.OnItemsChanged(NotifyCollectionChangedEventArgs)RadListBox.DropVisualProviderRadListBox.DragDropBehaviorRadListBox.DragVisualProviderRadListBox.DataConverterListControl.CanAutocompleteSelectItemsPropertyListControl.TextSearchModePropertyListControl.CanAutocompleteSelectPartialMatchesPropertyListControl.TypedTextPropertyListControl.CommandPropertyListControl.CommandParameterPropertyListControl.CommandTargetPropertyListControl.CanKeyboardNavigationSelectItemsPropertyListControl.IsScrollIntoViewEnabledPropertyListControl.ClearContainerForItemOverride(DependencyObject, object)ListControl.OnItemsPanelChanged(ItemsPanelTemplate, ItemsPanelTemplate)ListControl.OnPropertyChanged(DependencyPropertyChangedEventArgs)ListControl.ClearContainerStates(FrameworkElement)ListControl.HighlightedIndexChanged(int, Key)ListControl.OnMatchingItemChanged()ListControl.OnAutocompleteBehaviorTypedTextChanged()ListControl.IsIndexSelectable(int)ListControl.OnSelectionModeChanged()ListControl.ScrollIntoView(object)ListControl.ScrollIntoView(int)ListControl.SelectAllCommandListControl.CanAutocompleteSelectItemsListControl.CanAutocompleteSelectPartialMatchesListControl.TextSearchModeListControl.CanKeyboardNavigationSelectItemsListControl.IsScrollIntoViewEnabledListControl.TypedTextListControl.CommandListControl.CommandParameterListControl.CommandTargetListControl.IsItemsHostVisibleListControl.HighlightedItemListControl.KeyboardNavigationListControl.AutocompleteBehaviorListControl.HighlightedIndexItemsControlSelector.SelectionModePropertyItemsControlSelector.IsSynchronizedWithCurrentItemPropertyItemsControlSelector.SelectedIndexPropertyItemsControlSelector.SelectedItemPropertyItemsControlSelector.SelectedValuePropertyItemsControlSelector.SelectedValuePathPropertyItemsControlSelector.TextPropertyItemsControlSelector.TextPathPropertyItemsControlSelector.EnableSelectionCachingPropertyItemsControlSelector.SelectionChangedEventItemsControlSelector.OnItemsSourceChanged(IEnumerable, IEnumerable)ItemsControlSelector.ChangeVisualState(bool)ItemsControlSelector.OnIsEnabledChanged(DependencyPropertyChangedEventArgs)ItemsControlSelector.InitializeValueRetriever()ItemsControlSelector.InitializeSelectionBehavior()ItemsControlSelector.GetSelectionBehavior()ItemsControlSelector.EndInit()ItemsControlSelector.SelectionModeItemsControlSelector.IsSynchronizedWithCurrentItemItemsControlSelector.SelectedItemsItemsControlSelector.SelectionHelperItemsControlSelector.SelectedIndexItemsControlSelector.SelectedItemItemsControlSelector.SelectedValueItemsControlSelector.SelectedValuePathItemsControlSelector.SelectedValueBindingItemsControlSelector.TextBindingItemsControlSelector.TextItemsControlSelector.TextPathItemsControlSelector.EnableSelectionCachingItemsControlSelector.ItemSearchItemsControlSelector.ValueRetrieverItemsControlSelector.TextRetrieverItemsControlSelector.SelectionChanged...

Constructors

RadRibbonGallery()

Initializes a new instance of the RadRibbonGallery class.

C#
public RadRibbonGallery()

Fields

CompressedThresholdProperty

DependencyProperty

Identifies the CompressedThreshold property.

C#
public static readonly DependencyProperty CompressedThresholdProperty

IconProperty

DependencyProperty

Identifies the Icon property.

C#
public static readonly DependencyProperty IconProperty

IsCompressedProperty

DependencyProperty

Identifies the IsCompressed property.

C#
public static readonly DependencyProperty IsCompressedProperty

IsOpenChangedEvent

RoutedEvent

Identifies the IsOpenChangedEvent routed event.

C#
public static readonly RoutedEvent IsOpenChangedEvent

IsOpenProperty

DependencyProperty

Identifies the IsOpen property.

C#
public static readonly DependencyProperty IsOpenProperty

LayoutModeProperty

DependencyProperty

Identifies the LayoutMode property.

C#
public static readonly DependencyProperty LayoutModeProperty

MoreButtonTitleProperty

DependencyProperty

Identifies the MoreButtonTitle property.

C#
public static readonly DependencyProperty MoreButtonTitleProperty

PopupContentProperty

DependencyProperty

Identifies the popup content property.

C#
public static readonly DependencyProperty PopupContentProperty

PopupLaunchButtonVisibilityProperty

DependencyProperty

Identifies a PopupLaunchButtonVisibility property.

C#
public static readonly DependencyProperty PopupLaunchButtonVisibilityProperty

PopupMenuItemsProperty

DependencyProperty

Identifies the PopupMenuItems property.

C#
public static readonly DependencyProperty PopupMenuItemsProperty

PopupViewportHeightProperty

DependencyProperty

Identifies the PopupViewportHeight property.

C#
public static readonly DependencyProperty PopupViewportHeightProperty

PopupViewportWidthProperty

DependencyProperty

Identifies the PopupViewportWidth property.

C#
public static readonly DependencyProperty PopupViewportWidthProperty

ScrollViewerPositionDependencyProperty

DependencyProperty

Identifies a ScrollViewerPosition property.

C#
public static readonly DependencyProperty ScrollViewerPositionDependencyProperty

TitleProperty

DependencyProperty

Identifies the Title property.

C#
public static readonly DependencyProperty TitleProperty

UpDownButtonTitleProperty

DependencyProperty

Identifies the UpDownButtonTitle property.

C#
public static readonly DependencyProperty UpDownButtonTitleProperty

Properties

CompressedThreshold

Gets or sets the compressed threshold.

C#
public CollapseThreshold CompressedThreshold { get; set; }
Property Value:

The compressed threshold.

Icon

ImageSource

Gets or sets the icon.

C#
public ImageSource Icon { get; set; }
Property Value:

The icon.

IsCompressed

Gets a value indicating whether this instance is compressed.

C#
public bool IsCompressed { get; }
Property Value:

True if this instance is compressed; otherwise, false.

IsOpen

Gets or sets a value indicating whether the group is open.

C#
public bool IsOpen { get; set; }
Property Value:

True if this instance is open; otherwise, false.

LayoutMode

Gets or sets a value indicating the layout render mode of the control.

C#
public RibbonLayout LayoutMode { get; set; }

MoreButtonTitle

Gets or sets the MoreButton title.

C#
public string MoreButtonTitle { get; set; }
Property Value:

The title.

PopupContent

Gets or sets content to be shown when the Gallery popup is opened.

C#
public object PopupContent { get; set; }

PopupLaunchButtonVisibility

Visibility

Gets or sets the popup launch button visibility.

C#
public Visibility PopupLaunchButtonVisibility { get; set; }
Property Value:

The popup launch button visibility.

PopupMenuItems

Gets or sets the popup menu items.

C#
public ObservableCollection<UIElement> PopupMenuItems { get; set; }
Property Value:

The popup menu items.

PopupViewportHeight

Gets or sets the height of the popup viewport.

C#
public double PopupViewportHeight { get; set; }
Property Value:

The height of the popup viewport.

PopupViewportWidth

Gets or sets the width of the popup viewport.

C#
public double PopupViewportWidth { get; set; }
Property Value:

The width of the popup viewport.

Title

Gets or sets the title.

C#
public string Title { get; set; }
Property Value:

The title.

UpDownButtonTitle

Gets or sets the UpDownButtons title.

C#
public string UpDownButtonTitle { get; set; }
Property Value:

The title.

Methods

ChangeVisualState()

Changes the visual state of the control using transitions.

C#
protected void ChangeVisualState()

GetScrollViewerPart()

ScrollViewer

Called on initializing the ScrollViewer on template applied. It's mandatory to get the ScrollViewer in order to perform selection.

C#
protected override ScrollViewer GetScrollViewerPart()
Returns:

ScrollViewer

Overrides: ListControl.GetScrollViewerPart()

OnApplyTemplate()

When overridden in a derived class, is invoked whenever application code or internal processes (such as a rebuilding layout pass) call .

C#
public override void OnApplyTemplate()

Overrides: RadListBox.OnApplyTemplate()

OnCreateAutomationPeer()

AutomationPeer

Creates an appropriate GalleryAutomationPeer for this control as part of the WPF/Silverlight infrastructure.

C#
protected override AutomationPeer OnCreateAutomationPeer()
Returns:

AutomationPeer

Overrides: RadGallery.OnCreateAutomationPeer()

OnInitialized(EventArgs)

Raises the event. This method is invoked whenever is set to true internally.

C#
protected override void OnInitialized(EventArgs e)
Parameters:eEventArgs

The RoutedEventArgs that contains the event data.

Overrides: RadGallery.OnInitialized(EventArgs)

OnSelectionChanged(SelectionChangedEventArgs)

Called when the selection changes.

C#
protected override void OnSelectionChanged(SelectionChangedEventArgs e)
Parameters:eSelectionChangedEventArgs

The event data.

Overrides: RadListBox.OnSelectionChanged(SelectionChangedEventArgs)

SetVariant(RibbonGroupVariant)

Sets the variant.

C#
public void SetVariant(RibbonGroupVariant variant)
Parameters:variantRibbonGroupVariant

Implements: IVariantControl.SetVariant(RibbonGroupVariant)

Events

IsOpenChanged

Occurs on mouse leave.

C#
public event EventHandler<RadRoutedEventArgs> IsOpenChanged
In this article
DefinitionConstructorsRadRibbonGallery()FieldsCompressedThresholdPropertyIconPropertyIsCompressedPropertyIsOpenChangedEventIsOpenPropertyLayoutModePropertyMoreButtonTitlePropertyPopupContentPropertyPopupLaunchButtonVisibilityPropertyPopupMenuItemsPropertyPopupViewportHeightPropertyPopupViewportWidthPropertyScrollViewerPositionDependencyPropertyTitlePropertyUpDownButtonTitlePropertyPropertiesCompressedThresholdIconIsCompressedIsOpenLayoutModeMoreButtonTitlePopupContentPopupLaunchButtonVisibilityPopupMenuItemsPopupViewportHeightPopupViewportWidthTitleUpDownButtonTitleMethodsChangeVisualState()GetScrollViewerPart()OnApplyTemplate()OnCreateAutomationPeer()OnInitialized(EventArgs)OnSelectionChanged(SelectionChangedEventArgs)SetVariant(RibbonGroupVariant)EventsIsOpenChanged
Not finding the help you need?
Contact Support