En esta página

QAccessible Class

La clase QAccessible proporciona enumeraciones y funciones estáticas relacionadas con la accesibilidad. Más información...

Encabezado: #include <QAccessible>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

Tipos públicos

struct State
(since 6.8) enum class AnnouncementPoliteness { Polite, Assertive }
(since 6.8) enum class Attribute { Custom, Level, Locale, Orientation }
enum Event { AcceleratorChanged, ActionChanged, ActiveDescendantChanged, Alert, Announcement, …, VisibleDataChanged }
Id
InterfaceFactory
enum InterfaceType { TextInterface, ValueInterface, ActionInterface, TableInterface, TableCellInterface, …, ViewportInterface }
flags Relation
enum RelationFlag { Label, Labelled, Controller, Controlled, DescriptionFor, …, AllRelations }
enum Role { AlertMessage, Animation, Application, Assistant, BlockQuote, …, Window }
enum Text { Name, Description, Value, Help, Accelerator, …, Identifier }
enum TextBoundaryType { CharBoundary, WordBoundary, SentenceBoundary, ParagraphBoundary, LineBoundary, NoBoundary }

Miembros públicos estáticos

QAccessibleInterface *accessibleInterface(QAccessible::Id id)
void deleteAccessibleInterface(QAccessible::Id id)
void installFactory(QAccessible::InterfaceFactory factory)
bool isActive()
QAccessibleInterface *queryAccessibleInterface(QObject *object)
QAccessible::Id registerAccessibleInterface(QAccessibleInterface *iface)
void removeFactory(QAccessible::InterfaceFactory factory)
void setRootObject(QObject *object)
QAccessible::Id uniqueId(QAccessibleInterface *iface)
void updateAccessibility(QAccessibleEvent *event)

Descripción detallada

Esta clase forma parte de la accesibilidad para aplicaciones QWidget.

Las aplicaciones accesibles pueden ser utilizadas por personas que no pueden utilizar aplicaciones por medios convencionales.

Las funciones de esta clase se utilizan para la comunicación entre aplicaciones accesibles (también denominadas «servidores AT») y herramientas de accesibilidad (clientes AT), como lectores de pantalla y pantallas braille. Los clientes y los servidores se comunican de la siguiente manera:

  • Los servidores AT notifican a los clientes los eventos mediante llamadas a la función ` updateAccessibility()`.
  • Los clientes AT solicitan información sobre los objetos del servidor. La clase ` QAccessibleInterface ` es la interfaz principal y encapsula esta información en una API virtual pura. Qt proporciona implementaciones de la interfaz a través de la API ` queryAccessibleInterface()`.

La comunicación entre servidores y clientes se inicia mediante la función ` setRootObject()`. Se pueden instalar punteros a funciones para sustituir o ampliar el comportamiento predeterminado de las funciones estáticas de `QAccessible`.

Qt es compatible con Microsoft Active Accessibility (MSAA), la accesibilidad de macOS y el estándar AT-SPI de Unix/X11. Se puede añadir compatibilidad con otros backends mediante QAccessibleBridge.

En la implementación de Unix/X11 AT-SPI, las aplicaciones se vuelven accesibles cuando se cumplen dos condiciones:

  • la propiedad DBus `org.a11y.Status.IsEnabled` es verdadera
  • la propiedad DBus `org.a11y.Status.ScreenReaderEnabled` es verdadera

Una alternativa a la configuración de las propiedades DBus de AT-SPI es establecer la variable de entorno QT_LINUX_ACCESSIBILITY_ALWAYS_ON.

Además de las funciones estáticas de `QAccessible`, Qt ofrece una interfaz genérica, ` QAccessibleInterface`, que puede utilizarse para envolver todos los widgets y objetos (por ejemplo, ` QPushButton`). Esta única interfaz proporciona todos los metadatos necesarios para las tecnologías de asistencia. Qt proporciona implementaciones de esta interfaz para sus widgets integrados en forma de complementos.

Al desarrollar widgets personalizados, puedes crear subclases personalizadas de ` QAccessibleInterface ` y distribuirlas como complementos (utilizando ` QAccessiblePlugin`) o compilarlas en la aplicación. Del mismo modo, la compatibilidad con la accesibilidad predefinida de Qt puede integrarse como complemento (por defecto) o directamente en la biblioteca de Qt. La principal ventaja de utilizar complementos es que las clases de accesibilidad solo se cargan en memoria si se utilizan realmente; así no ralentizan el funcionamiento en los casos habituales en los que no se utiliza ninguna tecnología de asistencia.

