GalleryItemGroup Class

Defines a grouping that organizes the display of GalleryItem's in the GalleryTool dropdown.

Syntax

Visual Basic

'Declaration
 
Public Class GalleryItemGroup 
   Inherits System.Windows.Controls.ItemsControl

C#

public class GalleryItemGroup : System.Windows.Controls.ItemsControl 

Remarks

Adding a GalleryItemGroup to the GalleryTool.Groups collection will prevent the display of GalleryItems in the GalleryTool dropdown, unless you add the key of at least 1 GalleryItem to the ItemKeys collection of the GalleryItemGroup.

Note: Once a GalleryItemGroup has been added to the GalleryTool.Groups collection, the GalleryTool will not display GalleryItems in the GalleryTool dropdown unless they are assigned to GalleryItemGroups by adding the Key to the ItemKeys collection of the Group in which the GalleryItem should be displayed.

Note: Adding GalleryItemGroups to the GalleryTool.Groups collection has no effect on the display of GalleryItems in the GalleryTool preview area, since GalleryItemGroups are never displayed in the preview area.

Example

The following example shows how to use the create groups in gallery tool.

Visual Basic

Imports System
Imports System.Windows
Imports Infragistics.Windows.Ribbon


Namespace MyNamespace
    Public Partial Class MyWindow
        Inherits XamRibbonWindow
        Public Sub New()
            InitializeComponent()
        End Sub
       
        Protected Sub LoadGalleryTool()
            Dim galleryTool As New GalleryTool()
            menuTool.Items.Add(galleryTool)
           
            Dim group1 As New GalleryItemGroup()
            group1.Title = "Group1"
           
            Dim group2 As New GalleryItemGroup()
            group2.Title = "Group2"
           
            Dim group3 As New GalleryItemGroup()
            group3.Title = "Group3"
           
            galleryTool.Groups.Add(group1)
            galleryTool.Groups.Add(group2)
            galleryTool.Groups.Add(group3)
            For ind As Integer = 1 To 10
               
                Dim item As New GalleryItem()
                item.Key = "Item" + ind.ToString()
                item.Text = settings.Name
                item.Image = New BitmapImage(New Uri("\Images\ig_office_icon_16.png", UriKind.Relative))
                galleryTool.Items.Add(item)
               
                If ind < 7 Then
                    group1.ItemKeys.Add(Item.Key)
                Else
                    group2.ItemKeys.Add(Item.Key)
                End If
                group3.ItemKeys.Add(item.Key)
            Next
        End Sub
    End Class
End Namespace

C#

using System;
using System.Windows;
using Infragistics.Windows.Ribbon;


namespace MyNamespace
{
    public partial class MyWindow : XamRibbonWindow
    {
        public MyWindow()
        {
            InitializeComponent();
        }

        protected void LoadGalleryTool()
        {
            GalleryTool galleryTool = new GalleryTool();
            menuTool.Items.Add(galleryTool);

            GalleryItemGroup group1 = new GalleryItemGroup();
            group1.Title = "Group1";
            
			GalleryItemGroup group2 = new GalleryItemGroup();
            group2.Title = "Group2";
            
			GalleryItemGroup group3 = new GalleryItemGroup();
            group3.Title = "Group3";
			
            galleryTool.Groups.Add(group1);
            galleryTool.Groups.Add(group2);
            galleryTool.Groups.Add(group3);

            for (int ind = 1; ind <= 10; ind++)
            {
                GalleryItem item = new GalleryItem();
                item.Key = "Item" + ind.ToString();
                item.Text = settings.Name;
                item.Image = new BitmapImage(new Uri("\\Images\\ig_office_icon_16.png", UriKind.Relative));
                galleryTool.Items.Add(item);
				
				if(ind < 7)
				{
					group1.ItemKeys.Add(Item.Key);
				}
				else
				{
					group2.ItemKeys.Add(Item.Key);
				}
                group3.ItemKeys.Add(item.Key);
            }
        }
    }
}

