バージョン

ItemSettings プロパティ (GalleryItemGroup)

この GalleryItemGroup のすべての GalleryItem に対してデフォルト設定として機能する設定を返す/設定します。
シンタックス
'宣言
 
Public Property ItemSettings As GalleryItemSettings
public GalleryItemSettings ItemSettings {get; set;}
解説

GalleryTool レベルで指定された GalleryItemSettings ( GalleryTool.ItemSettings プロパティを介して) 内のさまざまなプロパティ値は、すべての GalleryItem の最終的なデフォルト設定として機能します。これらの値は以下の 2 つの低いレベルでオーバーライドされる場合があります。

  • ItemSettings プロパティを介して GalleryItemGroup レベルで。そこで指定された値は、GalleryTool レベルで設定された対応する値をオーバーライドしますが、GalleryItem レベルでさらにオーバーライドすることも可能です（次の項を参照してください）。
  • Settings プロパティを介して GalleryItem レベルで。ここで指定された値は、GalleryItemGroup レベルと 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 setting As New GalleryItemSettings()
           setting.TextDisplayMode = GalleryItemTextDisplayMode.Always
           setting.TextPlacement = TextPlacement.AboveImage
           setting.HorizontalTextAlignment = TextAlignment.Center
           setting.VerticalTextAlignment = VerticalAlignment.Top
           setting.SelectionDisplayMode = GalleryItemSelectionDisplayMode.HighlightEntireItem
           
            Dim group As New GalleryItemGroup()
            group.Title = "Group"
            group.ItemSettings = setting
           
            galleryTool.Groups.Add(group)
            For ind As Integer = 1 To 3
               
                Dim item As New GalleryItem()
                item.Key = "Item" + ind.ToString()
                item.Text = "Item" + ind.ToString()
                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()
        {
            GalleryItemSettings setting = new GalleryItemSettings();
            setting.TextDisplayMode = GalleryItemTextDisplayMode.Always;
            setting.TextPlacement = TextPlacement.AboveImage;
            setting.HorizontalTextAlignment = TextAlignment.Center;
            setting.VerticalTextAlignment = VerticalAlignment.Top;
            setting.SelectionDisplayMode = GalleryItemSelectionDisplayMode.HighlightEntireItem;

            GalleryItemGroup group = new GalleryItemGroup();
            group.Title = "Group";
            group.ItemSettings = setting;

            galleryTool.Groups.Add(group);

            for (int ind = 1; ind <= 3; ind++)
            {
                GalleryItem item = new GalleryItem();
                item.Key = "Item" + ind.ToString();
                item.Text = "Item" + ind.ToString();
                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">
                                    <igRibbon:GalleryTool.Groups>
                                        <igRibbon:GalleryItemGroup Title="Group1">
                                            <igRibbon:GalleryItemGroup.ItemSettings>
                                                <igRibbon:GalleryItemSettings 
                                                    TextDisplayMode="Always" 
                                                    TextPlacement="AboveImage" 
                                                    HorizontalTextAlignment="Center" 
                                                    VerticalTextAlignment="Top"
                                                    SelectionDisplayMode="HighlightEntireItem"/>
                                            </igRibbon:GalleryItemGroup.ItemSettings>
                                            <s:String>Item1</s:String>
                                            <s:String>Item2</s:String>
                                            <s:String>Item3</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:GalleryTool.Items>
      </igRibbon:GalleryTool>
    </igRibbon:MenuTool>

  </igRibbon:RibbonGroup>

  ....

</igRibbon:XamRibbonWindow>
参照