MouseBinding Klasa

Definicja

Przestrzeń nazw:

System.Windows.Input

Zestaw:

PresentationCore.dll

Wiąże element z MouseGesture implementacją RoutedCommand (lub inną 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

Dziedziczenie

Object

DispatcherObject

DependencyObject

Freezable

InputBinding

MouseBinding

Przykłady

W poniższym przykładzie pokazano, jak użyć metody MouseBinding , aby powiązać element MouseGesture z elementem 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)

Uwagi

Element MouseBinding kojarzy element MouseGesture z implementacją ICommand . RoutedCommand jest podstawową implementacją interfejsu ICommand dla systemu poleceń WPF. Ogólnie rzecz biorąc, gdy MouseGesture polecenie jest wykonywane, polecenie jest wywoływane, chociaż zachowanie polecenia jest dodatkowo objęte czynnikami specyficznymi dla polecenia, takimi jak CanExecute wartość. Aby uzyskać więcej informacji na temat poleceń, zobacz Omówienie poleceń.

Podczas definiowania w języku MouseBinding XAML (Extensible Application Markup Language) istnieją dwa sposoby określenia elementu MouseGesture. Pierwszym sposobem ustanowienia MouseBinding elementu w języku XAML jest zdefiniowanie Gesture atrybutu MouseBinding elementu, który umożliwia składnię określania akcji myszy i modyfikatorów jako pojedynczego ciągu, na przykład "CTRL+LeftClick". Drugim sposobem jest zdefiniowanie MouseAction atrybutu MouseBinding elementu. Oba sposoby ustawiania MouseGesture są równoważne i modyfikują ten sam obiekt bazowy, ale w przypadku użycia obu wystąpi konflikt. W przypadku, gdy MouseAction atrybuty i Gesture są ustawione, gest jest nieprawidłowy. Ogólnie rzecz biorąc, zaleca się używanie tylko atrybutu Gesture z języka XAML, nawet jeśli nie określono modyfikatorów; pozwala to uniknąć niejednoznaczności, zapewnia najbardziej usprawnioną składnię i zapewnia najprostszą reprezentację serializacji.

Element MouseBinding można zdefiniować na określonym obiekcie lub na poziomie klasy, rejestrując klasę RegisterClassInputBinding w CommandManager klasie. Najbardziej typowy sposób definiowania MouseBinding elementu znajduje się w szablonie kontrolki, ustawiając InputBindings właściwość w języku XAML, deklarując co najmniej MouseBinding jeden element KeyBinding .

Konstruktory

MouseBinding()	Inicjuje nowe wystąpienie klasy MouseBinding.
MouseBinding(ICommand, MouseGesture)	Inicjuje MouseBinding nowe wystąpienie klasy przy użyciu określonego polecenia i gestu myszy.

Pola

MouseActionProperty

Identyfikuje MouseAction właściwość zależności.

Właściwości

CanFreeze	Pobiera wartość wskazującą, czy obiekt może być niemodyfikowalny. (Odziedziczone po Freezable)
Command	Pobiera lub ustawia ICommand skojarzone z tym powiązaniem wejściowym. (Odziedziczone po InputBinding)
CommandParameter	Pobiera lub ustawia dane specyficzne dla polecenia dla określonego polecenia. (Odziedziczone po InputBinding)
CommandTarget	Pobiera lub ustawia element docelowy polecenia. (Odziedziczone po InputBinding)
DependencyObjectType	DependencyObjectType Pobiera opakowujący typ clR tego wystąpienia. (Odziedziczone po DependencyObject)
Dispatcher	Dispatcher Pobiera tę DispatcherObject wartość skojarzona z. (Odziedziczone po DispatcherObject)
Gesture	Pobiera lub ustawia gest skojarzony z tym MouseBindingelementem .
IsFrozen	Pobiera wartość wskazującą, czy obiekt jest obecnie modyfikowalny. (Odziedziczone po Freezable)
IsSealed	Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject)
MouseAction	Pobiera lub ustawia MouseAction skojarzone z tym MouseBindingelementem .

Metody

CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)	Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator. (Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)	Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez DependencyPropertyKeyelement . (Odziedziczone po DependencyObject)
Clone()	Tworzy modyfikowalny klon obiektu Freezable, tworząc głębokie kopie wartości obiektu. Podczas kopiowania właściwości zależności obiektu ta metoda kopiuje wyrażenia (które mogą już nie być rozpoznawane), ale nie animacje ani ich bieżące wartości. (Odziedziczone po Freezable)
CloneCore(Freezable)	Kopiuje podstawowe (nie animowane) wartości właściwości określonego obiektu.
CloneCurrentValue()	Tworzy modyfikowalny klon (kopię głęboką) Freezable przy użyciu jego bieżących wartości. (Odziedziczone po Freezable)
CloneCurrentValueCore(Freezable)	Kopiuje bieżące wartości właściwości określonego obiektu.
CoerceValue(DependencyProperty)	Coerce wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject)
CreateInstance()	Inicjuje nowe wystąpienie klasy Freezable. (Odziedziczone po Freezable)
CreateInstanceCore()	Tworzy wystąpienie klasy MouseBinding.
Equals(Object)	Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject)
Freeze()	Sprawia, że bieżący obiekt jest niezmodyfikowalny i ustawia jego IsFrozen właściwość na true. (Odziedziczone po Freezable)
FreezeCore(Boolean)	Sprawia, Freezable że obiekt jest niezmodyfikowalny lub sprawdza, czy można go niemodyfikować. (Odziedziczone po Freezable)
GetAsFrozen()	Tworzy zamrożoną kopię obiektu Freezableprzy użyciu wartości właściwości base (nie animowanych). Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie. (Odziedziczone po Freezable)
GetAsFrozenCore(Freezable)	Tworzy wystąpienie zamrożonego klona określonego Freezable przy użyciu wartości właściwości base (nie animowanych).
GetCurrentValueAsFrozen()	Tworzy zamrożoną kopię przy użyciu bieżących Freezable wartości właściwości. Ponieważ kopia jest zamrożona, wszystkie zamrożone obiekty podrzędne są kopiowane przez odwołanie. (Odziedziczone po Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Tworzy bieżące wystąpienie zamrożone klon określonego Freezableobiektu . Jeśli obiekt ma animowane właściwości zależności, są kopiowane ich bieżące animowane wartości.
GetHashCode()	Pobiera kod skrótu dla tego pliku DependencyObject. (Odziedziczone po DependencyObject)
GetLocalValueEnumerator()	Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości w tym DependencyObjectelemecie . (Odziedziczone po DependencyObject)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia obiektu DependencyObject. (Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)	Ponownie oblicza efektywną wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnChanged()	Wywoływana po zmodyfikowaniu bieżącego Freezable obiektu. (Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Zapewnia, że odpowiednie wskaźniki kontekstu są ustanawiane dla DependencyObjectType elementu członkowskiego danych, który został właśnie ustawiony. (Odziedziczone po Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Ten element członkowski obsługuje infrastrukturę Windows Presentation Foundation (WPF) i nie jest przeznaczony do użycia bezpośrednio z kodu. (Odziedziczone po Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Zastępuje implementację DependencyObjectOnPropertyChanged(DependencyPropertyChangedEventArgs) metody w celu wywołania wszystkich Changed procedur obsługi w odpowiedzi na zmieniającą się właściwość zależności typu Freezable. (Odziedziczone po Freezable)
ReadLocalValue(DependencyProperty)	Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject)
ReadPreamble()	Gwarantuje, że dostęp do obiektu Freezable jest uzyskiwany z prawidłowego wątku. Dziedzicze muszą Freezable wywoływać tę metodę na początku dowolnego interfejsu API, który odczytuje elementy członkowskie danych, które nie są właściwościami zależności. (Odziedziczone po Freezable)
SetCurrentValue(DependencyProperty, Object)	Ustawia wartość właściwości zależności bez zmiany źródła wartości. (Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jego identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)	Ustawia wartość lokalną właściwości zależności tylko do odczytu określona przez DependencyPropertyKey identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość podanej właściwości zależności. (Odziedziczone po DependencyObject)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
WritePostscript()	Changed Zgłasza zdarzenie dla Freezable metody i wywołuje jej OnChanged() metodę. Klasy pochodzące z Freezable programu powinny wywoływać tę metodę na końcu dowolnego interfejsu API, który modyfikuje składowe klasy, które nie są przechowywane jako właściwości zależności. (Odziedziczone po Freezable)
WritePreamble()	Sprawdza, czy Freezable element nie jest zamrożony i czy jest uzyskiwany dostęp do niego z prawidłowego kontekstu wątkowego. Freezable dziedzicze powinny wywoływać tę metodę na początku dowolnego interfejsu API, który zapisuje do elementów członkowskich danych, które nie są właściwościami zależności. (Odziedziczone po Freezable)

Zdarzenia

Changed

Występuje, gdy Freezable obiekt lub, który zawiera, jest modyfikowany. (Odziedziczone po Freezable)

Zobacz też

• MouseGesture
• KeyBinding
• CommandBinding
• RoutedCommand