Qt también incluye dos clases de conveniencia, QAccessibleObject y QAccessibleWidget, que heredan de QAccessibleInterface y proporcionan el mínimo común denominador de metadatos (por ejemplo, geometría del widget, título de la ventana, texto de ayuda básico). Puedes utilizarlas como clases base al envolver tus subclases personalizadas de QObject o QWidget.

Véase también QAccessibleInterface.

Documentación sobre los tipos de miembros

[since 6.8] enum class QAccessible::AnnouncementPoliteness

Esta enumeración describe la prioridad de los anuncios que utiliza el servicio « QAccessibleAnnouncementEvent ».

Con el valor « QAccessible::AnouncementPoliteness::Polite », las tecnologías de asistencia deben anunciar el mensaje en la primera oportunidad oportuna, como al finalizar la lectura de la frase actual o cuando el usuario hace una pausa al escribir. Un anuncio de cortesía puede interrumpir incluso otro anuncio de cortesía que ya esté en curso.

Al especificar « QAccessible::AnouncementPoliteness::Assertive », las tecnologías de asistencia deben notificar al usuario de forma inmediata.

Dado que una interrupción podría desorientar a los usuarios o impedirles completar su tarea actual, no debe utilizarse « QAccessible::AnouncementPoliteness::Assertive » a menos que la interrupción sea imprescindible.

ConstanteValorDescripción
QAccessible::AnnouncementPoliteness::Polite0El anuncio tiene prioridad normal.
QAccessible::AnnouncementPoliteness::Assertive1El aviso tiene alta prioridad y debe notificarse al usuario de inmediato, incluso si eso implica interrumpir la tarea actual del usuario.

Esta enumeración se introdujo en Qt 6.8.

Véase también QAccessibleAnnouncementEvent.

[since 6.8] enum class QAccessible::Attribute

Esta enumeración describe los diferentes tipos de atributos que utiliza el ` QAccessibleAttributesInterface`.

Estos atributos son comparables al concepto de propiedades/atributos (de objeto) que se encuentra en ARIA, AT-SPI2, IAccessible, UIA y NSAccessibility, y se asignan a su equivalente en la plataforma correspondiente cuando procede.

Cada atributo se gestiona como un par clave-valor, utilizándose los valores de esta enumeración como claves.

Los valores de los atributos se representan en un objeto ` QVariant`. El tipo del valor almacenado en el objeto ` QVariant ` es fijo y se especifica a continuación para cada uno de los tipos de atributos.

ConstanteValorDescripción
QAccessible::Attribute::Custom0Tipo de valor: QHash<QString, QString> El atributo « Custom » es especial, ya que puede representar de forma efectiva varios atributos a la vez, puesto que es en sí mismo un « QHash » utilizado para representar pares clave-valor. En las plataformas que admiten pares clave-valor personalizados para los atributos, los establecidos en el atributo « Custom » se transmiten a la capa de la plataforma sin aplicar ninguna conversión a los atributos específicos de la plataforma. En general, deben utilizarse los demás atributos, que tienen un tipo de datos más definido. Este atributo puede utilizarse, por ejemplo, para la creación de prototipos antes de añadir oficialmente un nuevo valor de enumeración para una característica específica.
QAccessible::Attribute::Level1tipo de valor: int Define el nivel jerárquico de un elemento dentro de una estructura, por ejemplo, el nivel de encabezado de un encabezado. Este atributo se corresponde conceptualmente con la propiedad «aria-level» de ARIA.
QAccessible::Attribute::Locale (since Qt 6.10)2tipo de valor: QLocale Configuración regional del elemento. Se puede utilizar para especificar que un elemento tiene una configuración regional diferente a la predeterminada de la aplicación, por ejemplo, para documentos o párrafos dentro de un documento que utilicen un idioma distinto al de la interfaz de usuario de la aplicación.
QAccessible::Attribute::Orientation (since Qt 6.11)3Tipo de valor: Qt::Orientation Orientación del elemento. Este atributo se corresponde conceptualmente con la propiedad «aria-orientation» de ARIA.

