MouseBinding Třída

Definice

Obor názvů:

System.Windows.Input

Sestavení:

PresentationCore.dll

Vytvoří vazbu na MouseGesture (nebo jinou RoutedCommandICommand implementaci).

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

Dědičnost

Object

DispatcherObject

DependencyObject

Freezable

InputBinding

MouseBinding

Příklady

Následující příklad ukazuje, jak použít k MouseBinding vytvoření vazby k MouseGesture objektu 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)

Poznámky

Objekt MouseBinding přidruží MouseGesture k implementaci ICommand . RoutedCommand je primární implementace ICommand rozhraní pro systém příkazů WPF. Obecně platí, že při MouseGesture spuštění příkazu je vyvolán příkaz, i když chování příkazu je dále ovlivněno faktory specifickými pro příkaz, jako CanExecute je hodnota. Další informace o ovládání najdete v přehledu příkazů.

Při definování v MouseBinding jazyce XAML (Extensible Application Markup Language) existují dva způsoby, jak zadat MouseGesture. Prvním způsobem, jak vytvořit MouseBinding objekt v XAML, je definovat Gesture atribut elementu MouseBinding , který syntaxi umožňuje určit akce a modifikátory myši jako jeden řetězec, například CTRL+LeftClick. Druhým způsobem je definovat MouseAction atribut elementu MouseBinding . Oba způsoby nastavení MouseGesture jsou ekvivalentní a změní stejný základní objekt, ale pokud se použijí oba, dojde ke konfliktu. V případě, že MouseAction jsou nastaveny oba atributy a Gesture , gesto je neplatné. Obecně se doporučuje používat pouze Gesture atribut z XAML, a to i v případě, že nezadáte modifikátory; tím se zabrání nejednoznačnosti, poskytuje nejjednodušší syntaxi a poskytuje nejjednodušší reprezentaci pro serializaci.

Objekt MouseBinding lze definovat na konkrétní objekt nebo na úrovni třídy registrací RegisterClassInputBindingCommandManager třídy. Nejtypičtějším způsobem, jak definovat objekt MouseBinding , je v šabloně ovládacího prvku, nastavení InputBindings vlastnosti v XAML deklarací jednoho nebo více MouseBindingKeyBinding elementů.

Konstruktory

MouseBinding()	Inicializuje novou instanci MouseBinding třídy.
MouseBinding(ICommand, MouseGesture)	Inicializuje novou instanci MouseBinding třídy pomocí zadaného příkazu a gesta myši.

Pole

MouseActionProperty

Identifikuje MouseAction vlastnost závislosti.

Vlastnosti

CanFreeze	Získá hodnotu, která označuje, zda objekt lze změnit. (Zděděno od Freezable)
Command	Získá nebo nastaví přidružené k ICommand této vstupní vazbě. (Zděděno od InputBinding)
CommandParameter	Získá nebo nastaví data specifická pro konkrétní příkaz. (Zděděno od InputBinding)
CommandTarget	Získá nebo nastaví cílový prvek příkazu. (Zděděno od InputBinding)
DependencyObjectType	DependencyObjectType Získá, který zabalí typ CLR této instance. (Zděděno od DependencyObject)
Dispatcher	Získá přidruženou Dispatcher k tomuto DispatcherObject . (Zděděno od DispatcherObject)
Gesture	Získá nebo nastaví gesto přidružené k tomuto MouseBinding.
IsFrozen	Získá hodnotu, která označuje, zda objekt je aktuálně modifikovatelný. (Zděděno od Freezable)
IsSealed	Získá hodnotu, která označuje, zda je tato instance aktuálně zapečetěna (jen pro čtení). (Zděděno od DependencyObject)
MouseAction	Získá nebo nastaví přidružený k MouseAction tomuto MouseBinding.

Metody

