Target Property

Returns the tool or RibbonGroup instance associated with this QatPlaceholderTool. (read-only)

Syntax

Visual Basic

'Declaration
 
Public ReadOnly Property Target As FrameworkElement

C#

public FrameworkElement Target {get;}

Remarks

To change the target associated with this QatPlaceholderTool set the TargetId property.

Example

QatPlaceholderTool Target property

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("qatTool.Target: " + qatTool.Target) 
    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("qatTool.Target: "+qatTool.Target);
}

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2