다음을 통해 공유


XamlUICommand 클래스

정의

호출 시 작업을 수행하는 대화형 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, ICommand
Public Class XamlUICommand
Inherits DependencyObject
Implements ICommand
상속
Object IInspectable DependencyObject XamlUICommand
파생
특성
구현

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 호출이 수행되면 발생합니다.

적용 대상

추가 정보