QatPlaceholderTool クラス

QuickAccessToolbar に配置されたツールまたは RibbonGroup インスタンスを表すために使用されるプレースホルダ。このツールは QuickAccessToolbar で使用することのみを目的とします。TargetType プロパティは、TargetId がツールまたは RibbonGroup を表すかどうかを決定します。

シンタックス

Visual Basic

'宣言
 
Public Class QatPlaceholderTool 
   Inherits System.Windows.FrameworkElement

C#

public class QatPlaceholderTool : System.Windows.FrameworkElement 

使用例

Visual Basic

' Creating ButtonTool 
Dim btnToolCopy As New ButtonTool() 
btnToolCopy.Id = "copyTool" 
AddHandler btnToolCopy.Click, AddressOf btnToolCopy_Click 

' Adding ButtonTool to the QAT 
Dim qatToolCopy As New QatPlaceholderTool() 
qatToolCopy.TargetId = "copyTool" ' btnToolCopy.Id 
qatToolCopy.TargetType = QatPlaceholderToolType.Tool 
xamRibbon.QuickAccessToolbar.Items.Add(qatToolCopy) 
...
Private Sub btnToolCopy_Click(ByVal sender As Object, ByVal e As RoutedEventArgs) 
    Dim btnTool As ButtonTool = TryCast(sender, ButtonTool) 
    Dim qatTool As QatPlaceholderTool = TryCast(btnTool.Parent, QatPlaceholderTool) 
    
    If qatTool Is Nothing Then 
        Debug.Write("The tool is not on the QuickAccessToolbar") 
    Else 
        Debug.Write("QatPlaceholderTool.ToString(): " + qatTool.ToString()) 
    End If 
End Sub

C#

// Creating ButtonTool
ButtonTool btnToolCopy = new ButtonTool();
btnToolCopy.Id = "copyTool";
btnToolCopy.Click += new RoutedEventHandler(btnToolCopy_Click);

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

void btnToolCopy_Click(object sender, RoutedEventArgs e)
{
    ButtonTool btnTool = sender as ButtonTool;
    QatPlaceholderTool qatTool = btnTool.Parent as QatPlaceholderTool;

    if (qatTool == null)
        Debug.Write("The tool is not on the QuickAccessToolbar");
    else
        Debug.Write("QatPlaceholderTool.ToString(): "+qatTool.ToString());
}