XamlUICommand 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
호출 시 작업을 수행하는 대화형 UI 요소의 명령 동작을 정의하기 위한 기본 클래스를 제공합니다(예: 이메일 보내기, 항목 삭제 또는 양식 제출).
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class XamlUICommand : DependencyObject, ICommand[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class XamlUICommand : DependencyObject, ICommandPublic Class XamlUICommand
Inherits DependencyObject
Implements ICommand- 상속
- 파생
- 특성
- 구현
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10, version 1809 (10.0.17763.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v7.0에서 도입되었습니다.)
|
예제
팁
자세한 정보, 디자인 지침 및 코드 예제는 명령 디자인 기본 사항을 참조하세요.
WinUI 2 갤러리 앱이 설치되어 있는 경우 여기를 클릭하여 앱을 열고 StandardUICommand가 작동하는 것을 확인합니다.
설명
다양한 UI 속성, 메서드 및 이벤트를 추가하여 ICommand 인터페이스(C++용 Windows.UI.Xaml.Input.ICommand 또는 C#용 System.Windows.Input.ICommand )를 구현합니다.
XamlUICommand 파생 클래스
XamlUICommand는 StandardUICommand의 부모 클래스로, 미리 정의된 속성을 사용하여 표준 플랫폼 명령 집합을 노출합니다.
기본 명령 예제는 사용자가 클릭할 때 발생하도록 설계된 Button 컨트롤을 참조하세요.
Button 명령을 처리하는 방법에는 두 가지가 있습니다(Command 속성이 있는 컨트롤은 유사한 기능을 지원합니다.)
- Click 이벤트 처리
- 명령 논리를 설명하는 ICommand 구현에 Command 속성을 바인딩합니다.
XamlUICommand를 사용하면 개별 속성을 설정하지 않고 아이콘, 레이블, 설명, 바로 가기 키(액세스 키 및 키보드 가속기 둘 다) 같은 컨트롤 바인딩을 통해 UI를 지정할 수 있습니다.
생성자
| XamlUICommand() |
XamlUICommand 클래스의 새 instance 초기화합니다. |
속성
| AccessKey |
이 요소의 액세스 키(니모닉)를 가져오거나 설정합니다. |
| AccessKeyProperty |
AccessKey 종속성 속성을 식별합니다. |
| Command |
전자 메일 보내기, 항목 삭제 또는 양식 제출과 같이 호출 시 작업을 수행하는 대화형 UI 요소의 명령 동작을 가져오거나 설정합니다. |
| CommandProperty |
명령 종속성 속성을 식별합니다. |
| Description |
이 요소에 대한 설명을 가져오거나 설정합니다. |
| DescriptionProperty |
Description 종속성 속성을 식별합니다. |
| Dispatcher |
이 개체가 연결된 CoreDispatcher 를 가져옵니다. CoreDispatcher는 코드가 비 UI 스레드에서 시작된 경우에도 UI 스레드에서 DependencyObject에 액세스할 수 있는 기능을 나타냅니다. (다음에서 상속됨 DependencyObject) |
| IconSource |
이 요소의 Segoe MDL2 자산 글꼴에서 문자 모양을 가져오거나 설정합니다. |
| IconSourceProperty |
IconSource 종속성 속성을 식별합니다. |
| KeyboardAccelerators |
키보드를 사용하여 작업을 호출하는 이 요소의 키 조합 컬렉션을 가져오거나 설정합니다. |
| KeyboardAcceleratorsProperty |
KeyboardAccelerators 종속성 속성을 식별합니다. |
| Label |
이 요소의 레이블을 가져오거나 설정합니다. |
| LabelProperty |
Label 종속성 속성을 식별합니다. |
메서드
| CanExecute(Object) |
명령이 현재 상태에서 실행할 수 있는지 여부를 검색합니다. |
| ClearValue(DependencyProperty) |
종속성 속성의 로컬 값을 지웁니다. (다음에서 상속됨 DependencyObject) |
| Execute(Object) |
명령을 호출합니다. |
| GetAnimationBaseValue(DependencyProperty) |
애니메이션이 활성화되지 않은 경우 적용되는 종속성 속성에 대해 설정된 모든 기본 값을 반환합니다. (다음에서 상속됨 DependencyObject) |
| GetValue(DependencyProperty) |
DependencyObject에서 종속성 속성의 현재 유효 값을 반환합니다. (다음에서 상속됨 DependencyObject) |
| NotifyCanExecuteChanged() |
명령 상태가 변경되었음을 시스템에 알 수 있습니다. |
| ReadLocalValue(DependencyProperty) |
로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다. (다음에서 상속됨 DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
이 DependencyObject instance 특정 DependencyProperty의 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다. (다음에서 상속됨 DependencyObject) |
| SetValue(DependencyProperty, Object) |
DependencyObject에서 종속성 속성의 로컬 값을 설정합니다. (다음에서 상속됨 DependencyObject) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
RegisterPropertyChangedCallback을 호출하여 이전에 등록된 변경 알림을 취소합니다. (다음에서 상속됨 DependencyObject) |
이벤트
| CanExecuteChanged |
명령이 실행 가능 여부에 영향을 주는 문제가 발생할 때마다 발생합니다. |
| CanExecuteRequested |
CanExecute 호출이 수행되면 발생합니다. |
| ExecuteRequested |
Execute 호출이 수행되면 발생합니다. |