ItemSettings プロパティ (GalleryTool)

すべての GalleryItem のデフォルトとして使用される設定を取得または設定します。これらの設定は低いレベルでオーバーライド可能です。

シンタックス

Visual Basic

'宣言
 
Public Property ItemSettings As GalleryItemSettings

C#

public GalleryItemSettings ItemSettings {get; set;}

解説

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

• ItemSettings プロパティを介して GalleryItemGroup レベルで。そこで指定された値は、GalleryTool レベルで設定された対応する値をオーバーライドしますが、GalleryItem レベルでさらにオーバーライドすることも可能です（次の項を参照してください）。
• Settings プロパティを介して GalleryItem レベルで。ここで指定された値は、GalleryItemGroup レベルと GalleryTool レベルで設定された対応する値をオーバーライドします。

使用例

Visual Basic

Imports System
Imports System.Windows
Imports Infragistics.Windows.Ribbon


Namespace MyNamespace
    Partial Public Class MyWindow
        Inherits XamRibbonWindow
        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub SetGalleryItemSetting()
            Dim setting As New GalleryItemSettings()
            setting.TextDisplayMode = GalleryItemTextDisplayMode.Always
            galleryTool.ItemSettings = setting
        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();
        }

        private void SetGalleryItemSetting()
        {
            GalleryItemSettings setting = new GalleryItemSettings();
            setting.TextDisplayMode = GalleryItemTextDisplayMode.Always;
            galleryTool.ItemSettings = setting;
        }
    }
}

XAML

<igRibbon:XamRibbonWindow x:Class="SnippetApp.Window1"
    xmlns:igRibbon="http://infragistics.com/Ribbon">

          ....

    <igRibbon:RibbonGroup Id="GroupId" Caption="Ribbon group">
        <igRibbon:MenuTool ShouldDisplayGalleryPreview="True" Caption="GalleryToolMenu">
            <igRibbon:GalleryTool Name="galleryTool" >
                <igRibbon:GalleryTool.ItemSettings>
                        <igRibbon:GalleryItemSettings TextDisplayMode="Always" TextPlacement="AboveImage" 
                                                      HorizontalTextAlignment="Center" VerticalTextAlignment="Top"
                                                      SelectionDisplayMode="HighlightEntireItem"/>
                </igRibbon:GalleryTool.ItemSettings>
                        
                <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"/>
                    <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>