[]
        
(Showing Draft Content)

C1.Win.Ribbon.RibbonGallery

RibbonGallery Class

Button that shows a drop-down gallery.

Implements
ISupportUiaContainer
Namespace: C1.Win.Ribbon
Assembly: C1.Win.Ribbon.4.8.dll
Syntax
public class RibbonGallery : RibbonDropDownBase, IComponent, IDisposable, ISupportUiaContainer

Constructors

Name Description
RibbonGallery()

Creates a new instance of RibbonGallery.

Properties

Name Description
AllowGroupFiltering

Gets or sets whether the Gallery can be filtering.

AllowZooming

Gets or sets whether the Gallery can zooming item image when image size more then item size.

CanBeAddedToQat

Gets or sets whether the user can add this RibbonItem to the Quick Access Toolbar at runtime.

DropDownAlign

Gets or sets the alignment of the drop-down portion relative to this component.

Expanded

Gets or sets whether the gallery should appear expanded in a RibbonGroup.

GripHandleVisible

Gets or sets a value indicating whether the drop-down can be resized.

IsExpanded

Gets a value indicating whether the gallery is currently expanded.

ItemSize

Gets or sets the size of the items in a gallery.

ItemSpacing

Gets or sets the spacing between gallery items.

Items

Gets the collection of items in the gallery.

KeyTip

Gets or sets the KeyTip providing keyboard access to a RibbonGallery.

MaxDropDownHeight

Gets or sets the maximum height of drop-down.

MenuItems

Gets the collection of extra items at the bottom of the drop-down portion of this RibbonComboBox.

MinVisibleItems

Gets or sets the minimum number of visible items in expanded mode.

OwnerDraw

Gets or sets a value indicating whether items are owner-drawn.

SelectedGroupName

Gets or sets name of the selected group name in the RibbonGallery.

SelectedIndex

Gets or sets index of the selected item in the RibbonGallery.

SelectedItem

Gets the selected item in the RibbonGallery.

ShouldSerializeItemSize
ShowInMore

Gets or sets a value indicating if this RibbonItem can be shown in drop down part of the More button when ribbon is simplified.

Text

Gets or sets the label used to identify this RibbonGallery.

VisibleItems

Gets or sets the number of visible items in expanded mode.

Methods

Name Description
Dispose(bool)

Clean up any resources being used.

OnDrawItem(DrawItemEventArgs)

Raises the DrawItem event.

OnElementToolTipShowing(ElementToolTipEventArgs)

Raises the ElementToolTipShowing event.

OnHighlightedItemChanged(GalleryEventArgs)

Raises the HighlightedItemChanged event.

OnSelectedIndexChanged(EventArgs)

Raises the SelectedIndexChanged event.

ResetItemSize()
ResetItemSpacing()
ResetText()

Restores the default value of the Text property.

ShouldSerializeItemSpacing()
ShouldSerializeItems()

This member is for internal use only.

ShouldSerializeMenuItems()
ShouldSerializeText()

Specifies whether to save the value of the Text property.

Events

Name Description
DrawItem

Occurs when the item is owner-drawn.

ElementToolTipShowing

Occurs before a tooltip of an gallery element is displayed. RibbonGallery has UpScrollButton, DownScrollButton and DropDownButton elements.

HighlightedItemChanged

Occurs when the mouse moves over a GalleryItem.

SelectedIndexChanged

Occurs when the value of the SelectedIndex property changes.