Control.PreviewMouseDoubleClick 事件

定義

命名空間:

System.Windows.Controls

組件:

PresentationFramework.dll

使用者按滑鼠按鈕超過兩下時發生。

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 事件將會 Handled 設定為 false ，但 MouseDoubleClick 事件會以 設定 true 為 發生 Handled 。 PreviewMouseDoubleClick 這是較高層級事件，適用于想要在使用者按兩下控制項並處理應用程式中事件的控制項取用者。

當 等於 2 時 ClickCount ，控制想要處理滑鼠按兩下的作者應該使用 PreviewMouseLeftButtonDown 事件。 當專案樹狀結構中的另一個專案處理事件時，這會導致 的狀態 Handled 適當地傳播。

類別 Control 會 PreviewMouseDoubleClick 定義 和 MouseDoubleClick 事件，但不會定義對應的單鍵事件。 若要查看使用者是否已按一下控制項一次，請處理 MouseDown 事件 (或其對應的其中一個) ，並檢查屬性值是否 ClickCount 為 1。

路由事件資訊

識別碼欄位	PreviewMouseDoubleClickEvent
路由策略	直接
代理人	MouseButtonEventHandler