Control.PreviewMouseDoubleClick イベント

定義

ユーザーがマウス ボタンを 2 回以上クリックしたときに発生します。

public:
 event System::Windows::Input::MouseButtonEventHandler ^ PreviewMouseDoubleClick;
public event System.Windows.Input.MouseButtonEventHandler PreviewMouseDoubleClick;
member this.PreviewMouseDoubleClick : System.Windows.Input.MouseButtonEventHandler 
Public Custom Event PreviewMouseDoubleClick As MouseButtonEventHandler 

イベントの種類

MouseButtonEventHandler

イベントハンドラーをアタッチする方法を次の例に示し PreviewMouseDoubleClick ます。

<Button Name="btn1" Foreground="Black" 
        PreviewMouseDoubleClick="ChangeForeground">
  Foreground
</Button>

次の例は、イベントのイベントハンドラーを示して PreviewMouseDoubleClick います。

void ChangeForeground(object sender, RoutedEventArgs e)
{
    if (btn1.Foreground == Brushes.Green)
    {
        btn1.Foreground = Brushes.Black;
        btn1.Content = "Foreground";
    }
    else
    {
        btn1.Foreground = Brushes.Green;
        btn1.Content = "Control foreground(text) changes from black to green.";
    }
}
Private Sub ChangeForeground(ByVal Sender As Object, ByVal e As System.Windows.Input.MouseButtonEventArgs)

    If (btn1.Foreground Is Brushes.Green) Then
        btn1.Foreground = Brushes.Black
        btn1.Content = "Foreground"
    Else
        btn1.Foreground = Brushes.Green
        btn1.Content = "Control foreground(text) changes from black to green."
    End If

End Sub

注釈

このルーティングイベントは、要素ツリーを通じてトンネリングルートに従っているように見えますが、実際には、各によって要素ツリーに沿って発生する直接ルーティングイベントです UIElement 。 イベントハンドラーでプロパティをに設定すると、に設定されたを使用して、 Handled true PreviewMouseDoubleClick ルートの後続のイベントが発生しますが、イベントは、が PreviewMouseDoubleClick Handled false MouseDoubleClick に設定された状態で発生し Handled true ます。 これは、ユーザーがコントロールをダブルクリックしてアプリケーションでイベントを処理するときに通知を受け取るコントロールコンシューマーに対して、上位レベルのイベントです。

マウスのダブルクリックを処理するコントロールの作成者は、 PreviewMouseLeftButtonDown ClickCount が2に等しい場合にイベントを使用する必要があります。 これにより、 Handled 要素ツリー内の別の要素がイベントを処理する場合に、の状態が適切に反映されます。

クラスは、 Control PreviewMouseDoubleClick イベントと MouseDoubleClick イベントを定義しますが、対応するシングルクリックイベントは定義しません。 ユーザーがコントロールを1回クリックしたかどうかを確認するには、 MouseDown イベント (または対応するものの1つ) を処理し、プロパティ値が1であるかどうかを確認し ClickCount ます。

ルーティングされたイベント情報

識別子フィールド PreviewMouseDoubleClickEvent
ルーティング方法 直接
代理人 MouseButtonEventHandler

適用対象