'Declaration Public Class GalleryTool Inherits System.Windows.Controls.Control
public class GalleryTool : System.Windows.Controls.Control
The GalleryTool exposes an Items property that holds a collection of GalleryItem objects. Each GalleryItem exposes a Textand a Image property which are displayed for each item. The GalleryTool also exposes a Groups property that holds a collection of GalleryItemGroup objects which define groupings for the GalleryItems when they are displayed in a GalleryTool dropdown. GalleryItems, which can belong to 1 or more GalleryItemGroups, are assigned to a GalleryItemGroup by adding the Key associated with the GalleryItem to the GalleryItemGroup's ItemKeys collection.
When used within the XamRibbon control, the GalleryTool is designed to be placed on a MenuTool. An exception will be thrown by the XamRibbon if a GalleryTool is placed anywhere other than a MenuTool.
Note: There are no such restrictions when using the GalleryTool outside the XamRibbon.
To display a GalleryTool in a RibbonGroup with preview you should:
Examples of how a GalleryTool might be used in an application include displaying a list of graphics showing the different text styles that would result if particular document styles are selected, or graphics that show thumbnails of different chart renderings that would result if a particular chart type is selected from the GalleryTool.
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) galleryTool.Groups.Clear() galleryTool.Items.Clear() Dim group As New GalleryItemGroup() group.Title = "Group" galleryTool.Groups.Add(group) 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) group.ItemKeys.Add(item.Key) Next End Sub End Class End Namespace
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); galleryTool.Groups.Clear(); galleryTool.Items.Clear(); GalleryItemGroup group = new GalleryItemGroup(); group.Title = "Group"; galleryTool.Groups.Add(group); 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); group.ItemKeys.Add(item.Key); } } } }
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