QWinEventNotifier Class
La classe QWinEventNotifier prend en charge les fonctions d'attente de Windows. Plus d'informations...
| En-tête : | #include <QWinEventNotifier> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
| Héritages : | QObject |
Fonctions publiques
| 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) |
Emplacements publics
| void | setEnabled(bool enable) |
Signaux
| void | activated(QWinEventNotifier::HANDLE hEvent) |
Fonctions protégées réimplémentées
| virtual bool | event(QEvent *e) override |
Description détaillée
La classe QWinEventNotifier permet d'utiliser les fonctions d'attente sur les fenêtres de manière asynchrone. Avec cette classe, vous pouvez enregistrer un HANDLE à un événement et recevoir une notification lorsque cet événement est signalé. L'état de l'événement n'est pas modifié au cours du processus, de sorte que s'il s'agit d'un événement à réinitialisation manuelle, vous devrez le réinitialiser après la notification.
Une fois que vous avez créé un objet événement à l'aide de l'API Windows, par exemple CreateEvent() ou OpenEvent(), vous pouvez créer un notificateur d'événement pour surveiller la poignée de l'événement. Si le notificateur d'événements est activé, il émettra le signal activated() chaque fois que l'objet d'événement correspondant sera signalé.
La fonction setEnabled() vous permet de désactiver et d'activer le notificateur d'événements. Il est généralement conseillé d'activer ou de désactiver explicitement le notificateur d'événements. Un notificateur désactivé ne fait rien lorsque l'objet événement est signalé (ce qui revient à ne pas créer le notificateur d'événements). Utilisez la fonction isEnabled() pour déterminer l'état actuel du notificateur.
Enfin, vous pouvez utiliser la fonction setHandle() pour enregistrer un nouvel objet d'événement et la fonction handle() pour récupérer la poignée de l'événement.
Informations complémentaires : Bien que la classe s'appelle QWinEventNotifier, elle peut être utilisée pour certains autres objets dits de synchronisation, tels que les processus, les threads et les temporisateurs.
Attention : Cette classe n'est disponible que sous Windows.
Documentation des fonctions membres
[explicit] QWinEventNotifier::QWinEventNotifier(QObject *parent = nullptr)
Construit un notificateur d'événements avec la valeur donnée parent.
[explicit] QWinEventNotifier::QWinEventNotifier(QWinEventNotifier::HANDLE hEvent, QObject *parent = nullptr)
Construit un notificateur d'événement avec l'adresse parent. Il active le notificateur et surveille l'événement hEvent.
Le notificateur est activé par défaut, c'est-à-dire qu'il émet le signal activated() chaque fois que l'événement correspondant est signalé. Toutefois, il est généralement conseillé d'activer ou de désactiver explicitement le notificateur d'événements.
Voir également setEnabled() et isEnabled().
[virtual noexcept] QWinEventNotifier::~QWinEventNotifier()
Détruit ce notificateur.
[private signal] void QWinEventNotifier::activated(QWinEventNotifier::HANDLE hEvent)
Ce signal est émis chaque fois que le notificateur d'événements est activé et que le HANDLE correspondant est signalé.
L'état de l'événement n'est pas modifié au cours du processus, donc s'il s'agit d'un événement à réinitialisation manuelle, vous devrez le réinitialiser après la notification.
L'objet est transmis dans le paramètre hEvent.
Remarque : il s'agit d'un signal privé. Il peut être utilisé dans les connexions de signaux mais ne peut pas être émis par l'utilisateur.
Voir aussi handle().
[override virtual protected] bool QWinEventNotifier::event(QEvent *e)
Réimplémente : QObject::event(QEvent *e).
QWinEventNotifier::HANDLE QWinEventNotifier::handle() const
Renvoie le HANDLE qui a été enregistré dans le notificateur.
Voir aussi setHandle().
bool QWinEventNotifier::isEnabled() const
Renvoie true si le notificateur est activé ; sinon, renvoie false.
Voir aussi setEnabled().
[slot] void QWinEventNotifier::setEnabled(bool enable)
Si enable est vrai, le notificateur est activé ; sinon, il est désactivé.
Voir aussi isEnabled() et activated().
void QWinEventNotifier::setHandle(QWinEventNotifier::HANDLE hEvent)
Enregistrez la POIGNÉE hEvent. L'ancien HANDLE sera automatiquement désenregistré.
Note: Le notificateur sera désactivé comme effet de bord et devra être réactivé.
Voir également handle() et setEnabled().
© 2026 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.