XAML

<igRibbon:XamRibbonWindow x:Class="MyWindow"
    xmlns:igRibbon="http://infragistics.com/Ribbon"
    xmlns:s="clr-namespace:System;assembly=mscorlib">

  ....

  <igRibbon:RibbonGroup Id="ConnectionGallery" Caption="ConnectionGallery">
    <igRibbon:MenuTool ShouldDisplayGalleryPreview="True" Caption="Connections">
      <igRibbon:GalleryTool Name="galleryTool"
                            Id="galleryToolID"
                            AllowResizeDropDown="True"
                            Caption="Connection"
                            IsQatCommonTool="True"
                            ItemBehavior="Button"
                            ItemClicked="galleryTool_ItemClicked"
                            KeyTip="GT"
                            LargeImage="\Images\ig_office_icon_32.png"
                            SmallImage="\Images\ig_office_icon_16.png"
                            MaxDropDownColumns="7"
                            MaxPreviewColumns="7"
                            MinDropDownColumns="3"
                            MinPreviewColumns="3"
                            PreferredDropDownColumns="5"
                            ActivationInitialActionDelay="1000"
                            ActivationActionDelay="200">
        <igRibbon:GalleryTool.Groups>
          <igRibbon:GalleryItemGroup Title="Group1">
            <s:String>Item1</s:String>
            <s:String>Item2</s:String>
            <s:String>Item3</s:String>
            <s:String>Item4</s:String>
            <s:String>Item5</s:String>
            <s:String>Item6</s:String>
          </igRibbon:GalleryItemGroup>
          <igRibbon:GalleryItemGroup Title="Group2">
            <s:String>Item7</s:String>
            <s:String>Item8</s:String>
            <s:String>Item9</s:String>
            <s:String>Item10</s:String>
          </igRibbon:GalleryItemGroup>
          <igRibbon:GalleryItemGroup Title="Group3">
            <s:String>Item1</s:String>
            <s:String>Item2</s:String>
            <s:String>Item3</s:String>
            <s:String>Item4</s:String>
            <s:String>Item5</s:String>
            <s:String>Item6</s:String>
            <s:String>Item7</s:String>
            <s:String>Item8</s:String>
            <s:String>Item9</s:String>
            <s:String>Item10</s:String>
          </igRibbon:GalleryItemGroup>
        </igRibbon:GalleryTool.Groups>

        <igRibbon:GalleryTool.Items>
          <igRibbon:GalleryItem Key="Item1" Text="Item1" Image="\Images\ig_office_icon_16.png"/>
          <igRibbon:GalleryItem Key="Item2" Text="Item2" Image="\Images\ig_office_icon_16.png"/>
          <igRibbon:GalleryItem Key="Item3" Text="Item3" Image="\Images\ig_office_icon_16.png"/>
          <igRibbon:GalleryItem Key="Item4" Text="Item4" Image="\Images\ig_office_icon_16.png"/>
          <igRibbon:GalleryItem Key="Item5" Text="Item5" Image="\Images\ig_office_icon_16.png"/>
          <igRibbon:GalleryItem Key="Item6" Text="Item6" Image="\Images\ig_office_icon_16.png"/>
          <igRibbon:GalleryItem Key="Item7" Text="Item7" Image="\Images\ig_office_icon_16.png"/>
          <igRibbon:GalleryItem Key="Item8" Text="Item8" Image="\Images\ig_office_icon_16.png"/>
          <igRibbon:GalleryItem Key="Item9" Text="Item9" Image="\Images\ig_office_icon_16.png"/>
          <igRibbon:GalleryItem Key="Item10" Text="Item10" Image="\Images\ig_office_icon_16.png"/>
        </igRibbon:GalleryTool.Items>
      </igRibbon:GalleryTool>
    </igRibbon:MenuTool>

  </igRibbon:RibbonGroup>

  ....

</igRibbon:XamRibbonWindow>

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, 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