MouseBinding 類別

定義

命名空間:

System.Windows.Input

組件:

PresentationCore.dll

將 a MouseGesture 綁定到 a RoutedCommand （或其他 ICommand 實作）。

public ref class MouseBinding : System::Windows::Input::InputBinding

public class MouseBinding : System.Windows.Input.InputBinding

type MouseBinding = class
    inherit InputBinding

Public Class MouseBinding
Inherits InputBinding

繼承

Object

DispatcherObject

DependencyObject

Freezable

InputBinding

MouseBinding

範例

以下範例展示了如何使用 a MouseBinding 將 a MouseGesture 綁定到 RoutedCommand。

<MouseBinding Gesture="Control+WheelClick"
              Command="ApplicationCommands.Open" />

MouseGesture OpenCmdMouseGesture = new MouseGesture();
OpenCmdMouseGesture.MouseAction = MouseAction.WheelClick;
OpenCmdMouseGesture.Modifiers = ModifierKeys.Control;

MouseBinding OpenCmdMouseBinding = new MouseBinding();
OpenCmdMouseBinding.Gesture = OpenCmdMouseGesture;
OpenCmdMouseBinding.Command = ApplicationCommands.Open;

this.InputBindings.Add(OpenCmdMouseBinding);

Dim OpenCmdMouseGesture As New MouseGesture()
OpenCmdMouseGesture.MouseAction = MouseAction.WheelClick
OpenCmdMouseGesture.Modifiers = ModifierKeys.Control

Dim OpenCmdMouseBinding As New MouseBinding()
OpenCmdMouseBinding.Gesture = OpenCmdMouseGesture
OpenCmdMouseBinding.Command = ApplicationCommands.Open

Me.InputBindings.Add(OpenCmdMouseBinding)

備註

A MouseBinding 將 a MouseGesture 與實 ICommand 作關聯起來。 RoutedCommand 是 WPF 指令系統介面的主要實作 ICommand 。 一般來說，當執行 時MouseGesture，指令會被呼叫，但指令行為會進一步受到命令特定的因素影響，例如值。CanExecute 欲了解更多指揮相關資訊，請參閱 指揮概述。

在可擴充應用程式標記語言（XAML）中定義 時MouseBinding，有兩種方式可以指定 。MouseGesture 在 XAML 中建立 的 MouseBinding 第一個方法是定義 Gesture 元素的 MouseBinding 屬性，使語法能將滑鼠動作與修飾符指定為單一字串;例如「CTRL+LeftClick」。 第二種方法是定義 MouseAction 元素的 MouseBinding 屬性。 兩種設定 MouseGesture 方式是等價的，且修改的是同一底層物件，但若兩者同時使用會產生衝突。 當屬性 MouseActionGesture 和 都被設定時，該手勢無效。 一般建議僅 Gesture 使用 XAML 的屬性，即使未指定修飾符;這樣避免歧義，語法最流暢，序列化表現最直接。

A MouseBinding 可以在特定物件上定義，或在類別層級透過在類別上註冊 a RegisterClassInputBindingCommandManager 來定義。 定義 a MouseBinding 最常見的方式是在控制範本中，透過宣告一個或多個MouseBindingKeyBinding元素來設定InputBindings屬性。

建構函式

名稱	Description
MouseBinding()	初始化 MouseBinding 類別的新執行個體。
MouseBinding(ICommand, MouseGesture)	使用指定的指令與滑鼠手勢初始化該 MouseBinding 類別的新實例。

欄位

名稱	Description
MouseActionProperty	識別 MouseAction 依賴性質。

屬性

名稱	Description
CanFreeze	會得到一個值，表示該物件是否能被設定為不可修改。 (繼承來源 Freezable)
Command	取得或設定與此輸入綁定相關的 。ICommand (繼承來源 InputBinding)
CommandParameter	取得或設定特定指令的指令資料。 (繼承來源 InputBinding)
CommandTarget	取得或設定指令的目標元素。 (繼承來源 InputBinding)
DependencyObjectType	會取得 DependencyObjectType 包裹此實例 CLR 類型的 。 (繼承來源 DependencyObject)
Dispatcher	了解 Dispatcher 這與此 DispatcherObject 有關。 (繼承來源 DispatcherObject)
Gesture	取得或設定與此 MouseBinding關聯的手勢。
IsFrozen	會得到一個值，表示該物件目前是否可修改。 (繼承來源 Freezable)
IsSealed	會獲得一個值，表示該實例目前是否封存（唯讀）。 (繼承來源 DependencyObject)
MouseAction	會得到或設定 MouseAction 與此 MouseBinding相關的 。

方法

