Cloned イベント (TextEditorTool)

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

シンタックス

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 TextEditorTool 
Dim textEditorTool As New TextEditorTool() 
textEditorTool.Id = "textEditor" 

AddHandler textEditorTool.Cloned, AddressOf textEditorTool_Cloned 

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

Private Sub textEditorTool_Cloned(ByVal sender As Object, ByVal e As Infragistics.Windows.Ribbon.Events.ToolClonedEventArgs) 
    Dim textEditorTool As TextEditorTool = TryCast(e.ClonedTool, TextEditorTool) 
    Debug.Write(sender.ToString() + " Cloned") 
End Sub

C#

// Create TextEditorTool
TextEditorTool textEditorTool = new TextEditorTool();
textEditorTool.Id = "textEditor";

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

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

void textEditorTool_Cloned(object sender, Infragistics.Windows.Ribbon.Events.ToolClonedEventArgs e)
{
    TextEditorTool textEditorTool = e.ClonedTool as TextEditorTool;
    Debug.Write(sender.ToString() + " Cloned");
}