CheckAccess()	Určuje, zda má volající vlákno přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
ClearValue(DependencyProperty)	Vymaže místní hodnotu vlastnosti. Vlastnost, která se má vymazat, je určena identifikátorem DependencyProperty . (Zděděno od DependencyObject)
ClearValue(DependencyPropertyKey)	Vymaže místní hodnotu vlastnosti jen pro čtení. Vlastnost, která se má vymazat, je určena parametrem DependencyPropertyKey. (Zděděno od DependencyObject)
Clone()	Vytvoří upravitelný klon objektu Freezable, který vytváří hluboké kopie hodnot objektu. Při kopírování vlastností závislostí objektu tato metoda kopíruje výrazy (které už nemusí přeložit), ale ne animace nebo jejich aktuální hodnoty. (Zděděno od Freezable)
CloneCore(Freezable)	Zkopíruje základní (ne animované) hodnoty vlastností zadaného objektu.
CloneCurrentValue()	Vytvoří upravitelný klon (hloubkovou kopii) objektu Freezable s použitím jeho aktuálních hodnot. (Zděděno od Freezable)
CloneCurrentValueCore(Freezable)	Zkopíruje aktuální hodnoty vlastností zadaného objektu.
CoerceValue(DependencyProperty)	Převede hodnotu zadané vlastnosti závislosti. Toho dosáhnete vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastnosti pro vlastnost závislosti, protože existuje ve volajícím DependencyObjectobjektu . (Zděděno od DependencyObject)
CreateInstance()	Inicializuje novou instanci Freezable třídy. (Zděděno od Freezable)
CreateInstanceCore()	Vytvoří instanci objektu MouseBinding.
Equals(Object)	Určuje, zda je zadaný DependencyObject ekvivalent k aktuálnímu DependencyObject. (Zděděno od DependencyObject)
Freeze()	Nastaví aktuální objekt jako nemodifikovatelný a nastaví jeho IsFrozen vlastnost na true. (Zděděno od Freezable)
FreezeCore(Boolean)	Způsobí, že Freezable objekt nebude možné upravit, nebo otestuje, jestli ho lze změnit. (Zděděno od Freezable)
GetAsFrozen()	Vytvoří zamrzlou kopii objektu Freezable, pomocí základních (ne animovaných) hodnot vlastností. Vzhledem k tomu, že kopie je zamrzlá, všechny zmrazené pod objekty jsou zkopírovány odkazem. (Zděděno od Freezable)
GetAsFrozenCore(Freezable)	Vytvoří instanci zmrazeného klonu zadaného Freezable pomocí základních (ne animovaných) hodnot vlastností.
GetCurrentValueAsFrozen()	Vytvoří zmrazenou kopii Freezable pomocí aktuálních hodnot vlastností. Vzhledem k tomu, že kopie je zamrzlá, všechny zmrazené pod objekty jsou zkopírovány odkazem. (Zděděno od Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Vytvoří aktuální instanci zmrazeného klonu zadaného Freezableobjektu . Pokud má objekt animované vlastnosti závislostí, zkopírují se jeho aktuální animované hodnoty.
GetHashCode()	Získá hash kód pro tento DependencyObject. (Zděděno od DependencyObject)
GetLocalValueEnumerator()	Vytvoří specializovaný enumerátor pro určení vlastností závislostí, které mají místně nastavené hodnoty v tomto DependencyObjectobjektu . (Zděděno od DependencyObject)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
GetValue(DependencyProperty)	Vrátí aktuální efektivní hodnotu vlastnosti závislosti na této instanci objektu DependencyObject. (Zděděno od DependencyObject)
InvalidateProperty(DependencyProperty)	Znovu vyhodnotí efektivní hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnChanged()	Volá se při změně aktuálního Freezable objektu. (Zděděno od Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Zajišťuje, aby byly pro datový člen, který byl právě nastaven, vytvořeny odpovídající kontextové DependencyObjectType ukazatele. (Zděděno od Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Tento člen podporuje infrastrukturu Windows Presentation Foundation (WPF) a není určen k použití přímo z vašeho kódu. (Zděděno od Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Přepíše implementaci DependencyObject tak, OnPropertyChanged(DependencyPropertyChangedEventArgs) aby také vyvolala všechny Changed obslužné rutiny v reakci na měnící se vlastnost závislosti typu Freezable. (Zděděno od Freezable)
ReadLocalValue(DependencyProperty)	Vrátí místní hodnotu vlastnosti závislosti, pokud existuje. (Zděděno od DependencyObject)
ReadPreamble()	Zajišťuje, že Freezable se k souboru přistupuje z platného vlákna. Dědiči Freezable musí tuto metodu volat na začátku jakéhokoli rozhraní API, které čte datové členy, které nejsou vlastnosti závislostí. (Zděděno od Freezable)
SetCurrentValue(DependencyProperty, Object)	Nastaví hodnotu vlastnosti závislosti beze změny jejího zdroje hodnoty. (Zděděno od DependencyObject)
SetValue(DependencyProperty, Object)	Nastaví místní hodnotu vlastnosti závislosti určenou identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject)
SetValue(DependencyPropertyKey, Object)	Nastaví místní hodnotu vlastnosti závislosti jen pro čtení určenou DependencyPropertyKey identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Vrátí hodnotu, která označuje, zda serializační procesy mají serializovat hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
VerifyAccess()	Vynutí, aby volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
WritePostscript()	Changed Vyvolá událost pro Freezable a vyvolá její OnChanged() metodu. Třídy odvozené z Freezable by měly tuto metodu volat na konci libovolného rozhraní API, které upravuje členy třídy, které nejsou uloženy jako vlastnosti závislostí. (Zděděno od Freezable)
WritePreamble()	Ověřuje, že Freezable objekt není zamrznutý a že se k němu přistupuje z platného kontextu podprocesů. Freezable Dědiče by měli tuto metodu volat na začátku jakéhokoli rozhraní API, které zapisuje do datových členů, které nejsou vlastnosti závislostí. (Zděděno od Freezable)

Událost

Changed

Nastane při změně objektu Freezable nebo objektu, který obsahuje. (Zděděno od Freezable)

Viz také

• MouseGesture
• KeyBinding
• CommandBinding
• RoutedCommand