InputBinding.Command Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Input

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Dient zum Abrufen oder Festlegen des ICommand, das dieser Eingabebindung zugeordnet ist.

public:
 property System::Windows::Input::ICommand ^ Command { System::Windows::Input::ICommand ^ get(); void set(System::Windows::Input::ICommand ^ value); };

[System.ComponentModel.TypeConverter("System.Windows.Input.CommandConverter, PresentationFramework, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
public System.Windows.Input.ICommand Command { get; [System.Security.SecurityCritical] set; }

[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
[System.ComponentModel.TypeConverter("System.Windows.Input.CommandConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
public System.Windows.Input.ICommand Command { get; set; }

[<System.ComponentModel.TypeConverter("System.Windows.Input.CommandConverter, PresentationFramework, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")>]
[<System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)>]
[<set: System.Security.SecurityCritical>]
member this.Command : System.Windows.Input.ICommand with get, set

[<System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)>]
[<System.ComponentModel.TypeConverter("System.Windows.Input.CommandConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")>]
member this.Command : System.Windows.Input.ICommand with get, set

Public Property Command As ICommand

Eigenschaftswert

ICommand

Der zugeordnete Befehl.

Attribute: TypeConverterAttribute LocalizabilityAttribute SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

Der wert Command ist null.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie eine KeyBinding verwenden, um eine KeyGesture an den Befehl ApplicationCommands.Open zu binden. Wenn die Tastengeste ausgeführt wird, wird der Befehl "Öffnen" aufgerufen.

<Window.InputBindings>
  <KeyBinding Key="B"
              Modifiers="Control" 
              Command="ApplicationCommands.Open" />
</Window.InputBindings>

KeyGesture OpenKeyGesture = new KeyGesture(
    Key.B,
    ModifierKeys.Control);

KeyBinding OpenCmdKeybinding = new KeyBinding(
    ApplicationCommands.Open,
    OpenKeyGesture);

this.InputBindings.Add(OpenCmdKeybinding);

Dim OpenKeyGesture As New KeyGesture(Key.B, ModifierKeys.Control)

Dim OpenCmdKeybinding As New KeyBinding(ApplicationCommands.Open, OpenKeyGesture)

Me.InputBindings.Add(OpenCmdKeybinding)

Hinweise

Die InputBinding-Klasse unterstützt keine XAML-Verwendung, da sie keinen öffentlichen parameterlosen Konstruktor verfügbar macht (sie verfügt über einen parameterlosen Konstruktor, ist aber geschützt). Abgeleitete Klassen können jedoch einen öffentlichen Konstruktor verfügbar machen und daher Eigenschaften verwenden, die von InputBindinggeerbt werden. Zwei vorhandene InputBinding abgeleitete Klassen, die in XAML instanziiert werden können und Eigenschaften mit XAML-Verwendungen festlegen können, sind KeyBinding und MouseBinding.

ICommand verweist auf einen Typkonverter, der bestimmte bereits vorhandene ICommand Implementierungen ermöglicht, Werte in Form einer Zeichenfolge anzugeben. Dieses Typkonvertierungsverhalten legt die Attributwertform dieser Eigenschaft fest. Sie können auch die Eigenschaften Command, CommandParameterund CommandTarget an eine ICommand binden, die für ein Objekt definiert ist. Auf diese Weise können Sie einen benutzerdefinierten Befehl definieren und ihn benutzereingaben zuordnen. Weitere Informationen finden Sie im zweiten Beispiel in InputBinding.

XAML-Attributverwendung

< inputBindingDerivedClass Command="ICommand"/>

XAML-Eigenschaftselementverwendung

<inputBindingDerivedClass>  
  <inputBindingDerivedClass.Command>  
    <iCommandImplementation/>  
  </inputBindingDerivedClass.Command>  
</inputBindingDerivedClass>

XAML-Werte

inputBindingDerivedClass
Eine abgeleitete Klasse von InputBinding, die objektelementsyntax unterstützt, z. B. KeyBinding oder MouseBinding. Siehe Anmerkungen.

iCommandImplementation
Eine Objektimplementierung von ICommand, die objektelementsyntax unterstützt (verfügt über einen öffentlichen parameterlosen Konstruktor).

Gilt für:

Teilen über