QSocketNotifier Class

成员函数文档

[explicit, since 6.1] QSocketNotifier::QSocketNotifier(QSocketNotifier::Type type, QObject *parent = nullptr)

使用给定的type 构建一个尚未分配描述符的套接字通知器。parent 参数将传递给QObject 的构造函数。

调用setSocket()函数来设置待监视的描述符。

该函数在 Qt 6.1 中引入。

另请参阅 setSocket()、isValid() 和isEnabled()。

QSocketNotifier::QSocketNotifier(qintptr socket, QSocketNotifier::Type type, QObject *parent = nullptr)

使用给定的parent 构建一个套接字通知器。它会启用socket ，并监听给定type 的事件。

通常建议显式启用或禁用套接字通知器，尤其是对于写入通知器。

Windows 用户注意：传递给 QSocketNotifier 的套接字将变为非阻塞模式，即使它最初是作为阻塞套接字创建的。

另请参阅 setEnabled() 和isEnabled()。

[virtual noexcept] QSocketNotifier::~QSocketNotifier()

销毁此套接字通知器。

[private signal] void QSocketNotifier::activated(QSocketDescriptor socket, QSocketNotifier::Type type)

每当套接字通知器处于启用状态，且发生了与其type 对应的套接字事件时，都会发出此信号。

套接字标识符通过socket 参数传递。

// Connect using qOverload:
connect(socketNotifier, qOverload(&QSocketNotifier::activated),
        receiver, &ReceiverClass::slot);

// Or using a lambda:
connect(socketNotifier, qOverload(&QSocketNotifier::activated),
        this, [](QSocketDescriptor socket, QSocketNotifier::Type type) { /* handle activated */ });

另请参阅 type()和socket()。

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

重写了：QObject::event(QEvent *e)。

bool QSocketNotifier::isEnabled() const

如果通知器已启用，则返回true ；否则返回false 。

另请参阅 setEnabled()。

[since 6.1] bool QSocketNotifier::isValid() const

如果通知器有效（即已分配了描述符），则返回true ；否则返回false 。

该函数在 Qt 6.1 中引入。

另请参阅 setSocket()。

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

如果 `enable ` 为真，则通知器处于启用状态；否则，通知器处于禁用状态。

当通知器被启用时，每当发生与其type 对应的套接字事件，它就会发出activated()信号。当它被禁用时，它会忽略套接字事件（效果与未创建套接字通知器相同）。

写入通知器通常应在发出activated() 信号后立即禁用

另请参阅 isEnabled() 和activated()。

[since 6.1] void QSocketNotifier::setSocket(qintptr socket)

将socket 分配给此通知器。

该函数在 Qt 6.1 中引入。

另请参阅 socket()、setEnabled() 以及isValid()。

qintptr QSocketNotifier::socket() const

返回分配给该对象的套接字标识符。

另请参阅 setSocket()、isValid() 和type()。

QSocketNotifier::Type QSocketNotifier::type() const

返回在构造函数中指定的套接字事件类型。

另请参阅 socket()。