다음을 통해 공유


XamlUICommand 클래스

정의

호출 시 작업을 수행하는 대화형 UI 요소의 명령 동작을 정의하기 위한 기본 클래스를 제공합니다(예: 전자 메일 보내기, 항목 삭제 또는 양식 제출).

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [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(Microsoft.UI.Xaml.WinUIContract), 65536)]
[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
파생
특성
구현

예제

자세한 정보, 디자인 지침 및 코드 예제는 명령 기본 사항을 참조하세요.

WinUI 3 갤러리 앱에는 대부분의 WinUI 3 컨트롤, 기능 및 기능의 대화형 예제가 포함되어 있습니다. Microsoft Store에서 앱을 다운로드하거나 GitHub에서 소스 코드를 가져오세요.

설명

ICommand 다양한 UI 속성, 메서드 및 이벤트를 추가하여 인터페이스(C++용 Microsoft.UI.Xaml.Input.ICommand 또는 C#용 System.Windows.Input.ICommand)를 구현합니다.

XamlUICommand 파생 클래스

XamlUICommand 는 미리 정의된 속성이 있는 표준 플랫폼 명령 집합을 노출하는 StandardUICommand의 부모 클래스입니다.

기본 명령 예제는 사용자가 클릭할 때 발생하는 작업을 수행하도록 설계된 Button 컨트롤을 참조하세요.

명령을 처리하는 Button 방법에는 두 가지가 있습니다(속성이 있는 컨트롤은 Command 유사한 기능을 지원합니다.)

  • Click 이벤트 처리
  • 명령 논리를 Command 설명하는 구현에 ICommand 속성을 바인딩합니다.

XamlUICommand 를 사용하면 개별 속성을 설정하지 않고 아이콘, 레이블, 설명 및 바로 가기 키(액세스 키와 키보드 가속기 모두)와 같은 컨트롤 바인딩을 통해 UI를 지정할 수 있습니다.

생성자

XamlUICommand()

XamlUICommand 클래스의 새 instance 초기화합니다.

속성

AccessKey

이 요소의 액세스 키(니모닉)를 가져오거나 설정합니다.

AccessKeyProperty

AccessKey 종속성 속성을 식별합니다.

Command

전자 메일 보내기, 항목 삭제 또는 양식 제출과 같이 호출 시 작업을 수행하는 대화형 UI 요소의 명령 동작을 가져오거나 설정합니다.

CommandProperty

명령 종속성 속성을 식별합니다.

Description

이 요소에 대한 설명을 가져오거나 설정합니다.

DescriptionProperty

Description 종속성 속성을 식별합니다.

Dispatcher

항상 Windows 앱 SDK 앱에서 를 반환 null 합니다. 대신 DispatcherQueue 를 사용합니다.

(다음에서 상속됨 DependencyObject)
DispatcherQueue

DispatcherQueue 이 개체가 연결된 을 가져옵니다. 는 DispatcherQueue 코드가 비 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 호출이 수행되면 발생합니다.

적용 대상

추가 정보