Esta enumeración se introdujo en Qt 6.8.

Véase también QAccessibleAttributesInterface.

enum QAccessible::Event

Este tipo de enumeración define los tipos de eventos accesibles.

ConstanteValorDescripción
QAccessible::AcceleratorChanged0x80C0Se ha modificado el atajo de teclado de una acción.
QAccessible::ActionChanged0x0101Se ha modificado una acción.
QAccessible::ActiveDescendantChanged0x0102 
QAccessible::Alert0x0002Se ha producido una alerta del sistema (por ejemplo, un mensaje de QMessageBox)
QAccessible::Announcement (since Qt 6.8)0x80D0Se ha solicitado el anuncio de un mensaje.
QAccessible::AttributeChanged0x0103 
QAccessible::ContextHelpEnd0x000DSe ha finalizado la ayuda contextual (QWhatsThis) de un objeto.
QAccessible::ContextHelpStart0x000CSe inicia la ayuda contextual (QWhatsThis) para un objeto.
QAccessible::DefaultActionChanged0x80B0Se ha modificado la acción predeterminada QAccessible::Action del objeto accesible.
QAccessible::DescriptionChanged0x800DSe ha modificado el QAccessible::Description del objeto.
QAccessible::DialogEnd0x0011Se ha ocultado un cuadro de diálogo (QDialog).
QAccessible::DialogStart0x0010Se ha hecho visible un cuadro de diálogo (QDialog).
QAccessible::DocumentContentChanged0x0104El contenido de un documento de texto ha cambiado.
QAccessible::DocumentLoadComplete0x0105Se ha cargado un documento.
QAccessible::DocumentLoadStopped0x0106Se ha detenido la carga de un documento.
QAccessible::DocumentReload0x0107Se ha iniciado la recarga de un documento.
QAccessible::DragDropEnd0x000FUna operación de arrastrar y soltar está a punto de finalizar.
QAccessible::DragDropStart0x000EEstá a punto de iniciarse una operación de arrastrar y soltar.
QAccessible::Focus0x8005Un objeto ha obtenido el foco del teclado.
QAccessible::ForegroundChanged0x0003Se ha activado una ventana (es decir, una nueva ventana ha obtenido el foco en el escritorio).
QAccessible::HelpChanged0x80A0La propiedad de texto « QAccessible::Help » de un objeto ha cambiado.
QAccessible::HyperlinkEndIndexChanged0x0108Ha cambiado la posición final del texto de visualización de un enlace de hipertexto.
QAccessible::HyperlinkNumberOfAnchorsChanged0x0109Ha cambiado el número de anclajes de un enlace de hipertexto, quizá porque el texto de visualización se ha dividido para proporcionar más de un enlace.
QAccessible::HyperlinkSelectedLinkChanged0x010AEl enlace del hipervínculo seleccionado ha cambiado.
QAccessible::HyperlinkStartIndexChanged0x010DHa cambiado la posición inicial del texto visible de un enlace de hipertexto.
QAccessible::HypertextChanged0x010EEl texto visible de un enlace de hipertexto ha cambiado.
QAccessible::HypertextLinkActivated0x010BSe ha activado un enlace de hipertexto, quizá al hacer clic en él o al pulsar una tecla.
QAccessible::HypertextLinkSelected0x010CSe ha seleccionado un enlace de hipertexto.
QAccessible::HypertextNLinksChanged0x010F 
QAccessible::IdentifierChanged (since Qt 6.8)0x80E0El identificador de un objeto ha cambiado.
QAccessible::LocationChanged0x800BHa cambiado la ubicación de un objeto en la pantalla.
QAccessible::MenuCommand0x0018Se ha activado un elemento del menú.
QAccessible::MenuEnd0x0005Se ha cerrado un menú (Qt utiliza PopupMenuEnd para todos los menús).
QAccessible::MenuStart0x0004Se ha abierto un menú en la barra de menús (Qt utiliza PopupMenuStart para todos los menús).
QAccessible::NameChanged0x800CLa propiedad « QAccessible::Name » de un objeto ha cambiado.
QAccessible::ObjectAttributeChanged0x0110 
QAccessible::ObjectCreated0x8000Se ha creado un nuevo objeto.
QAccessible::ObjectDestroyed0x8001Se ha eliminado un objeto.
QAccessible::ObjectHide0x8003Se ha ocultado un objeto; por ejemplo, con QWidget::hide(). Los elementos secundarios del objeto oculto no envían este evento. Tampoco se envía cuando un objeto queda oculto al quedar tapado por otros.
QAccessible::ObjectReorder0x8004Un diseño o una vista de elementos ha añadido, eliminado o movido un objeto (Qt no utiliza este evento).
QAccessible::ObjectShow0x8002Se muestra un objeto; por ejemplo, con ` QWidget::show()`.
QAccessible::PageChanged0x0111 
QAccessible::ParentChanged0x800FEl objeto padre de un objeto ha cambiado.
QAccessible::PopupMenuEnd0x0007Se ha cerrado un menú emergente.
QAccessible::PopupMenuStart0x0006Se ha abierto un menú emergente.
QAccessible::RoleChanged (since Qt 6.11)0x80E1Ha cambiado la función de un objeto.
QAccessible::ScrollingEnd0x0013Ha finalizado una operación de desplazamiento en una barra de desplazamiento (se ha soltado el control deslizante con el ratón).
QAccessible::ScrollingStart0x0012Está a punto de iniciarse una operación de desplazamiento en una barra de desplazamiento; esto puede deberse, por ejemplo, a que se ha pulsado el ratón sobre el control deslizante.
QAccessible::ScrollingPositionChanged (since Qt 6.12)0x0014La posición ha cambiado durante una operación de desplazamiento.
QAccessible::SectionChanged0x0112 
QAccessible::SelectionAdd0x8007Se ha añadido un elemento a la selección en una vista de elementos.
QAccessible::SelectionRemove0x8008Se ha eliminado un elemento de la selección de una vista de elementos.
QAccessible::Selection0x8006La selección ha cambiado en un menú o en una vista de elementos.
QAccessible::SelectionWithin0x8009Se han producido varios cambios en una selección en una vista de elementos.
QAccessible::SoundPlayed0x0001Un objeto ha reproducido un sonido.
QAccessible::TableCaptionChanged0x0113Se ha modificado el título de una tabla.
QAccessible::TableColumnDescriptionChanged0x0114Se ha modificado la descripción de una columna de la tabla, que suele aparecer en el encabezado de la columna.
QAccessible::TableColumnHeaderChanged0x0115Se ha modificado el encabezado de una columna de la tabla.
QAccessible::TableRowDescriptionChanged0x0117Se ha modificado la descripción de una fila de la tabla, que suele aparecer en el encabezado de la fila.
QAccessible::TableRowHeaderChanged0x0118Se ha modificado el encabezado de una fila de la tabla.
QAccessible::TableSummaryChanged0x0119Se ha modificado el resumen de una tabla.
QAccessible::TextColumnChanged0x011DSe ha modificado una columna de texto.
QAccessible::VisibleDataChanged0x0122 

