InputBinding.CommandParameter 속성

정의

네임스페이스:

System.Windows.Input

어셈블리:

PresentationCore.dll

특정 명령에 대한 명령별 데이터를 가져오거나 설정합니다.

public:
 property System::Object ^ CommandParameter { System::Object ^ get(); void set(System::Object ^ value); };

public object CommandParameter { get; set; }

member this.CommandParameter : obj with get, set

Public Property CommandParameter As Object

속성 값

Object

명령별 데이터입니다. 기본값은 null입니다.

설명

이 CommandParameter 속성은 명령이 실행될 때 특정 정보를 명령에 전달하는 데 사용됩니다. 데이터의 형식은 명령에 의해 정의됩니다. 많은 명령은 명령 매개 변수를 기대하지 않습니다. 이러한 명령의 경우 전달된 명령 매개 변수는 무시됩니다.

입력 바인딩과 연결된 명령이 a RoutedCommandCommandParameter 인 경우 입력 바인딩은 명령이 처리될 RoutedCommand 때 이벤트 데이터를 통해 ExecutedRoutedEventArgsCanExecuteRoutedEventArgs 처리기에 전달됩니다.

명령 매개 변수의 데이터 형식과 용도는 각 명령에 대해 다르게 정의되며 다음과 같습니다 null. 개체에 Command정의된 속성에 , CommandParameter및 CommandTarget 속성을 바인딩할 ICommand 수 있습니다. 이렇게 하면 사용자 지정 명령을 정의하고 사용자 입력과 연결할 수 있습니다. 자세한 내용은 두 번째 예제를 참조하세요 InputBinding.

클래스는 InputBinding 공용 매개 변수가 없는 생성자를 노출하지 않으므로 XAML 사용을 지원하지 않습니다(매개 변수가 없는 생성자는 있지만 보호됨). 그러나 파생 클래스는 공용 생성자를 노출할 수 있으므로 XAML 사용으로 상속된 InputBinding 속성을 설정할 수 있습니다. XAML에서 인스턴스화할 수 있고 XAML에서 속성을 설정할 수 있는 두 개의 기존 InputBinding 파생 클래스는 다음과 MouseBinding같습니다KeyBinding.

XAML 특성 사용

<inputBindingDerivedClass CommandParameter="commandParameterString"/>

XAML 속성 요소 사용

<inputBindingDerivedClass>
  <inputBindingDerivedClass.CommandParameter>
    <commandParameterObject/>
  </inputBindingDerivedClass.CommandParameter>
</inputBindingDerivedClass>

XAML 값

inputBindingDerivedClass개체 요소 구문(예: KeyBinding 또는 MouseBinding.)을 지원하는 파생 클래스 InputBinding 입니다. 비고 섹션을 참고하십시오.

commandParameterString 특정 명령에 의해 처리되는 문자열입니다. 문자열은 XAML에서 쉽게 설정할 수 있으므로 명령 매개 변수에 사용되는 일반적인 형식입니다. 예상되는 문자열 형식 및 용도는 입력 바인딩이 연결된 특정 명령에 대한 설명서를 참조하세요. 많은 명령은 매개 변수를 기대하지 않습니다.

commandParameterObject 특정 명령에 의해 처리되는 개체입니다. 모든 기존 WPF 명령은 문자열을 사용합니다. 따라서 이 속성 요소 구문은 사용자 지정 명령 시나리오에만 관련됩니다. 이 구문을 commandParameterObject 지원하려면 개체 요소 구문도 지원해야 합니다(공용 매개 변수가 없는 생성자가 있어야 함).