winrt::event 구조체 템플릿(C++/WinRT)
지정된 대리자 형식의 이벤트를 선언하고 구현하는 데 사용할 수 있는 형식입니다. 구독자는 이벤트 처리 대리자를 이벤트에 전달합니다. 이벤트는 컬렉션에 해당 대리자를 등록합니다. 그런 다음 이벤트가 발생하면 구독자가 이벤트를 처리할 수 있도록 등록된 대리자를 차례로 호출합니다. 이벤트 작성 및 코드 예제에 대한 자세한 내용은 C++/WinRT에서 이벤트 작성을 참조하세요.
프로젝트 내부 이벤트가 필요하고 Windows 런타임 형식으로 제한되지 않는 경우 eventwinrt<::d을> 사용합니다. 자세한 내용은 프로젝트 내에서 매개 변수가 있는 대리자, 간단한 신호 및 콜백을 참조하세요.
이벤트 처리 및 코드 예제에 대한 자세한 내용은 C++/WinRT에서 대리자를 사용하여 이벤트 처리를 참조하세요.
구문
template <typename Delegate>
struct event
템플릿 매개 변수
typename Delegate 이벤트를 처리하기 위해 등록할 수 있는 대리자의 형식입니다.
요구 사항
지원되는 최소 SDK: Windows SDK 버전 10.0.17134.0(Windows 10, 버전 1803)
네임스페이스: winrt
헤더: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h(기본적으로 포함)
멤버 형식 별칭
| 별칭 이름 | Type |
|---|---|
| event::d elegate_type | 템플릿 매개 변수의 typename Delegate 동의어입니다. |
생성자
| 생성자 | Description |
|---|---|
| event::event 생성자 | 이벤트 구조체의 새 인스턴스를 초기화합니다. |
멤버 함수
| 기능 | 설명 |
|---|---|
| event::add 함수 | 이벤트 개체에 대리자를 등록합니다. |
| event::remove 함수 | 이벤트 개체에서 대리자의 등록을 취소합니다. |
멤버 연산자
| 연산자 | 설명 |
|---|---|
| event::operator()(함수 호출 연산자) | 제공된 인수를 사용하여 이벤트 개체의 등록된 대리자를 모두 호출합니다. |
| event::operator bool | 이벤트 개체에 등록된 대리자가 있는지 여부를 확인합니다. |
event::event 생성자
이벤트 구조체의 새 인스턴스를 초기화합니다.
구문
event();
event::add 함수
이벤트 개체에 대리자를 등록합니다.
구문
winrt::event_token add(Delegate const& delegate);
매개 변수
delegate이벤트 개체에 등록할 대리자입니다.
반환 값
나중에 대리자의 등록을 취소하는 데 사용할 수 있는 winrt::event_token .
event::operator()(함수 호출 연산자)
제공된 인수를 사용하여 이벤트 개체의 등록된 대리자를 모두 호출합니다.
구문
template<typename... Arg>
void operator()(Arg const&... args)
템플릿 매개 변수
typename... Arg 대리자가 호출될 때 전달되는 매개 변수의 형식을 포함하는 variadic 템플릿 매개 변수 팩입니다.
매개 변수
args 대리자가 호출될 때 전달되는 인수를 포함하는 변수 인수 목록입니다.
event::operator bool
이벤트 개체에 등록된 대리자가 있는지 여부를 확인합니다.
구문
explicit operator bool() const noexcept;
반환 값
true if the event object has any registered delegates, otherwise false.
event::remove 함수
이벤트 개체에서 대리자의 등록을 취소합니다.
구문
void remove(winrt::event_token const token);
매개 변수
token 등록을 해지할 대리자를 식별하는 winrt::event_token .