Los valores de esta enumeración se definen de forma que sean los mismos que los definidos en las especificaciones IAccessible2 y MSAA.

QAccessible::Id

Sinónimo de «sin signo», utilizado por la caché del « QAccessibleInterface ».

QAccessible::InterfaceFactory

Se trata de un `typedef` para un puntero a una función con la siguiente firma:

typedef QAccessibleInterface *myFactoryFunction(const QString &key, QObject *);

La función recibe un puntero QString y un puntero QObject, donde el QString es la clave que identifica la interfaz. El QObject se utiliza para pasarlo al QAccessibleInterface, de modo que este pueda mantener una referencia al mismo.

Si la clave y el QObject no tienen un QAccessibleInterface correspondiente, se devolverá nullptr.

queryAccessibilityInterface() invoca las fábricas instaladas hasta que una de ellas proporcione una interfaz.

enum QAccessible::InterfaceType

QAccessibleInterface admite varias subinterfaces. Para proporcionar más información sobre algunos objetos, su representación accesible debe implementar una o varias de estas interfaces.

Nota: Al crear una subclase de una de estas interfaces, es necesario implementar el método QAccessibleInterface::interface_cast().

ConstanteValorDescripción
QAccessible::TextInterface0Para texto que admite selecciones o que tiene más de una línea. Las etiquetas simples no necesitan implementar esta interfaz.
QAccessible::ValueInterface2Para objetos que se utilizan para manipular un valor, por ejemplo, un control deslizante o una barra de desplazamiento.
QAccessible::ActionInterface3Para objetos interactivos que permiten al usuario activar una acción. Básicamente, todo lo que permita, por ejemplo, la interacción con el ratón.
QAccessible::TableInterface5Para listas, tablas y árboles.
QAccessible::TableCellInterface6Para celdas de un objeto TableInterface.
QAccessible::HyperlinkInterface7Para nodos de hipervínculo (normalmente incrustados como hijos de nodos de texto).
QAccessible::SelectionInterface (since Qt 6.5)8Para objetos que no sean de texto y que admitan la selección de objetos hijos.
QAccessible::AttributesInterface (since Qt 6.8)9Para objetos que admiten atributos específicos del objeto.
QAccessible::ViewportInterface (since Qt 6.12)10Para objetos que permiten el desplazamiento bidimensional o indexado.

