ItemKeys Property

Returns a collection of GalleryItem keys that represents the GalleryItems that have been assigned to this GalleryItemGroup.

Syntax

Visual Basic

'Declaration
 
Public ReadOnly Property ItemKeys As ObservableCollection(Of String)

C#

public ObservableCollection<string> ItemKeys {get;}

Remarks

Adding the key of a GalleryItem to this collection causes the GalleryItem to be displayed within the GalleryItemGroup in the GalleryTool dropdown. It does not affect the display of the item in the GalleryTool preview area since GalleryItemGroups are never displayed in the GalleryTool preview area.

Note: The key of a GalleryItem may be added to the ItemKeys collection of more than one GalleryItemGroup. In this case the GalleryItem will be displayed in multiple GalleryItemGroups in the GalleryTool dropdown 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