QSocketNotifier Class
La clase QSocketNotifier permite supervisar la actividad de un descriptor de archivo. Más información ...
| Encabezado: | #include <QSocketNotifier> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Heredado de: | QObject |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QSocketNotifier forma parte de la API de programación de redes y de Entrada/Salida y redes.
Tipos públicos
| enum | Type { Read, Write, Exception } |
Funciones públicas
(since 6.1) | QSocketNotifier(QSocketNotifier::Type type, QObject *parent = nullptr) |
| QSocketNotifier(qintptr socket, QSocketNotifier::Type type, QObject *parent = nullptr) | |
| virtual | ~QSocketNotifier() |
| bool | isEnabled() const |
(since 6.1) bool | isValid() const |
(since 6.1) void | setSocket(qintptr socket) |
| qintptr | socket() const |
| QSocketNotifier::Type | type() const |
Ranuras públicas
| void | setEnabled(bool enable) |
Señales
| void | activated(QSocketDescriptor socket, QSocketNotifier::Type type) |
Funciones protegidas reimplementadas
| virtual bool | event(QEvent *e) override |
Descripción detallada
QSocketNotifier permite integrar el bucle de eventos de Qt con otros bucles de eventos basados en descriptores de archivo. La acción del descriptor de archivo se detecta en el bucle de eventos principal de Qt (QCoreApplication::exec()).
Una vez que hayas abierto un dispositivo mediante una API de bajo nivel (normalmente específica de la plataforma), puedes crear un notificador de socket para supervisar el descriptor de archivo. Si se pasa el descriptor al constructor del notificador de socket, este se habilita por defecto, es decir, emite la señal activated() cada vez que se produce un evento de socket correspondiente a su tipo. Conecta la señal activated() a la ranura que desees que se active cuando se produzca un evento correspondiente al tipo de tu notificador de socket.
Puedes crear un notificador de sockets sin asignarle ningún descriptor. En este caso, debes llamar a la función setSocket() una vez que se haya obtenido el descriptor.
Existen tres tipos de notificadores de socket: lectura, escritura y excepción. El tipo se describe mediante la enumeración ` Type ` y debe especificarse al crear el notificador de socket. Una vez creado, puede determinarse mediante la función ` type()`. Ten en cuenta que, si necesitas supervisar tanto las lecturas como las escrituras para el mismo descriptor de archivo, debes crear dos notificadores de socket. Ten en cuenta también que no es posible instalar dos notificadores de socket del mismo tipo (Read, Write, Exception) en el mismo socket.
La función ` setEnabled()` permite tanto desactivar como activar el notificador de socket. Por lo general, es recomendable activar o desactivar explícitamente el notificador de socket, especialmente en el caso de los notificadores de escritura. Un notificador desactivado ignora los eventos del socket (lo que tiene el mismo efecto que no crear el notificador de socket). Utiliza la función ` isEnabled()` para determinar el estado actual del notificador.
Por último, puedes utilizar la función socket() para recuperar el identificador del socket. Aunque la clase se denomina QSocketNotifier, normalmente se utiliza para otros tipos de dispositivos distintos de los sockets. QTcpSocket y QUdpSocket proporcionan notificaciones a través de señales, por lo que normalmente no es necesario utilizar un QSocketNotifier con ellos.
Véase también QFile, QProcess, QTcpSocket y QUdpSocket.
Documentación sobre los tipos de miembros
enum QSocketNotifier::Type
Esta enumeración describe los distintos tipos de eventos que puede reconocer un notificador de socket. El tipo debe especificarse al crear el notificador de socket.
Ten en cuenta que, si necesitas supervisar tanto las lecturas como las escrituras de un mismo descriptor de archivo, debes crear dos notificadores de socket. Ten en cuenta también que no es posible instalar dos notificadores de socket del mismo tipo (Lectura, Escritura, Excepción) en el mismo socket.
| Constante | Valor | Descripción |
|---|---|---|
QSocketNotifier::Read | 0 | Hay datos que leer. |
QSocketNotifier::Write | 1 | Se pueden escribir datos. |
QSocketNotifier::Exception | 2 | Se ha producido una excepción. No recomendamos utilizar esto. |
Véase también QSocketNotifier() y type().
Documentación de funciones de miembro
[explicit, since 6.1] QSocketNotifier::QSocketNotifier(QSocketNotifier::Type type, QObject *parent = nullptr)
Crea un notificador de socket con el « type » indicado, al que no se le ha asignado ningún descriptor. El argumento « parent » se pasa al constructor de « QObject ».
Llama a la función setSocket() para establecer el descriptor que se va a supervisar.
Esta función se introdujo en Qt 6.1.
Véase también setSocket(), isValid() y isEnabled().
QSocketNotifier::QSocketNotifier(qintptr socket, QSocketNotifier::Type type, QObject *parent = nullptr)
Crea un notificador de sockets con el ` parent` indicado. Activa el ` socket` y supervisa los eventos del ` type` indicado.
En general, es recomendable habilitar o deshabilitar explícitamente el notificador de socket, especialmente en el caso de los notificadores de escritura.
Nota para usuarios de Windows: el socket pasado a QSocketNotifier pasará a ser no bloqueante, incluso si se creó como un socket bloqueante.
Véanse también setEnabled() y isEnabled().
[virtual noexcept] QSocketNotifier::~QSocketNotifier()
Elimina este notificador de sockets.
[private signal] void QSocketNotifier::activated(QSocketDescriptor socket, QSocketNotifier::Type type)
Esta señal se emite siempre que el notificador de sockets esté activado y se produzca un evento de socket correspondiente a su « type ».
El identificador del socket se pasa en el parámetro « socket ».
Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.
Nota: Esta señal está sobrecargada. Para conectarse a esta señal:
// 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 */ }); Véase también ` type()` y ` socket()`.
[override virtual protected] bool QSocketNotifier::event(QEvent *e)
Reimplementa: QObject::event(QEvent *e).
bool QSocketNotifier::isEnabled() const
Devuelve « true » si el notificador está activado; en caso contrario, devuelve « false ».
Véase también setEnabled().
[since 6.1] bool QSocketNotifier::isValid() const
Devuelve ` true ` si el notificador es válido (es decir, tiene un descriptor asignado); en caso contrario, devuelve ` false`.
Esta función se introdujo en Qt 6.1.
Véase también setSocket().
[slot] void QSocketNotifier::setEnabled(bool enable)
Si enable es verdadero, el notificador está activado; en caso contrario, está desactivado.
Cuando el notificador está activado, emite la señal activated() cada vez que se produce un evento de socket correspondiente a su type. Cuando está desactivado, ignora los eventos de socket (lo que tiene el mismo efecto que no crear el notificador de socket).
Normalmente, los notificadores de escritura deben desactivarse inmediatamente después de que se haya emitido la señal activated()
Véanse también isEnabled() y activated().
[since 6.1] void QSocketNotifier::setSocket(qintptr socket)
Asigna el servicio « socket » a este notificador.
Nota: Como efecto secundario,el notificador quedará desactivado y será necesario volver a activarlo.
Esta función se introdujo en Qt 6.1.
Véase también socket(), setEnabled() y isValid().
qintptr QSocketNotifier::socket() const
Devuelve el identificador de socket asignado a este objeto.
Véase también setSocket(), isValid() y type().
QSocketNotifier::Type QSocketNotifier::type() const
Devuelve el tipo de evento de socket especificado en el constructor.
Véase también socket().
© 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.