MouseBinding Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Binder en MouseGesture till en RoutedCommand (eller en annan ICommand implementering).
public ref class MouseBinding : System::Windows::Input::InputBindingpublic class MouseBinding : System.Windows.Input.InputBindingtype MouseBinding = class
inherit InputBindingPublic Class MouseBinding
Inherits InputBinding- Arv
- Arv
Exempel
I följande exempel visas hur du använder en MouseBinding för att binda en MouseGesture till en 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)
Kommentarer
A MouseBinding associerar en MouseGesture med en ICommand implementering. RoutedCommand är den primära implementeringen av ICommand-gränssnittet för WPF-kommandosystemet. När körs anropas kommandot i allmänhet MouseGesture , även om kommandobeteendet påverkas ytterligare av kommandospecifika faktorer som CanExecute värdet. Mer information om kommandon finns i Översikt över kommandon.
När du definierar ett MouseBinding I XAML (Extensible Application Markup Language) finns det två sätt att ange MouseGesture. Det första sättet att upprätta en MouseBinding i XAML är att definiera Gesture -attributet för elementet MouseBinding , vilket gör det möjligt för en syntax att ange musåtgärder och modifierare som en enda sträng, till exempel "CTRL+LeftClick". Det andra sättet är att definiera MouseAction elementets MouseBinding attribut. Båda sätten att MouseGesture ange är likvärdiga och ändra samma underliggande objekt, men det blir en konflikt om båda används. Om båda attributen MouseActionGesture och anges är gesten ogiltig. I allmänhet rekommenderar vi att du endast Gesture använder attributet från XAML, även om du inte anger modifierare. Detta undviker tvetydighet, ger den mest strömlinjeformade syntaxen och ger den enklaste representationen för serialisering.
A MouseBinding kan definieras på ett specifikt objekt eller på klassnivå genom att registrera en RegisterClassInputBinding på CommandManager klassen. Det vanligaste sättet att definiera en MouseBinding är i kontrollmallen och anger InputBindings egenskapen i XAML genom att deklarera ett eller flera MouseBinding element KeyBinding .
Konstruktorer
| Name | Description |
|---|---|
| MouseBinding() |
Initierar en ny instans av MouseBinding klassen. |
| MouseBinding(ICommand, MouseGesture) |
Initierar en ny instans av klassen med hjälp av MouseBinding det angivna kommandot och musgesten. |
Fält
| Name | Description |
|---|---|
| MouseActionProperty |
Identifierar beroendeegenskapen MouseAction . |
Egenskaper
| Name | Description |
|---|---|
| CanFreeze |
Hämtar ett värde som anger om objektet kan göras ommodifierbart. (Ärvd från Freezable) |
| Command |
Hämtar eller anger den ICommand associerade med den här indatabindningen. (Ärvd från InputBinding) |
| CommandParameter |
Hämtar eller anger kommandospecifika data för ett visst kommando. (Ärvd från InputBinding) |
| CommandTarget |
Hämtar eller anger kommandots målelement. (Ärvd från InputBinding) |
| DependencyObjectType |
DependencyObjectType Hämtar som omsluter CLR-typen för den här instansen. (Ärvd från DependencyObject) |
| Dispatcher |
Hämtar det Dispatcher som DispatcherObject är associerat med. (Ärvd från DispatcherObject) |
| Gesture |
Hämtar eller anger den gest som är associerad med den här MouseBinding. |
| IsFrozen |
Hämtar ett värde som anger om objektet för närvarande kan ändras. (Ärvd från Freezable) |
| IsSealed |
Hämtar ett värde som anger om den här instansen för närvarande är förseglad (skrivskyddad). (Ärvd från DependencyObject) |
| MouseAction |
Hämtar eller anger associerad MouseAction med den här MouseBinding. |
Metoder
| Name | Description |
|---|---|
| CheckAccess() |
Avgör om den anropande tråden har åtkomst till den här DispatcherObject. (Ärvd från DispatcherObject) |
| ClearValue(DependencyProperty) |
Rensar det lokala värdet för en egenskap. Egenskapen som ska rensas anges av en DependencyProperty identifierare. (Ärvd från DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Rensar det lokala värdet för en skrivskyddad egenskap. Egenskapen som ska rensas anges av en DependencyPropertyKey. (Ärvd från DependencyObject) |
| Clone() |
Skapar en modifierbar klon av Freezableoch gör djupa kopior av objektets värden. När du kopierar objektets beroendeegenskaper kopierar den här metoden uttryck (som kanske inte längre matchar) men inte animeringar eller deras aktuella värden. (Ärvd från Freezable) |
| CloneCore(Freezable) |
Kopierar basvärdena (icke-animerade) för egenskaperna för det angivna objektet. |
| CloneCurrentValue() |
Skapar en modifierbar klon (djup kopia) av med hjälp av Freezable dess aktuella värden. (Ärvd från Freezable) |
| CloneCurrentValueCore(Freezable) |
Kopierar de aktuella värdena för egenskaperna för det angivna objektet. |
| CoerceValue(DependencyProperty) |
Tvingar fram värdet för den angivna beroendeegenskapen. Detta uppnås genom att anropa alla CoerceValueCallback funktioner som anges i egenskapsmetadata för beroendeegenskapen eftersom den finns på anropet DependencyObject. (Ärvd från DependencyObject) |
| CreateInstance() |
Initierar en ny instans av Freezable klassen. (Ärvd från Freezable) |
| CreateInstanceCore() |
Skapar en instans av en MouseBinding. |
| Equals(Object) |
Avgör om en angivet DependencyObject motsvarar den aktuella DependencyObject. (Ärvd från DependencyObject) |
| Freeze() |
Gör det aktuella objektet ommodifierbart och anger dess IsFrozen egenskap till |
| FreezeCore(Boolean) |
Gör objektet Freezable ommodifierbart eller testar om det kan göras ommodifierbart. (Ärvd från Freezable) |
| GetAsFrozen() |
Skapar en frusen Freezablekopia av , med hjälp av grundläggande (icke-animerade) egenskapsvärden. Eftersom kopian är låst kopieras alla frysta underobjekt som referens. (Ärvd från Freezable) |
| GetAsFrozenCore(Freezable) |
Skapar instansen en frusen klon av den som anges Freezable med hjälp av grundläggande (icke-animerade) egenskapsvärden. |
| GetCurrentValueAsFrozen() |
Skapar en frusen Freezable kopia av med aktuella egenskapsvärden. Eftersom kopian är låst kopieras alla frysta underobjekt som referens. (Ärvd från Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
Skapar den aktuella instansen en frusen klon av den angivna Freezable. Om objektet har animerade beroendeegenskaper kopieras deras aktuella animerade värden. |
| GetHashCode() |
Hämtar en hash-kod för den här DependencyObject. (Ärvd från DependencyObject) |
| GetLocalValueEnumerator() |
Skapar en specialiserad uppräknare för att avgöra vilka beroendeegenskaper som har lokalt angivna värden för den här DependencyObject. (Ärvd från DependencyObject) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| GetValue(DependencyProperty) |
Returnerar det aktuella effektiva värdet för en beroendeegenskap för den här instansen av en DependencyObject. (Ärvd från DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Utvärderar det effektiva värdet för den angivna beroendeegenskapen igen. (Ärvd från DependencyObject) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| OnChanged() |
Anropas när det aktuella Freezable objektet ändras. (Ärvd från Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Den här medlemmen stöder infrastrukturen för Windows Presentation Foundation (WPF) och är inte avsedd att användas direkt från koden. (Ärvd från Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Ser till att lämpliga kontextpekare upprättas för en DependencyObjectType datamedlem som just har angetts. (Ärvd från Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Anropas när det effektiva värdet för någon beroendeegenskap DependencyObject har uppdaterats. Den specifika beroendeegenskap som ändrades rapporteras i händelsedata. (Ärvd från DependencyObject) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Åsidosätter implementeringen DependencyObject av OnPropertyChanged(DependencyPropertyChangedEventArgs) för att även anropa alla Changed hanterare som svar på en ändrad beroendeegenskap av typen Freezable. (Ärvd från Freezable) |
| ReadLocalValue(DependencyProperty) |
Returnerar det lokala värdet för en beroendeegenskap, om den finns. (Ärvd från DependencyObject) |
| ReadPreamble() |
Säkerställer att åtkomsten Freezable görs från en giltig tråd. Arvtagare Freezable till måste anropa den här metoden i början av ett API som läser datamedlemmar som inte är beroendeegenskaper. (Ärvd från Freezable) |
| SetCurrentValue(DependencyProperty, Object) |
Anger värdet för en beroendeegenskap utan att ändra dess värdekälla. (Ärvd från DependencyObject) |
| SetValue(DependencyProperty, Object) |
Anger det lokala värdet för en beroendeegenskap som anges av dess beroendeegenskapsidentifierare. (Ärvd från DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Anger det lokala värdet för en skrivskyddad beroendeegenskap som anges av identifieraren DependencyPropertyKey för beroendeegenskapen. (Ärvd från DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Returnerar ett värde som anger om serialiseringsprocesser ska serialisera värdet för den angivna beroendeegenskapen. (Ärvd från DependencyObject) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
| VerifyAccess() |
Framtvingar att den anropande tråden har åtkomst till den här DispatcherObject. (Ärvd från DispatcherObject) |
| WritePostscript() |
Genererar Changed händelsen för Freezable och anropar dess OnChanged() metod. Klasser som härleds från Freezable bör anropa den här metoden i slutet av alla API:er som ändrar klassmedlemmar som inte lagras som beroendeegenskaper. (Ärvd från Freezable) |
| WritePreamble() |
Verifierar att Freezable inte är låst och att den nås från en giltig trådkontext. Freezable ärver bör anropa den här metoden i början av ett API som skriver till datamedlemmar som inte är beroendeegenskaper. (Ärvd från Freezable) |
Händelser
| Name | Description |
|---|---|
| Changed |
Inträffar när eller Freezable ett objekt som det innehåller ändras. (Ärvd från Freezable) |