Véase también QAccessibleInterface::interface_cast(), QAccessibleTextInterface, QAccessibleValueInterface, QAccessibleActionInterface, QAccessibleTableInterface, QAccessibleTableCellInterface, QAccessibleSelectionInterface, QAccessibleAttributesInterface y QAccessibleViewportInterface.

enum QAccessible::RelationFlag
flags QAccessible::Relation

Este tipo de enumeración define indicadores binarios que pueden combinarse para indicar la relación entre dos objetos accesibles. Lo utiliza la función `relations()`, que devuelve una lista de todas las interfaces relacionadas con el objeto que realiza la llamada, junto con las relaciones de cada objeto.

Cada entrada de la lista es un std::pair en el que el miembro second almacena el tipo o tipos de relación entre el objeto returned representado por el miembro first y la interfaz u objeto origin (el llamante).

En la tabla siguiente, el objeto returned hace referencia al objeto de la lista devuelta, y el objeto origin es el representado por la interfaz de llamada.

ConstanteValorDescripción
QAccessible::Label0x00000001El objeto « returned » es la etiqueta del objeto « origin ».
QAccessible::Labelled0x00000002El objeto returned está etiquetado por el objeto origin.
QAccessible::Controller0x00000004El objeto « returned » controla el objeto « origin ».
QAccessible::Controlled0x00000008El objeto « returned » está controlado por el objeto « origin ».
QAccessible::DescriptionFor (since Qt 6.6)0x00000010El objeto « returned » proporciona una descripción del objeto « origin ».
QAccessible::Described (since Qt 6.6)0x00000020El objeto « returned » es descrito por el objeto « origin ».
QAccessible::FlowsFrom (since Qt 6.6)0x00000040El contenido fluye lógicamente desde el objeto « returned » hacia el objeto « origin ».
QAccessible::FlowsTo (since Qt 6.6)0x00000080El contenido fluye lógicamente hacia el objeto « returned » desde el objeto « origin ».
QAccessible::AllRelations0xffffffffSe utiliza como máscara para especificar que nos interesa la información sobre todas las relaciones

Las implementaciones de `relations()` devuelven una combinación de estos indicadores. Algunos valores son mutuamente excluyentes.

El tipo «Relation» es un typedef para QFlags<RelationFlag>. Almacena una combinación OR de valores de RelationFlag.

enum QAccessible::Role

Esta enumeración define la función de un objeto accesible. Las funciones son:

