Intersoft ClientUI Documentation
UXRibbonGalleryList Class
Members 



Intersoft.Client.UI.Aqua.UXRibbon Namespace : UXRibbonGalleryList Class
Represents a control that displays a collection of related items or Commands in the Ribbon. An expand button is provided to display the rest of the collection in a gallery popup panel.
Object Model
UXRibbonGalleryList ClassUXContextMenu ClassISFramework ClassStyleSelector ClassDataTemplateSelector ClassStylishLabel Class
Syntax
<DescriptionAttribute("Represents a control that displays a collection of related items or Commands in the Ribbon control. An expand button is provided to display the rest of the collection in a gallery popup panel.")>
<StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonGalleryItem)>
<StyleTypedPropertyAttribute(Property="DropDownMenuStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonContextMenu)>
<TemplatePartAttribute(Name="StylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)>
<TemplatePartAttribute(Name="AnimationElement", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="OuterBorder", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="DropDownMenuContainer", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="Glass", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="InnerBorder", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)>
<TemplatePartAttribute(Name="GalleryContainer", Type=System.Windows.Controls.Grid)>
<TemplatePartAttribute(Name="GalleryContentElement", Type=System.Windows.Controls.ContentControl)>
<TemplatePartAttribute(Name="LabelContainer", Type=System.Windows.Controls.Grid)>
Public Class UXRibbonGalleryList 
   Inherits UXRibbonDropDownButtonBase
   Implements Intersoft.Client.Framework.IControl, Intersoft.Client.Framework.IFramework, Intersoft.Client.Framework.ILicensing, Intersoft.Client.Framework.INavigationSource, Intersoft.Client.Framework.INavigationSupport, Intersoft.Client.Framework.Input.ICommandSource, Intersoft.Client.Framework.Input.IKeyboardFocus, IRibbonKeyTipAction 
Dim instance As UXRibbonGalleryList
[DescriptionAttribute("Represents a control that displays a collection of related items or Commands in the Ribbon control. An expand button is provided to display the rest of the collection in a gallery popup panel.")]
[StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonGalleryItem)]
[StyleTypedPropertyAttribute(Property="DropDownMenuStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonContextMenu)]
[TemplatePartAttribute(Name="StylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)]
[TemplatePartAttribute(Name="AnimationElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="OuterBorder", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="DropDownMenuContainer", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="Glass", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="InnerBorder", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="GalleryContainer", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="GalleryContentElement", Type=System.Windows.Controls.ContentControl)]
[TemplatePartAttribute(Name="LabelContainer", Type=System.Windows.Controls.Grid)]
public class UXRibbonGalleryList : UXRibbonDropDownButtonBase, Intersoft.Client.Framework.IControl, Intersoft.Client.Framework.IFramework, Intersoft.Client.Framework.ILicensing, Intersoft.Client.Framework.INavigationSource, Intersoft.Client.Framework.INavigationSupport, Intersoft.Client.Framework.Input.ICommandSource, Intersoft.Client.Framework.Input.IKeyboardFocus, IRibbonKeyTipAction  
[DescriptionAttribute("Represents a control that displays a collection of related items or Commands in the Ribbon control. An expand button is provided to display the rest of the collection in a gallery popup panel.")]
[StyleTypedPropertyAttribute(Property="ItemContainerStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonGalleryItem)]
[StyleTypedPropertyAttribute(Property="DropDownMenuStyle", StyleTargetType=Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonContextMenu)]
[TemplatePartAttribute(Name="StylishLabel", Type=Intersoft.Client.UI.Controls.StylishLabel)]
[TemplatePartAttribute(Name="AnimationElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="OuterBorder", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="DropDownMenuContainer", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="Glass", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="InnerBorder", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="GalleryContainer", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="GalleryContentElement", Type=System.Windows.Controls.ContentControl)]
[TemplatePartAttribute(Name="LabelContainer", Type=System.Windows.Controls.Grid)]
public ref class UXRibbonGalleryList : public UXRibbonDropDownButtonBase, Intersoft.Client.Framework.IControl, Intersoft.Client.Framework.IFramework, Intersoft.Client.Framework.ILicensing, Intersoft.Client.Framework.INavigationSource, Intersoft.Client.Framework.INavigationSupport, Intersoft.Client.Framework.Input.ICommandSource, Intersoft.Client.Framework.Input.IKeyboardFocus, IRibbonKeyTipAction 
Remarks

UXRibbonGalleryList is a rich UI control that displays a collection of related items or commands in the ribbon. It is particularly useful to display a list of preview items which allow users to intuitively recognize the results of a command or a selection before it is applied. If there are too many items in the gallery, an expand arrow is provided to display the rest of the collection in a floating, resizable popup.

UXRibbonGalleryList provides VisibileItemCount property which is used to determine the initial number of items to display in the gallery list. You can also set CollapsedItemCount, SmallItemCount, MediumItemCount and LargeItemCount properties which determine the number of items to display according to the size state of the gallery. As a ribbon-friendly control, UXRibbonGalleryList participates with the fluent resizing mechanism of the ribbon and updates the visible item count accordingly.

XAML
Copy Code 
<Intersoft:UXRibbonGalleryList Intersoft:UXRibbonKeyTipService.AccessText="L" 
                               Content="Styles Styles" MaxLargeButtonWidth="50"
                               Icon="/Intersoft.ClientUI.Samples.UXRibbon;component/Assets/Images/Doc/32/quickstyle.png">
    <Intersoft:UXRibbonGallery>
        <Intersoft:UXRibbonGalleryItem DisplayMode="Image" ImageWidth="64" ImageHeight="48" Icon="/assets/icons/paragraph.png" />
        <Intersoft:UXRibbonGalleryItem DisplayMode="Image" ImageWidth="64" ImageHeight="48" Icon="/assets/icons/paragraph1.png" />
        <Intersoft:UXRibbonGalleryItem DisplayMode="Image" ImageWidth="64" ImageHeight="48" Icon="/assets/icons/paragraph2.png" />
        <Intersoft:UXRibbonGalleryItem DisplayMode="Image" ImageWidth="64" ImageHeight="48" Icon="/assets/icons/paragraph3.png" />
        <Intersoft:UXRibbonGalleryItem DisplayMode="Image" ImageWidth="64" ImageHeight="48" Icon="/assets/icons/paragraph4.png" />
        <Intersoft:UXRibbonGalleryItem DisplayMode="Image" ImageWidth="64" ImageHeight="48" Icon="/assets/icons/paragraph5.png" />
        <Intersoft:UXRibbonGalleryItem DisplayMode="Image" ImageWidth="64" ImageHeight="48" Icon="/assets/icons/paragraph6.png" />
        <Intersoft:UXRibbonGalleryItem DisplayMode="Image" ImageWidth="64" ImageHeight="48" Icon="/assets/icons/paragraph7.png" />
        <Intersoft:UXRibbonGalleryItem DisplayMode="Image" ImageWidth="64" ImageHeight="48" Icon="/assets/icons/paragraph8.png" />
        <Intersoft:UXRibbonGalleryItem DisplayMode="Image" ImageWidth="64" ImageHeight="48" Icon="/assets/icons/paragraph9.png" />
    </Intersoft:UXRibbonGallery>
    <Intersoft:UXRibbonMenuItem Header="Clear Formatting" />
    <Intersoft:UXRibbonMenuItem Header="Apply Styles..." />
</Intersoft:UXRibbonGalleryList>

The result looks like the following figure.

To learn more about UXRibbonGalleryList, see Working with Galleries.

Inheritance Hierarchy

System.Object
   System.Windows.DependencyObject
      System.Windows.UIElement
         System.Windows.FrameworkElement
            System.Windows.Controls.Control
               System.Windows.Controls.ContentControl
                  System.Windows.Controls.Primitives.ButtonBase
                     System.Windows.Controls.Button
                        Intersoft.Client.Framework.ISButton
                           Intersoft.Client.UI.Aqua.UXButton
                              Intersoft.Client.UI.Aqua.UXButtonItems
                                 Intersoft.Client.UI.Aqua.UXDropDownButton
                                    Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonDropDownButtonBase
                                       Intersoft.Client.UI.Aqua.UXRibbon.UXRibbonGalleryList

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

UXRibbonGalleryList Members
Intersoft.Client.UI.Aqua.UXRibbon Namespace

Send Feedback