QWinEventNotifier Class
QWinEventNotifier 클래스는 Windows 대기 함수에 대한 지원을 제공합니다. 더 보기...
| 헤더: | #include <QWinEventNotifier> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| 상속합니다: | QObject |
공용 함수
| QWinEventNotifier(QObject *parent = nullptr) | |
| QWinEventNotifier(QWinEventNotifier::HANDLE hEvent, QObject *parent = nullptr) | |
| virtual | ~QWinEventNotifier() |
| QWinEventNotifier::HANDLE | handle() const |
| bool | isEnabled() const |
| void | setHandle(QWinEventNotifier::HANDLE hEvent) |
공용 슬롯
| void | setEnabled(bool enable) |
시그널
| void | activated(QWinEventNotifier::HANDLE hEvent) |
재구현된 보호 함수
| virtual bool | event(QEvent *e) override |
상세 설명
QWinEventNotifier 클래스를 사용하면 창에서 대기 함수를 비동기 방식으로 사용할 수 있습니다. 이 클래스를 사용하면 이벤트에 핸들을 등록하고 해당 이벤트가 시그널링될 때 알림을 받을 수 있습니다. 이 과정에서 이벤트의 상태는 수정되지 않으므로 수동 재설정 이벤트인 경우 알림을 받은 후 재설정해야 합니다.
CreateEvent() 또는 OpenEvent()와 같은 Windows API를 사용하여 이벤트 객체를 만든 후에는 이벤트 알림을 생성하여 이벤트 핸들을 모니터링할 수 있습니다. 이벤트 알림이 활성화되면 해당 이벤트 객체에서 신호를 받을 때마다 activated() 신호를 내보냅니다.
setEnabled() 함수를 사용하면 이벤트 알리미를 비활성화하거나 활성화할 수 있습니다. 일반적으로 이벤트 알리미를 명시적으로 활성화 또는 비활성화하는 것이 좋습니다. 비활성화된 알리미는 이벤트 객체가 신호를 받을 때 아무 일도 하지 않습니다(이벤트 알리미를 만들지 않은 것과 같은 효과). isEnabled () 함수를 사용하여 알림의 현재 상태를 확인할 수 있습니다.
마지막으로 setHandle() 함수를 사용하여 새 이벤트 객체를 등록하고 handle() 함수를 사용하여 이벤트 핸들을 검색할 수 있습니다.
추가 정보: 이 클래스는 QWinEventNotifier라고 불리지만, 프로세스, 스레드, 대기 타이머와 같은 동기화 객체라고 불리는 다른 특정 객체에도 사용할 수 있습니다.
경고: 이 클래스는 Windows에서만 사용할 수 있습니다.
멤버 함수 문서
[explicit] QWinEventNotifier::QWinEventNotifier(QObject *parent = nullptr)
주어진 parent 으로 이벤트 알림을 생성합니다.
[explicit] QWinEventNotifier::QWinEventNotifier(QWinEventNotifier::HANDLE hEvent, QObject *parent = nullptr)
주어진 parent 로 이벤트 알림을 생성합니다. 알림기를 활성화하고 이벤트 hEvent 를 감시합니다.
이 알리미는 기본적으로 활성화되어 있으며, 해당 이벤트가 신호될 때마다 activated() 신호를 보냅니다. 그러나 일반적으로 이벤트 알림을 명시적으로 사용하거나 사용하지 않도록 설정하는 것이 좋습니다.
setEnabled() 및 isEnabled()도 참조하세요 .
[virtual noexcept] QWinEventNotifier::~QWinEventNotifier()
이 알림을 삭제합니다.
[private signal] void QWinEventNotifier::activated(QWinEventNotifier::HANDLE hEvent)
이 신호는 이벤트 알림이 활성화되고 해당 핸들에 신호가 전송될 때마다 발신됩니다.
이벤트의 상태는 프로세스에서 수정되지 않으므로 수동 재설정 이벤트인 경우 알림 후 재설정해야 합니다.
개체는 hEvent 파라미터로 전달됩니다.
참고: 이것은 비공개 신호입니다. 신호 연결에서 사용할 수 있지만 사용자가 방출할 수는 없습니다.
handle()도 참조하세요 .
[override virtual protected] bool QWinEventNotifier::event(QEvent *e)
다시 구현합니다: QObject::event(QEvent *e).
QWinEventNotifier::HANDLE QWinEventNotifier::handle() const
알림에 등록된 핸들을 반환합니다.
setHandle()도 참조하세요 .
bool QWinEventNotifier::isEnabled() const
알림이 활성화된 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.
setEnabled()도 참조하세요 .
[slot] void QWinEventNotifier::setEnabled(bool enable)
enable 이 참이면 알림이 활성화되고, 그렇지 않으면 알림이 비활성화됩니다.
isEnabled() 및 activated()도 참조하세요 .
void QWinEventNotifier::setHandle(QWinEventNotifier::HANDLE hEvent)
hEvent 핸들을 등록합니다. 이전 HANDLE은 자동으로 등록이 취소됩니다.
참고: 알림은 부작용으로 비활성화되며 다시 활성화해야 합니다.
handle() 및 setEnabled()도 참조하세요 .
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
