Intersoft ClientUI Documentation
UXRibbonGalleryList Class
Members  See Also  Send Feedback
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 Class

Syntax

Visual Basic (Declaration) 
<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="OuterBorder", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="DropDownMenuContainer", Type=System.Windows.Controls.Border)>
<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.")>
<TemplatePartAttribute(Name="LabelContainer", Type=System.Windows.Controls.Grid)>
<TemplatePartAttribute(Name="AnimationElement", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)>
<TemplatePartAttribute(Name="GalleryContentElement", Type=System.Windows.Controls.ContentControl)>
<TemplatePartAttribute(Name="GalleryContainer", Type=System.Windows.Controls.Grid)>
<TemplatePartAttribute(Name="InnerBorder", Type=System.Windows.Controls.Border)>
<TemplatePartAttribute(Name="Glass", Type=System.Windows.Controls.Border)>
Public Class UXRibbonGalleryList 
   Inherits UXRibbonDropDownButtonBase
   Implements IControl, IFramework, ILicensing, INavigationSource, INavigationSupport, ICommandSource, IKeyboardFocus, IRibbonKeyTipAction 
Visual Basic (Usage)Copy Code
Dim instance As UXRibbonGalleryList
C# 
[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="OuterBorder", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="DropDownMenuContainer", Type=System.Windows.Controls.Border)]
[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.")]
[TemplatePartAttribute(Name="LabelContainer", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="AnimationElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="GalleryContentElement", Type=System.Windows.Controls.ContentControl)]
[TemplatePartAttribute(Name="GalleryContainer", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="InnerBorder", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="Glass", Type=System.Windows.Controls.Border)]
public class UXRibbonGalleryList : UXRibbonDropDownButtonBase, IControl, IFramework, ILicensing, INavigationSource, INavigationSupport, ICommandSource, IKeyboardFocus, IRibbonKeyTipAction 
JScript 
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="OuterBorder", Type=System.Windows.Controls.Border)
TemplatePartAttribute(Name="DropDownMenuContainer", Type=System.Windows.Controls.Border)
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.")
TemplatePartAttribute(Name="LabelContainer", Type=System.Windows.Controls.Grid)
TemplatePartAttribute(Name="AnimationElement", Type=System.Windows.Controls.Border)
TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)
TemplatePartAttribute(Name="GalleryContentElement", Type=System.Windows.Controls.ContentControl)
TemplatePartAttribute(Name="GalleryContainer", Type=System.Windows.Controls.Grid)
TemplatePartAttribute(Name="InnerBorder", Type=System.Windows.Controls.Border)
TemplatePartAttribute(Name="Glass", Type=System.Windows.Controls.Border)
public class UXRibbonGalleryList extends UXRibbonDropDownButtonBase implements IControl, IFramework, ILicensing, INavigationSource, INavigationSupport, ICommandSource, IKeyboardFocus, IRibbonKeyTipAction 
Managed Extensions for C++ 
[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="OuterBorder", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="DropDownMenuContainer", Type=System.Windows.Controls.Border)]
[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.")]
[TemplatePartAttribute(Name="LabelContainer", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="AnimationElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="GalleryContentElement", Type=System.Windows.Controls.ContentControl)]
[TemplatePartAttribute(Name="GalleryContainer", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="InnerBorder", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="Glass", Type=System.Windows.Controls.Border)]
public __gc class UXRibbonGalleryList : public UXRibbonDropDownButtonBase, IControl, IFramework, ILicensing, INavigationSource, INavigationSupport, ICommandSource, IKeyboardFocus, IRibbonKeyTipAction 
C++/CLI 
[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="OuterBorder", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="DropDownMenuContainer", Type=System.Windows.Controls.Border)]
[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.")]
[TemplatePartAttribute(Name="LabelContainer", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="AnimationElement", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="RootElement", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="GalleryContentElement", Type=System.Windows.Controls.ContentControl)]
[TemplatePartAttribute(Name="GalleryContainer", Type=System.Windows.Controls.Grid)]
[TemplatePartAttribute(Name="InnerBorder", Type=System.Windows.Controls.Border)]
[TemplatePartAttribute(Name="Glass", Type=System.Windows.Controls.Border)]
public ref class UXRibbonGalleryList : public UXRibbonDropDownButtonBase, IControl, IFramework, ILicensing, INavigationSource, INavigationSupport, ICommandSource, 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 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2012 All Rights Reserved.