バージョン

GalleryItemSettings クラス

GalleryItem に適用される設定を含みます。GalleryItemSettings は、すべての GalleryItem に対してデフォルトとして機能するようにその GalleryTool.ItemSettings プロパティを介して GalleryItem で、または Settings プロパティで直接設定できます。
シンタックス
'宣言
 
Public Class GalleryItemSettings 
   Inherits Infragistics.DependencyObjectNotifier
public class GalleryItemSettings : Infragistics.DependencyObjectNotifier
解説

GalleryTool レベルで指定された（GalleryTool.ItemSettings プロパティを介して） GalleryItemSettings 内のさまざまなプロパティ値は、すべての 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.SelectionDisplayMode = GalleryItemSelectionDisplayMode.HighlightEntireItem
			setting.HorizontalTextAlignment = TextAlignment.Center
			setting.VerticalTextAlignment = VerticalAlignment.Top

			....

			Dim item As New GalleryItem()
			item.Key = "Item10
			item.Text = "Item10"
			item.Image = New BitmapImage(New Uri("\Images\ig_office_icon_16.png", UriKind.Relative))
			item.Tag = "myTag"
			item.Settings = settings
			galleryTool.Items.Add(item)

			.....

		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.SelectionDisplayMode = GalleryItemSelectionDisplayMode.HighlightEntireItem;
            setting.HorizontalTextAlignment = TextAlignment.Center;
            setting.VerticalTextAlignment = VerticalAlignment.Top;

            GalleryItem item = new GalleryItem();
            item.Key = "Item10";
            item.Text = "Item10";
            item.Image = new BitmapImage(new Uri("\\Images\\ig_office_icon_16.png", UriKind.Relative));
            item.Tag = "myTag";
            item.Settings = settings;

            galleryTool.Items.Add(item);
        }
    }
}
<igRibbon:XamRibbonWindow x:Class="MyWindow"
    xmlns:igRibbon="http://infragistics.com/Ribbon"
    xmlns:s="clr-namespace:System;assembly=mscorlib">

  ....

    <igRibbon:RibbonGroup Id="groupId" Caption="Group">
        <igRibbon:MenuTool ShouldDisplayGalleryPreview="True" Caption="GalleryToolMenu">
            <igRibbon:GalleryTool Name="galleryToolItems" >
                <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" ColumnSpan="3"/>
                    <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" Tag="myTag"/>
                    <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" IsSelected="True"/>
                    
                    <!-- set only one item setting -->
                    <igRibbon:GalleryItem Key="Item10" Text="Item10" Image="\Images\ig_office_icon_16.png">
                        <igRibbon:GalleryItem.Settings>
                            <igRibbon:GalleryItemSettings 
                                TextDisplayMode="Always" 
                                TextPlacement="AboveImage" 
                                HorizontalTextAlignment="Center"
                                VerticalTextAlignment="Top"
                                SelectionDisplayMode="HighlightEntireItem"/>
                        </igRibbon:GalleryItem.Settings>
                    </igRibbon:GalleryItem>
                    
                    <igRibbon:GalleryItem Key="Item11" Text="Item11" Image="\Images\ig_office_icon_16.png"/>
                </igRibbon:GalleryTool.Items>
            </igRibbon:GalleryTool>
        </igRibbon:MenuTool>
    </igRibbon:RibbonGroup> 

  ....

</igRibbon:XamRibbonWindow>
参照