Member Function Documentation

QWinEventNotifier::QWinEventNotifier(QWinEventNotifier::HANDLE hEvent, QObject *parent = nullptr)

Constructs an event notifier with the given parent. It enables the notifier, and watches for the event hEvent.

The notifier is enabled by default, i.e. it emits the activated() signal whenever the corresponding event is signalled. However, it is generally advisable to explicitly enable or disable the event notifier.

See also setEnabled() and isEnabled().

QWinEventNotifier::QWinEventNotifier(QObject *parent = nullptr)

Constructs an event notifier with the given parent.

[signal] void QWinEventNotifier::activated(QWinEventNotifier::HANDLE hEvent)

This signal is emitted whenever the event notifier is enabled and the corresponding HANDLE is signalled.

The state of the event is not modified in the process, so if it is a manual reset event, you will need to reset it after the notification.

The object is passed in the hEvent parameter.

Note: This is a private signal. It can be used in signal connections but cannot be emitted by the user.

See also handle().

[slot] void QWinEventNotifier::setEnabled(bool enable)

If enable is true, the notifier is enabled; otherwise the notifier is disabled.

See also isEnabled() and activated().

[virtual] QWinEventNotifier::~QWinEventNotifier()

Destroys this notifier.

[override virtual protected] bool QWinEventNotifier::event(QEvent *e)

Reimplements: QObject::event(QEvent *e).

QWinEventNotifier::HANDLE QWinEventNotifier::handle() const

Returns the HANDLE that has been registered in the notifier.

See also setHandle().

bool QWinEventNotifier::isEnabled() const

Returns true if the notifier is enabled; otherwise returns false.

See also setEnabled().

void QWinEventNotifier::setHandle(QWinEventNotifier::HANDLE hEvent)

Register the HANDLE hEvent. The old HANDLE will be automatically unregistered.

Note: The notifier will be disabled as a side effect and needs to be re-enabled.

See also handle() and setEnabled().