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 参数传递。

注：该类重载了信号激活。要使用函数指针语法连接该信号，Qt 提供了一个方便的辅助工具来获取函数指针，如本例所示：

connect(socketNotifier, QOverload<QSocketDescriptor, QSocketNotifier::Type>::of(&QSocketNotifier::activated),
    [=](QSocketDescriptor socket, QSocketNotifier::Type type){ /* ... */ });

另请参阅 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 为 true，则启用通知符；否则禁用通知符。

启用通知符后，每当与type 对应的套接字事件发生时，通知符就会发出 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()。