ConstanteValorDescripción
QAccessible::AlertMessage0x00000008Un objeto que se utiliza para alertar al usuario.
QAccessible::Animation0x00000036Un objeto que muestra una animación.
QAccessible::Application0x0000000EUn objeto que representa la aplicación
QAccessible::Assistant0x00000020Un objeto que proporciona ayuda interactiva.
QAccessible::BlockQuote (since Qt 6.9)0x431Una sección de contenido citada de otra fuente.
QAccessible::Border0x00000013Un objeto que representa un borde.
QAccessible::ButtonDropDown0x00000038Un botón que despliega una lista de elementos.
QAccessible::ButtonDropGrid0x0000003AUn botón que despliega una cuadrícula.
QAccessible::ButtonMenu0x00000039Un botón que despliega un menú.
QAccessible::Canvas0x00000035Un objeto que muestra gráficos con los que el usuario puede interactuar.
QAccessible::Caret0x00000007Un objeto que representa el cursor del sistema (cursor de texto).
QAccessible::Cell0x0000001DUna celda de una tabla.
QAccessible::Chart0x00000011Un objeto que muestra una representación gráfica de los datos.
QAccessible::CheckBox0x0000002CUn objeto que representa una opción que se puede marcar o desmarcar. Algunas opciones admiten un estado «mixto», es decir, ni marcada ni desmarcada.
QAccessible::Client0x0000000AEl área de cliente de una ventana.
QAccessible::Clock0x0000003DUn reloj que muestra la hora.
QAccessible::ColorChooser0x404Un cuadro de diálogo que permite al usuario elegir un color.
QAccessible::Column0x0000001BUna columna de celdas, normalmente dentro de una tabla.
QAccessible::ColumnHeader0x00000019Un encabezado para una columna de datos.
QAccessible::ComboBox0x0000002EUna lista de opciones entre las que el usuario puede elegir.
QAccessible::ComplementaryContent0x42CUna parte del documento o de la página web que complementa el contenido principal, normalmente un punto de referencia (véase WAI-ARIA).
QAccessible::Cursor0x00000006Un objeto que representa el cursor del ratón.
QAccessible::Desktop0x00000082El objeto representa el escritorio o el espacio de trabajo.
QAccessible::Dial0x00000031Un objeto que representa un dial o un mando.
QAccessible::Dialog0x00000012Un cuadro de diálogo.
QAccessible::Document0x0000000FUn documento, por ejemplo, en una aplicación ofimática.
QAccessible::EditableText0x0000002ATexto editable, como una línea o un campo de texto.
QAccessible::Equation0x00000037Un objeto que representa una ecuación matemática.
QAccessible::Footer0x40EUn pie de página en una página (normalmente en documentos).
QAccessible::Form0x410Un formulario web que contiene controles.
QAccessible::Graphic0x00000028Un gráfico o una imagen, por ejemplo, un icono.
QAccessible::Grip0x00000004Un controlador que el usuario puede arrastrar para cambiar el tamaño de los widgets.
QAccessible::Grouping0x00000014Un objeto que representa una agrupación lógica de otros objetos.
QAccessible::Heading0x414Un encabezado en un documento.
QAccessible::HelpBalloon0x0000001FUn objeto que muestra ayuda en una ventana independiente y de corta duración.
QAccessible::HotkeyField0x00000032Un campo de teclas de acceso rápido que permite al usuario introducir una secuencia de teclas.
QAccessible::Indicator0x00000027Un indicador que representa un valor o elemento actual.
QAccessible::LayeredPane0x00000080Un objeto que puede contener elementos secundarios en capas, por ejemplo, en una pila.
QAccessible::Link0x0000001EUn enlace a otro elemento.
QAccessible::List0x00000021Una lista de elementos, de la que el usuario puede seleccionar uno o varios.
QAccessible::ListItem0x00000022Un elemento de una lista de elementos.
QAccessible::MenuBar0x00000002Una barra de menús desde la que el usuario abre los menús.
QAccessible::MenuItem0x0000000CUn elemento de un menú o de una barra de menús.
QAccessible::NoRole0x00000000El objeto no tiene ninguna función. Esto suele indicar que se trata de un objeto no válido.
QAccessible::Note0x41BUna sección cuyo contenido es secundario o complementario al contenido principal del recurso.
QAccessible::Notification0x00000086Un objeto que representa una notificación (por ejemplo, en la bandeja del sistema). Esta función solo tiene efecto en Linux.
QAccessible::PageTab0x00000025Una pestaña de página que el usuario puede seleccionar para cambiar a otra página en un cuadro de diálogo.
QAccessible::PageTabList0x0000003CUna lista de pestañas de página.
QAccessible::Paragraph0x00000083Un párrafo de texto (que suele encontrarse en documentos).
QAccessible::Pane0x00000010Un contenedor genérico.
QAccessible::PopupMenu0x0000000BUn menú que muestra una lista de opciones que el usuario puede seleccionar para realizar una acción.
QAccessible::ProgressBar0x00000030El objeto muestra el progreso de una operación en curso.
QAccessible::PropertyPage0x00000026Una página de propiedades en la que el usuario puede modificar opciones y ajustes.
QAccessible::Button0x0000002BUn botón.
QAccessible::RadioButton0x0000002DUn objeto que representa una opción que es mutuamente excluyente con otras opciones.
QAccessible::Row0x0000001CUna fila de celdas, normalmente dentro de una tabla.
QAccessible::RowHeader0x0000001AUn encabezado para una fila de datos.
QAccessible::ScrollBar0x00000003Una barra de desplazamiento que permite al usuario desplazarse por el área visible.
QAccessible::Section0x00000085Una sección (en un documento).
QAccessible::Separator0x00000015Un separador que divide el espacio en áreas lógicas.
QAccessible::Slider0x00000033Un control deslizante que permite al usuario seleccionar un valor dentro de un rango determinado.
QAccessible::Sound0x00000005Un objeto que representa un sonido.
QAccessible::SpinBox0x00000034Un control de campo giratorio que permite al usuario introducir un valor dentro de un rango determinado.
QAccessible::Splitter0x0000003EUn divisor que distribuye el espacio disponible entre sus widgets secundarios.
QAccessible::StaticText0x00000029Texto estático, como etiquetas para otros widgets.
QAccessible::StatusBar0x00000017Una barra de estado.
QAccessible::Switch (since Qt 6.11)0x00000087Un interruptor que se puede activar o desactivar.
QAccessible::Table0x00000018Una tabla que representa datos en una cuadrícula de filas y columnas.
QAccessible::Terminal0x00000081Un terminal o una interfaz de línea de comandos.
QAccessible::TitleBar0x00000001El texto de la barra de título de una ventana.
QAccessible::ToolBar0x00000016Una barra de herramientas que agrupa los controles a los que el usuario accede con frecuencia.
QAccessible::ToolTip0x0000000DUna información sobre herramientas que proporciona datos sobre otros objetos.
QAccessible::Tree0x00000023Una lista de elementos en una estructura de árbol.
QAccessible::TreeItem0x00000024Un elemento de una estructura de árbol.
QAccessible::UserRole0x0000ffffEl primer valor que se utilizará para los roles definidos por el usuario.
QAccessible::WebDocument0x00000084Documento HTML, normalmente en un navegador.
QAccessible::Whitespace0x0000003BEspacio en blanco entre otros objetos.
QAccessible::Window0x00000009Una ventana de nivel superior.

