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 .

참고 항목