Settings プロパティ

GalleryItem に使用される設定を取得または設定します。

シンタックス

Visual Basic

'宣言
 
Public Property Settings As GalleryItemSettings

C#

public GalleryItemSettings Settings {get; set;}

解説

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

• GalleryItemGroup.ItemSettings プロパティを介して GalleryItemGroup レベルで。そこで指定された値は、GalleryTool レベルで設定された対応する値をオーバーライドしますが、GalleryItem レベルでさらにオーバーライドすることも可能です（次の項を参照してください）。
• Settings プロパティを介して GalleryItem レベルで。ここで指定された値は、GalleryItemGroup レベルと 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 setting As New GalleryItemSettings()
            setting.TextDisplayMode = GalleryItemTextDisplayMode.Always
           
            Dim item As New GalleryItem()
            item.Key = "Item1"
            item.Text = "First Item"
            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

C#

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;

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

			.....
            galleryTool.Items.Add(item);
        }
    }
}

XAML

<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="First Item" Image="\Images\ig_office_icon_16.png">
                            <!-- set only one item setting -->
                            <igRibbon:GalleryItem.Settings>
                                <igRibbon:GalleryItemSettings TextDisplayMode="Always" TextPlacement="AboveImage" 
                                                              HorizontalTextAlignment="Center" VerticalTextAlignment="Top"
                                                              SelectionDisplayMode="HighlightEntireItem"/>
                            </igRibbon:GalleryItem.Settings>
                        </igRibbon:GalleryItem>
                        
                        <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>