名稱	Description
CheckAccess()	判斷呼叫執行緒是否能存取此 DispatcherObject。 (繼承來源 DispatcherObject)
ClearValue(DependencyProperty)	清算房產的當地價值。 要清除的屬性由識別 DependencyProperty 碼指定。 (繼承來源 DependencyObject)
ClearValue(DependencyPropertyKey)	清除只讀屬性的局部值。 要清除的屬性由 DependencyPropertyKey指定。 (繼承來源 DependencyObject)
Clone()	建立可修改的克隆 Freezable，產生物件值的深度複製。 當複製物件的依賴屬性時，此方法會複製表達式（可能已無法解析），但不會複製動畫或其當前值。 (繼承來源 Freezable)
CloneCore(Freezable)	複製指定物件屬性的基礎（非動畫）值。
CloneCurrentValue()	使用目前的值建立可修改的複製品（深度複製）。Freezable (繼承來源 Freezable)
CloneCurrentValueCore(Freezable)	複製指定物件屬性的當前值。
CoerceValue(DependencyProperty)	強制設定指定的依賴性質值。 這是透過在屬性CoerceValueCallback中指定的依賴屬性元資料中，呼叫 的依賴屬性中的任何DependencyObject函式來達成的。 (繼承來源 DependencyObject)
CreateInstance()	初始化 Freezable 類別的新執行個體。 (繼承來源 Freezable)
CreateInstanceCore()	會產生一個 MouseBinding的實例。
Equals(Object)	判斷所給的 DependencyObject 是否等同於電流 DependencyObject。 (繼承來源 DependencyObject)
Freeze()	使目前物件無法修改，並將其 IsFrozen 屬性設為 true。 (繼承來源 Freezable)
FreezeCore(Boolean)	使 Freezable 物件無法被修改，或測試是否能被修改。 (繼承來源 Freezable)
GetAsFrozen()	使用基礎（非動畫）屬性值建立一個凍結的 Freezable。 由於複製是凍結的，任何凍結的子物件都會透過參考被複製。 (繼承來源 Freezable)
GetAsFrozenCore(Freezable)	透過使用基礎（非動畫）屬性值，建立指定的凍結克隆 Freezable 實例。
GetCurrentValueAsFrozen()	用目前屬性值建立一個凍結的副本 Freezable 。 由於複製是凍結的，任何凍結的子物件都會透過參考被複製。 (繼承來源 Freezable)
GetCurrentValueAsFrozenCore(Freezable)	建立當前實例，作為指定 Freezable的凍結克隆。 如果物件有動畫相依屬性，則會複製其目前的動畫值。
GetHashCode()	會得到一個 DependencyObject雜湊碼。 (繼承來源 DependencyObject)
GetLocalValueEnumerator()	建立專門的枚舉器，用以判斷哪些相依屬性在局部 DependencyObject設定值。 (繼承來源 DependencyObject)
GetValue(DependencyProperty)	回傳此實例 DependencyObject上依賴屬性的當前有效值。 (繼承來源 DependencyObject)
InvalidateProperty(DependencyProperty)	重新評估指定相依性質的有效值。 (繼承來源 DependencyObject)
OnChanged()	當當前 Freezable 物件被修改時呼叫。 (繼承來源 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	此成員支援 Windows Presentation Foundation（WPF）基礎架構，並非直接從您的程式碼中使用。 (繼承來源 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	確保剛設定的資料成員建立 DependencyObjectType 適當的上下文指標。 (繼承來源 Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	覆DependencyObject寫 的OnPropertyChanged(DependencyPropertyChangedEventArgs)實作，也在回應類型中變動的依賴屬性Freezable時呼叫任何Changed處理器。 (繼承來源 Freezable)
ReadLocalValue(DependencyProperty)	回傳依賴屬性的局部值（若存在）。 (繼承來源 DependencyObject)
ReadPreamble()	確保存取 Freezable 的是有效的執行緒。 繼 Freezable 承者必須在任何讀取非相依屬性資料成員的資料 API 開頭呼叫此方法。 (繼承來源 Freezable)
SetCurrentValue(DependencyProperty, Object)	設定依賴屬性的值，且不改變其值來源。 (繼承來源 DependencyObject)
SetValue(DependencyProperty, Object)	設定依賴屬性的局部值，並由其依賴屬性識別碼指定。 (繼承來源 DependencyObject)
SetValue(DependencyPropertyKey, Object)	設定只讀相依屬性的本地值，該值由 DependencyPropertyKey 相依屬性的識別碼指定。 (繼承來源 DependencyObject)
ShouldSerializeProperty(DependencyProperty)	回傳一個值，指示序列化程序是否應該將所提供的相依屬性的值序列化。 (繼承來源 DependencyObject)
VerifyAccess()	強制呼叫執行緒能存取此 DispatcherObject。 (繼承來源 DispatcherObject)
WritePostscript()	提升 Changed 事件並 Freezable 調用其 OnChanged() 方法。 衍生於 的 Freezable 類別應在任何修改未儲存為相依屬性的類別成員的 API 結尾呼叫此方法。 (繼承來源 Freezable)
WritePreamble()	驗證 未 Freezable 被凍結，且存取時正從有效的執行緒上下文中存取。 Freezable 繼承者應在任何寫入非相依屬性資料成員的 API 開頭呼叫此方法。 (繼承來源 Freezable)

事件

名稱	Description
Changed	當 Freezable 它所包含的物件被修改時，會發生這種情況。 (繼承來源 Freezable)

另請參閱

• MouseGesture
• KeyBinding
• CommandBinding
• RoutedCommand