enum QAccessible::Text

Esta enumeración especifica la información en forma de cadena que devuelve un objeto accesible.

ConstanteValorDescripción
QAccessible::Name0El nombre del objeto. Los clientes accesibles pueden utilizarlo tanto como identificador como para una breve descripción.
QAccessible::Description1Un texto breve que describe el objeto.
QAccessible::Value2El valor del objeto.
QAccessible::Help3Un texto más extenso que proporciona información sobre cómo utilizar el objeto.
QAccessible::Accelerator4El atajo de teclado que ejecuta la acción predeterminada del objeto.
QAccessible::UserText0x0000ffffEl primer valor que se utilizará para el texto definido por el usuario.
QAccessible::Identifier (since Qt 6.8)6Un identificador del objeto, por ejemplo, para pruebas de interfaz de usuario.

enum QAccessible::TextBoundaryType

Esta enumeración describe los diferentes tipos de límites de texto. Sigue la API IAccessible2 y se utiliza en el método QAccessibleTextInterface.

ConstanteValorDescripción
QAccessible::CharBoundary0Utiliza caracteres individuales como límites.
QAccessible::WordBoundary1Utiliza palabras como límites.
QAccessible::SentenceBoundary2Utilizar frases como delimitadores.
QAccessible::ParagraphBoundary3Utilizar párrafos como delimitadores.
QAccessible::LineBoundary4Utilizar saltos de línea como delimitadores.
QAccessible::NoBoundary5Sin delimitador (utiliza todo el texto).

Véase también QAccessibleTextInterface.

Documentación de funciones de miembro

[static] QAccessibleInterface *QAccessible::accessibleInterface(QAccessible::Id id)

Devuelve el objeto ` QAccessibleInterface ` asociado a ` id`.

Devuelve nullptr si el id no es válido.

[static] void QAccessible::deleteAccessibleInterface(QAccessible::Id id)

