GalleryTool クラス

GalleryTool は、オプションを視覚的に説明する画像とオプションのテキスト説明が含まれるオプションリストを表示するために設計されます。

シンタックス

Visual Basic
C#

'宣言
 
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 を表示するには、以下を行います：

MenuTool を作成して RibbonGroup に追加します。
GalleryTool を作成して、それぞれにひとつ以上の GalleryItem がある、ひとつ以上の GalleryItemGroup を追加します。
GalleryTool および MenuTool の MenuTool の Items コレクションに追加します。必要に応じてメニューに他のツールも追加できます。
MenuTool の MenuTool.ShouldDisplayGalleryPreview プロパティを True に設定します。通常は MenuTool のドロップダウンボタンを表示する領域に GalleryItem のスクロール可能なプレビューを表示します。

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

GalleryTool がアプリケーションでどのように使用されるかの事例には、特定のドキュメントスタイルが選択された場合の結果として異なるテキストスタイルを表示する画像のリスト表示、または特定のチャートタイプが GalleryTool から選択された場合の結果として異なるチャート描画のサムネイルを表示する画像が挙げられます。

使用例

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)
           
             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);
            }
        }
    }
}

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>
          </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>

参照

GalleryTool メンバ
 Infragistics.Windows.Ribbon 名前空間
 XamRibbon クラス
 MenuTool クラス
 ShouldDisplayGalleryPreview プロパティ
 RibbonGroup クラス
 GalleryItem クラス
 GalleryItemGroup クラス
 QuickAccessToolbar クラス

WPF | ヘルプ トピック

GalleryTool クラス

参照

WPF | ヘルプトピック