Version

Cloned Event (MaskedEditorTool)

Occurs after a tool has been cloned.
Syntax
'Declaration
 
Public Event Cloned As EventHandler(Of ToolClonedEventArgs)
public event EventHandler<ToolClonedEventArgs> Cloned
Event Data

The event handler receives an argument of type ToolClonedEventArgs containing data related to this event. The following ToolClonedEventArgs properties provide information specific to this event.

PropertyDescription
ClonedTool Returns the cloned tool instance (read-only)
EventHandlersAttached Returns a boolean indicating if the event handlers for routed events of the OriginalTool were associated with the same events for the ClonedTool
Handled (Inherited from System.Windows.RoutedEventArgs)Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route.
OriginalSource (Inherited from System.Windows.RoutedEventArgs)Gets the original reporting source as determined by pure hit testing, before any possible System.Windows.RoutedEventArgs.Source adjustment by a parent class.
OriginalTool Returns the cloned tool instance (read-only)
RoutedEvent (Inherited from System.Windows.RoutedEventArgs)Gets or sets the System.Windows.RoutedEventArgs.RoutedEvent associated with this System.Windows.RoutedEventArgs instance.
Source (Inherited from System.Windows.RoutedEventArgs)Gets or sets a reference to the object that raised the event.
Remarks

Fired when a tool is cloned to enable its placement in an additional location in the XamRibbon. For example, when a tool is added to the QuickAccessToolbar, the XamRibbon clones the instance of the tool that appears on the Ribbon and places the cloned instance on the QAT. This event is fired after the cloning takes place and is a convenient point hook up event listeners for events on the cloned tool.

Example
MaskedEditorTool Cloned event

For an overview of how to handle events in Visual Basic or Visual C#, see Event Handlers in Visual Basic and Visual C#. For specific information and code examples illustrating how to consume events in your application, see Consuming Events in the .NET Framework Developer's Guide.

' Create MaskedEditorTool 
Dim maskedEditorTool As New MaskedEditorTool() 
maskedEditorTool.Id = "maskedEditor" 

AddHandler maskedEditorTool.Cloned, AddressOf maskedEditorTool_Cloned 

' This will raise Cloned event 
xamRibbon.QuickAccessToolbar.Items.Add(New QatPlaceholderTool("maskedEditor", QatPlaceholderToolType.Tool)) 
toolHorizontalWrapPanel.Children.Add(maskedEditorTool) 
...

Private Sub maskedEditorTool_Cloned(ByVal sender As Object, ByVal e As Infragistics.Windows.Ribbon.Events.ToolClonedEventArgs) 
    Dim maskedEditorTool As TextEditorTool = TryCast(e.ClonedTool, TextEditorTool) 
    Debug.Write(sender.ToString() + " Cloned") 
End Sub
// Create MaskedEditorTool
MaskedEditorTool maskedEditorTool = new MaskedEditorTool();
maskedEditorTool.Id = "maskedEditor";

// Add EventHandler
maskedEditorTool.Cloned += new EventHandler<Infragistics.Windows.Ribbon.Events.ToolClonedEventArgs>(maskedEditorTool_Cloned);

// This will raise Cloned event
xamRibbon.QuickAccessToolbar.Items.Add(new QatPlaceholderTool("maskedEditor", QatPlaceholderToolType.Tool));
toolHorizontalWrapPanel.Children.Add(maskedEditorTool);
...

void maskedEditorTool_Cloned(object sender, Infragistics.Windows.Ribbon.Events.ToolClonedEventArgs e)
{
    TextEditorTool maskedEditorTool = e.ClonedTool as TextEditorTool;
    Debug.Write(sender.ToString() + " Cloned");
}
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

See Also