TargetId プロパティ

ツールの文字列 RibbonToolHelper.IdProperty または TargetType プロパティに基づいてこの QatPlaceholderTool に関連付けられた RibbonGroup を取得または設定します。

シンタックス

Visual Basic

'宣言
 
Public Property TargetId As String

C#

public string TargetId {get; set;}

解説

TargetType プロパティの値に基づき、このプロパティをツールの RibbonToolHelper.IdProperty または XamRibbon のどこかに定義された RibbonGroup に設定すると、そのオブジェクトのクローンがこの QatPlaceholderTool 内に作成および表示されます。

ツールはエンド ユーザー（各ツールに提供されるコンテキスト メニューを右クリックして）または開発者（ツールの ID を参照する QatPlaceholderTool を追加することで）によって QuickAccessToolbar に追加できます。RibbonGroups は、RibbonTabItem で RibbonGroup のキャプションを右クリックしてエンド ユーザーによって QuickAccessToolbar に追加できます。

使用例

Visual Basic

' Creating ButtonTool
Dim btnToolCopy As New ButtonTool()
 btnToolCopy.Id = "copyTool"

' Adding ButtonTool to the QAT
Dim qatToolCopy As New QatPlaceholderTool()
qatToolCopy.TargetId = "copyTool"
' btnToolCopy.Id
qatToolCopy.TargetType = QatPlaceholderToolType.Tool
xamRibbon.QuickAccessToolbar.Items.Add(qatToolCopy)

C#

// Creating ButtonTool
ButtonTool btnToolCopy = new ButtonTool();
btnToolCopy.Id = "copyTool";

// Adding ButtonTool to the QAT
QatPlaceholderTool qatToolCopy = new QatPlaceholderTool();
qatToolCopy.TargetId = "copyTool"; // btnToolCopy.Id
qatToolCopy.TargetType = QatPlaceholderToolType.Tool;
xamRibbon.QuickAccessToolbar.Items.Add(qatToolCopy);

XAML

<igRibbon:XamRibbon.QuickAccessToolbar>
    <igRibbon:QuickAccessToolbar>
        <igRibbon:QatPlaceholderTool TargetId="undoTool" TargetType="Tool"></igRibbon:QatPlaceholderTool>
        <igRibbon:QatPlaceholderTool TargetId="redoTool"></igRibbon:QatPlaceholderTool>
        <igRibbon:QatPlaceholderTool TargetId="copyTool"></igRibbon:QatPlaceholderTool>
        <igRibbon:QatPlaceholderTool TargetId="cutTool" ></igRibbon:QatPlaceholderTool>
        <igRibbon:QatPlaceholderTool TargetId="Text Style" TargetType="RibbonGroup"></igRibbon:QatPlaceholderTool>
    </igRibbon:QuickAccessToolbar>
</igRibbon:XamRibbon.QuickAccessToolbar>