Elimina de la caché la interfaz asociada a este id y la borra. El identificador deja de ser válido y la caché puede reutilizarlo.

[static] void QAccessible::installFactory(QAccessible::InterfaceFactory factory)

Instala el InterfaceFactory factory . La última fábrica añadida es la primera que utiliza queryAccessibleInterface().

[static] bool QAccessible::isActive()

Devuelve ` true ` si la plataforma ha solicitado información de accesibilidad.

Esta función devolverá «false» hasta que una herramienta, como un lector de pantalla, acceda al marco de accesibilidad. Sigue siendo posible utilizar ` QAccessible::queryAccessibleInterface()` aunque la accesibilidad no esté activa. Sin embargo, no se enviarán notificaciones a la plataforma.

Se recomienda utilizar esta función para evitar notificaciones costosas a través de ` updateAccessibility()` cuando no sean necesarias.

[static] QAccessibleInterface *QAccessible::queryAccessibleInterface(QObject *object)

Si existe una implementación de ` QAccessibleInterface ` para el ` object` dado, esta función devuelve un puntero a dicha implementación; en caso contrario, devuelve ` nullptr`.

La función llama a todas las funciones de fábrica instaladas (desde la instalada más recientemente hasta la instalada hace más tiempo) hasta que encuentra una que proporcione una interfaz para la clase object. Si ninguna función de fábrica puede proporcionar una implementación de accesibilidad para la clase, la función carga los complementos de accesibilidad instalados y comprueba si alguno de ellos puede proporcionar la implementación.

Si no hay ninguna implementación disponible para la clase del objeto, la función intenta encontrar una implementación para la clase padre del objeto, utilizando la estrategia anterior.

Todas las interfaces se gestionan mediante una caché interna y no deben eliminarse.

[static] QAccessible::Id QAccessible::registerAccessibleInterface(QAccessibleInterface *iface)

Llama a esta función para garantizar que las interfaces creadas manualmente se gestionen correctamente en cuanto a la memoria.

Solo debe llamarse exactamente una vez por interfaz iface. Se llama de forma implícita al llamar a queryAccessibleInterface; solo es necesario llamar a esta función cuando se instancian QAccessibleInterfaces con el operador «new». Esto no es recomendable; siempre que sea posible, utilice las funciones predeterminadas y deje que queryAccessibleInterface() se encargue de ello.

Cuando sea necesario reimplementar la función QAccessibleInterface::child() y devolver el elemento hijo tras construirlo, deberá llamarse a esta función.

[static] void QAccessible::removeFactory(QAccessible::InterfaceFactory factory)

Elimina « factory » de la lista de InterfaceFactories instaladas.

[static] void QAccessible::setRootObject(QObject *object)

Establece el objeto raíz de los objetos accesibles de esta aplicación en object. Se puede acceder a todos los demás objetos accesibles mediante la navegación por objetos desde el objeto raíz.

Normalmente, no es necesario llamar a esta función, ya que Qt establece el objeto QApplication como objeto raíz inmediatamente antes de entrar en el bucle de eventos en QApplication::exec().

Utiliza QAccessible::installRootObjectHandler() para redirigir la llamada a la función a una función de controladora personalizada.

Véase también queryAccessibleInterface().

[static] QAccessible::Id QAccessible::uniqueId(QAccessibleInterface *iface)

Devuelve el identificador único de QAccessibleInterface iface .

[static] void QAccessible::updateAccessibility(QAccessibleEvent *event)

Informa de un cambio que podría ser relevante para los usuarios de herramientas de accesibilidad.

event Proporciona detalles sobre el cambio. Entre ellos se incluyen el origen del cambio y la naturaleza del mismo. El event debe contener información suficiente para que las notificaciones sean significativas.

Por ejemplo, el tipo « ValueChange » indica que se ha modificado la posición de un control deslizante.

Llama a esta función siempre que se haya modificado el estado de tu objeto accesible o de uno de sus subelementos, ya sea mediante programación (por ejemplo, llamando a ` QLabel::setText()`) o por interacción del usuario.

Si no hay herramientas de accesibilidad a la espera de este evento, la pérdida de rendimiento al llamar a esta función es mínima; sin embargo, si determinar los parámetros de la llamada supone un coste elevado, puede comprobar QAccessible::isActive() para evitar cálculos innecesarios.

© 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.