Cloned イベント (MaskedEditorTool)

ツールがクローンされた後に発生します。

シンタックス

Visual Basic

'宣言
 
Public Event Cloned As EventHandler(Of ToolClonedEventArgs)

C#

public event EventHandler<ToolClonedEventArgs> Cloned

イベント データ

イベント ハンドラが、このイベントに関連するデータを含む、ToolClonedEventArgs 型の引数を受け取りました。次の ToolClonedEventArgs プロパティには、このイベントの固有の情報が記載されます。

プロパティ	解説
ClonedTool	クローンされたツール インスタンスを返します（読み取り専用）
EventHandlersAttached	のイベントの送られたイベント ハンドラーが OriginalTool 用の同じイベントに関連付けられているかどうかを示すブール値を返します。
Handled 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 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	クローンされたツール インスタンスを返します（読み取り専用）
RoutedEvent System.Windows.RoutedEventArgsから継承されます。	Gets or sets the System.Windows.RoutedEventArgs.RoutedEvent associated with this System.Windows.RoutedEventArgs instance.
Source System.Windows.RoutedEventArgsから継承されます。	Gets or sets a reference to the object that raised the event.

解説

XamRibbon で追加位置に配置することを有効にするためにツールのクローンが作成される時に発生されます。たとえば、ツールが QuickAccessToolbar に追加されると、XamRibbon はリボン上に表示されるツールのインスタンスのクローンを作成して、QAT 上にクローンが作成されたインスタンスを配置します。このイベントは、クローン作成が行われた後で発生し、クローンが作成されたツールでイベントのためのイベント リスナーをフックする便利な点です。

使用例

Visual Basic

' 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

C#

// 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");
}