バージョン

GalleryTool クラス

GalleryTool は、オプションを視覚的に説明する画像とオプションのテキスト説明が含まれるオプション リストを表示するために設計されます。
シンタックス
'宣言
 
Public Class GalleryTool 
   Inherits System.Windows.Controls.Control
public class GalleryTool : System.Windows.Controls.Control
解説

GalleryTool は GalleryItem オブジェクトのコレクションを保持する Items プロパティを公開します。各 GalleryItem は、各項目に表示される Text および Image プロパティを公開します。GalleryTool は GalleryTool ドロップダウンに表示される時に GalleryItem のグループ化を定義する GalleryItemGroup オブジェクトのコレクションを保持する Groups プロパティも公開します。GalleryItem は 1 つ以上の GalleryItemGroup に属することができ、GalleryItemGroup の ItemKeys コレクションに GalleryItem と関連付けられたキーを追加することで GalleryItemGroup に指定されます。

XamRibbon コントロール内で使用される場合、GalleryTool は MenuTool に配置されるように設計されます。GalleryTool が MenuTool 以外の任意の場所に配置される場合、例外が XamRibbon によってスローされます。

注: XamRibbon の外で GalleryTool を使用する場合はそのような制限はありません。

プレビューで RibbonGroup の GalleryTool を表示するには、以下を行います：

GalleryTool プレビューが前述のように RibbonGroup に表示される場合、GalleryItemGroup は表示されず、GalleryItem だけが表示されます。さらに、上下にスクロールするボタンが自動的に提供され、エンド ユーザーは必要に応じて GalleryItem でスクロールできます。また、スクロール ボタンの下にドロップダウンボタンを提供します。クリックされたときに、MenuTool のコンテンツ (GalleryItem、GalleryItemGroup および MenuTool に追加されたその他のツール) をドロップします。

GalleryTool がアプリケーションでどのように使用されるかの事例には、特定のドキュメント スタイルが選択された場合の結果として異なるテキスト スタイルを表示する画像のリスト表示、または特定のチャート タイプが 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);
            }
        }
    }
}
<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>
          </igRibbon:GalleryItemGroup>
          <igRibbon:GalleryItemGroup Title="Group2">
            <s:String>Item4</s:String>
            <s:String>Item5</s:String>
            <s:String>Item6</s:String>
          </igRibbon:GalleryItemGroup>
          <igRibbon:GalleryItemGroup Title="Group3">
            <s:String>Item7</s:String>
            <s:String>Item8</s:String>
            <s:String>Item9</s:String>
            <s:String>Item10</s:String>
            <s:String>Item11</s:String>
          </igRibbon:GalleryItemGroup>
          <igRibbon:GalleryItemGroup Title="Group4">
            <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>
            <s:String>Item11</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:GalleryItem Key="Item11" Text="Item11" Image="\Images\ig_office_icon_16.png"/>
        </igRibbon:GalleryTool.Items>
      </igRibbon:GalleryTool>
    </igRibbon:MenuTool>

  </igRibbon:RibbonGroup>

  ....

</igRibbon:XamRibbonWindow>
参照