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 |
- Lista de todos los miembros, incluidos los heredados
- QAccessible forma parte de las clases de accesibilidad.
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.
| Constante | Valor | Descripción |
|---|---|---|
QAccessible::AnnouncementPoliteness::Polite | 0 | El anuncio tiene prioridad normal. |
QAccessible::AnnouncementPoliteness::Assertive | 1 | El 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.
| Constante | Valor | Descripción |
|---|---|---|
QAccessible::Attribute::Custom | 0 | Tipo 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::Level | 1 | tipo 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) | 2 | tipo 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) | 3 | Tipo 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.
| Constante | Valor | Descripción |
|---|---|---|
QAccessible::AcceleratorChanged | 0x80C0 | Se ha modificado el atajo de teclado de una acción. |
QAccessible::ActionChanged | 0x0101 | Se ha modificado una acción. |
QAccessible::ActiveDescendantChanged | 0x0102 | |
QAccessible::Alert | 0x0002 | Se ha producido una alerta del sistema (por ejemplo, un mensaje de QMessageBox) |
QAccessible::Announcement (since Qt 6.8) | 0x80D0 | Se ha solicitado el anuncio de un mensaje. |
QAccessible::AttributeChanged | 0x0103 | |
QAccessible::ContextHelpEnd | 0x000D | Se ha finalizado la ayuda contextual (QWhatsThis) de un objeto. |
QAccessible::ContextHelpStart | 0x000C | Se inicia la ayuda contextual (QWhatsThis) para un objeto. |
QAccessible::DefaultActionChanged | 0x80B0 | Se ha modificado la acción predeterminada QAccessible::Action del objeto accesible. |
QAccessible::DescriptionChanged | 0x800D | Se ha modificado el QAccessible::Description del objeto. |
QAccessible::DialogEnd | 0x0011 | Se ha ocultado un cuadro de diálogo (QDialog). |
QAccessible::DialogStart | 0x0010 | Se ha hecho visible un cuadro de diálogo (QDialog). |
QAccessible::DocumentContentChanged | 0x0104 | El contenido de un documento de texto ha cambiado. |
QAccessible::DocumentLoadComplete | 0x0105 | Se ha cargado un documento. |
QAccessible::DocumentLoadStopped | 0x0106 | Se ha detenido la carga de un documento. |
QAccessible::DocumentReload | 0x0107 | Se ha iniciado la recarga de un documento. |
QAccessible::DragDropEnd | 0x000F | Una operación de arrastrar y soltar está a punto de finalizar. |
QAccessible::DragDropStart | 0x000E | Está a punto de iniciarse una operación de arrastrar y soltar. |
QAccessible::Focus | 0x8005 | Un objeto ha obtenido el foco del teclado. |
QAccessible::ForegroundChanged | 0x0003 | Se ha activado una ventana (es decir, una nueva ventana ha obtenido el foco en el escritorio). |
QAccessible::HelpChanged | 0x80A0 | La propiedad de texto « QAccessible::Help » de un objeto ha cambiado. |
QAccessible::HyperlinkEndIndexChanged | 0x0108 | Ha cambiado la posición final del texto de visualización de un enlace de hipertexto. |
QAccessible::HyperlinkNumberOfAnchorsChanged | 0x0109 | Ha 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::HyperlinkSelectedLinkChanged | 0x010A | El enlace del hipervínculo seleccionado ha cambiado. |
QAccessible::HyperlinkStartIndexChanged | 0x010D | Ha cambiado la posición inicial del texto visible de un enlace de hipertexto. |
QAccessible::HypertextChanged | 0x010E | El texto visible de un enlace de hipertexto ha cambiado. |
QAccessible::HypertextLinkActivated | 0x010B | Se ha activado un enlace de hipertexto, quizá al hacer clic en él o al pulsar una tecla. |
QAccessible::HypertextLinkSelected | 0x010C | Se ha seleccionado un enlace de hipertexto. |
QAccessible::HypertextNLinksChanged | 0x010F | |
QAccessible::IdentifierChanged (since Qt 6.8) | 0x80E0 | El identificador de un objeto ha cambiado. |
QAccessible::LocationChanged | 0x800B | Ha cambiado la ubicación de un objeto en la pantalla. |
QAccessible::MenuCommand | 0x0018 | Se ha activado un elemento del menú. |
QAccessible::MenuEnd | 0x0005 | Se ha cerrado un menú (Qt utiliza PopupMenuEnd para todos los menús). |
QAccessible::MenuStart | 0x0004 | Se ha abierto un menú en la barra de menús (Qt utiliza PopupMenuStart para todos los menús). |
QAccessible::NameChanged | 0x800C | La propiedad « QAccessible::Name » de un objeto ha cambiado. |
QAccessible::ObjectAttributeChanged | 0x0110 | |
QAccessible::ObjectCreated | 0x8000 | Se ha creado un nuevo objeto. |
QAccessible::ObjectDestroyed | 0x8001 | Se ha eliminado un objeto. |
QAccessible::ObjectHide | 0x8003 | Se 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::ObjectReorder | 0x8004 | Un diseño o una vista de elementos ha añadido, eliminado o movido un objeto (Qt no utiliza este evento). |
QAccessible::ObjectShow | 0x8002 | Se muestra un objeto; por ejemplo, con ` QWidget::show()`. |
QAccessible::PageChanged | 0x0111 | |
QAccessible::ParentChanged | 0x800F | El objeto padre de un objeto ha cambiado. |
QAccessible::PopupMenuEnd | 0x0007 | Se ha cerrado un menú emergente. |
QAccessible::PopupMenuStart | 0x0006 | Se ha abierto un menú emergente. |
QAccessible::RoleChanged (since Qt 6.11) | 0x80E1 | Ha cambiado la función de un objeto. |
QAccessible::ScrollingEnd | 0x0013 | Ha finalizado una operación de desplazamiento en una barra de desplazamiento (se ha soltado el control deslizante con el ratón). |
QAccessible::ScrollingStart | 0x0012 | Está 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) | 0x0014 | La posición ha cambiado durante una operación de desplazamiento. |
QAccessible::SectionChanged | 0x0112 | |
QAccessible::SelectionAdd | 0x8007 | Se ha añadido un elemento a la selección en una vista de elementos. |
QAccessible::SelectionRemove | 0x8008 | Se ha eliminado un elemento de la selección de una vista de elementos. |
QAccessible::Selection | 0x8006 | La selección ha cambiado en un menú o en una vista de elementos. |
QAccessible::SelectionWithin | 0x8009 | Se han producido varios cambios en una selección en una vista de elementos. |
QAccessible::SoundPlayed | 0x0001 | Un objeto ha reproducido un sonido. |
QAccessible::TableCaptionChanged | 0x0113 | Se ha modificado el título de una tabla. |
QAccessible::TableColumnDescriptionChanged | 0x0114 | Se ha modificado la descripción de una columna de la tabla, que suele aparecer en el encabezado de la columna. |
QAccessible::TableColumnHeaderChanged | 0x0115 | Se ha modificado el encabezado de una columna de la tabla. |
QAccessible::TableRowDescriptionChanged | 0x0117 | Se ha modificado la descripción de una fila de la tabla, que suele aparecer en el encabezado de la fila. |
QAccessible::TableRowHeaderChanged | 0x0118 | Se ha modificado el encabezado de una fila de la tabla. |
QAccessible::TableSummaryChanged | 0x0119 | Se ha modificado el resumen de una tabla. |
QAccessible::TextColumnChanged | 0x011D | Se ha modificado una columna de texto. |
QAccessible::VisibleDataChanged | 0x0122 |
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().
| Constante | Valor | Descripción |
|---|---|---|
QAccessible::TextInterface | 0 | Para texto que admite selecciones o que tiene más de una línea. Las etiquetas simples no necesitan implementar esta interfaz. |
QAccessible::ValueInterface | 2 | Para objetos que se utilizan para manipular un valor, por ejemplo, un control deslizante o una barra de desplazamiento. |
QAccessible::ActionInterface | 3 | Para 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::TableInterface | 5 | Para listas, tablas y árboles. |
QAccessible::TableCellInterface | 6 | Para celdas de un objeto TableInterface. |
QAccessible::HyperlinkInterface | 7 | Para nodos de hipervínculo (normalmente incrustados como hijos de nodos de texto). |
QAccessible::SelectionInterface (since Qt 6.5) | 8 | Para objetos que no sean de texto y que admitan la selección de objetos hijos. |
QAccessible::AttributesInterface (since Qt 6.8) | 9 | Para objetos que admiten atributos específicos del objeto. |
QAccessible::ViewportInterface (since Qt 6.12) | 10 | Para 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.
| Constante | Valor | Descripción |
|---|---|---|
QAccessible::Label | 0x00000001 | El objeto « returned » es la etiqueta del objeto « origin ». |
QAccessible::Labelled | 0x00000002 | El objeto returned está etiquetado por el objeto origin. |
QAccessible::Controller | 0x00000004 | El objeto « returned » controla el objeto « origin ». |
QAccessible::Controlled | 0x00000008 | El objeto « returned » está controlado por el objeto « origin ». |
QAccessible::DescriptionFor (since Qt 6.6) | 0x00000010 | El objeto « returned » proporciona una descripción del objeto « origin ». |
QAccessible::Described (since Qt 6.6) | 0x00000020 | El objeto « returned » es descrito por el objeto « origin ». |
QAccessible::FlowsFrom (since Qt 6.6) | 0x00000040 | El contenido fluye lógicamente desde el objeto « returned » hacia el objeto « origin ». |
QAccessible::FlowsTo (since Qt 6.6) | 0x00000080 | El contenido fluye lógicamente hacia el objeto « returned » desde el objeto « origin ». |
QAccessible::AllRelations | 0xffffffff | Se 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:
| Constante | Valor | Descripción |
|---|---|---|
QAccessible::AlertMessage | 0x00000008 | Un objeto que se utiliza para alertar al usuario. |
QAccessible::Animation | 0x00000036 | Un objeto que muestra una animación. |
QAccessible::Application | 0x0000000E | Un objeto que representa la aplicación |
QAccessible::Assistant | 0x00000020 | Un objeto que proporciona ayuda interactiva. |
QAccessible::BlockQuote (since Qt 6.9) | 0x431 | Una sección de contenido citada de otra fuente. |
QAccessible::Border | 0x00000013 | Un objeto que representa un borde. |
QAccessible::ButtonDropDown | 0x00000038 | Un botón que despliega una lista de elementos. |
QAccessible::ButtonDropGrid | 0x0000003A | Un botón que despliega una cuadrícula. |
QAccessible::ButtonMenu | 0x00000039 | Un botón que despliega un menú. |
QAccessible::Canvas | 0x00000035 | Un objeto que muestra gráficos con los que el usuario puede interactuar. |
QAccessible::Caret | 0x00000007 | Un objeto que representa el cursor del sistema (cursor de texto). |
QAccessible::Cell | 0x0000001D | Una celda de una tabla. |
QAccessible::Chart | 0x00000011 | Un objeto que muestra una representación gráfica de los datos. |
QAccessible::CheckBox | 0x0000002C | Un 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::Client | 0x0000000A | El área de cliente de una ventana. |
QAccessible::Clock | 0x0000003D | Un reloj que muestra la hora. |
QAccessible::ColorChooser | 0x404 | Un cuadro de diálogo que permite al usuario elegir un color. |
QAccessible::Column | 0x0000001B | Una columna de celdas, normalmente dentro de una tabla. |
QAccessible::ColumnHeader | 0x00000019 | Un encabezado para una columna de datos. |
QAccessible::ComboBox | 0x0000002E | Una lista de opciones entre las que el usuario puede elegir. |
QAccessible::ComplementaryContent | 0x42C | Una parte del documento o de la página web que complementa el contenido principal, normalmente un punto de referencia (véase WAI-ARIA). |
QAccessible::Cursor | 0x00000006 | Un objeto que representa el cursor del ratón. |
QAccessible::Desktop | 0x00000082 | El objeto representa el escritorio o el espacio de trabajo. |
QAccessible::Dial | 0x00000031 | Un objeto que representa un dial o un mando. |
QAccessible::Dialog | 0x00000012 | Un cuadro de diálogo. |
QAccessible::Document | 0x0000000F | Un documento, por ejemplo, en una aplicación ofimática. |
QAccessible::EditableText | 0x0000002A | Texto editable, como una línea o un campo de texto. |
QAccessible::Equation | 0x00000037 | Un objeto que representa una ecuación matemática. |
QAccessible::Footer | 0x40E | Un pie de página en una página (normalmente en documentos). |
QAccessible::Form | 0x410 | Un formulario web que contiene controles. |
QAccessible::Graphic | 0x00000028 | Un gráfico o una imagen, por ejemplo, un icono. |
QAccessible::Grip | 0x00000004 | Un controlador que el usuario puede arrastrar para cambiar el tamaño de los widgets. |
QAccessible::Grouping | 0x00000014 | Un objeto que representa una agrupación lógica de otros objetos. |
QAccessible::Heading | 0x414 | Un encabezado en un documento. |
QAccessible::HelpBalloon | 0x0000001F | Un objeto que muestra ayuda en una ventana independiente y de corta duración. |
QAccessible::HotkeyField | 0x00000032 | Un campo de teclas de acceso rápido que permite al usuario introducir una secuencia de teclas. |
QAccessible::Indicator | 0x00000027 | Un indicador que representa un valor o elemento actual. |
QAccessible::LayeredPane | 0x00000080 | Un objeto que puede contener elementos secundarios en capas, por ejemplo, en una pila. |
QAccessible::Link | 0x0000001E | Un enlace a otro elemento. |
QAccessible::List | 0x00000021 | Una lista de elementos, de la que el usuario puede seleccionar uno o varios. |
QAccessible::ListItem | 0x00000022 | Un elemento de una lista de elementos. |
QAccessible::MenuBar | 0x00000002 | Una barra de menús desde la que el usuario abre los menús. |
QAccessible::MenuItem | 0x0000000C | Un elemento de un menú o de una barra de menús. |
QAccessible::NoRole | 0x00000000 | El objeto no tiene ninguna función. Esto suele indicar que se trata de un objeto no válido. |
QAccessible::Note | 0x41B | Una sección cuyo contenido es secundario o complementario al contenido principal del recurso. |
QAccessible::Notification | 0x00000086 | Un objeto que representa una notificación (por ejemplo, en la bandeja del sistema). Esta función solo tiene efecto en Linux. |
QAccessible::PageTab | 0x00000025 | Una pestaña de página que el usuario puede seleccionar para cambiar a otra página en un cuadro de diálogo. |
QAccessible::PageTabList | 0x0000003C | Una lista de pestañas de página. |
QAccessible::Paragraph | 0x00000083 | Un párrafo de texto (que suele encontrarse en documentos). |
QAccessible::Pane | 0x00000010 | Un contenedor genérico. |
QAccessible::PopupMenu | 0x0000000B | Un menú que muestra una lista de opciones que el usuario puede seleccionar para realizar una acción. |
QAccessible::ProgressBar | 0x00000030 | El objeto muestra el progreso de una operación en curso. |
QAccessible::PropertyPage | 0x00000026 | Una página de propiedades en la que el usuario puede modificar opciones y ajustes. |
QAccessible::Button | 0x0000002B | Un botón. |
QAccessible::RadioButton | 0x0000002D | Un objeto que representa una opción que es mutuamente excluyente con otras opciones. |
QAccessible::Row | 0x0000001C | Una fila de celdas, normalmente dentro de una tabla. |
QAccessible::RowHeader | 0x0000001A | Un encabezado para una fila de datos. |
QAccessible::ScrollBar | 0x00000003 | Una barra de desplazamiento que permite al usuario desplazarse por el área visible. |
QAccessible::Section | 0x00000085 | Una sección (en un documento). |
QAccessible::Separator | 0x00000015 | Un separador que divide el espacio en áreas lógicas. |
QAccessible::Slider | 0x00000033 | Un control deslizante que permite al usuario seleccionar un valor dentro de un rango determinado. |
QAccessible::Sound | 0x00000005 | Un objeto que representa un sonido. |
QAccessible::SpinBox | 0x00000034 | Un control de campo giratorio que permite al usuario introducir un valor dentro de un rango determinado. |
QAccessible::Splitter | 0x0000003E | Un divisor que distribuye el espacio disponible entre sus widgets secundarios. |
QAccessible::StaticText | 0x00000029 | Texto estático, como etiquetas para otros widgets. |
QAccessible::StatusBar | 0x00000017 | Una barra de estado. |
QAccessible::Switch (since Qt 6.11) | 0x00000087 | Un interruptor que se puede activar o desactivar. |
QAccessible::Table | 0x00000018 | Una tabla que representa datos en una cuadrícula de filas y columnas. |
QAccessible::Terminal | 0x00000081 | Un terminal o una interfaz de línea de comandos. |
QAccessible::TitleBar | 0x00000001 | El texto de la barra de título de una ventana. |
QAccessible::ToolBar | 0x00000016 | Una barra de herramientas que agrupa los controles a los que el usuario accede con frecuencia. |
QAccessible::ToolTip | 0x0000000D | Una información sobre herramientas que proporciona datos sobre otros objetos. |
QAccessible::Tree | 0x00000023 | Una lista de elementos en una estructura de árbol. |
QAccessible::TreeItem | 0x00000024 | Un elemento de una estructura de árbol. |
QAccessible::UserRole | 0x0000ffff | El primer valor que se utilizará para los roles definidos por el usuario. |
QAccessible::WebDocument | 0x00000084 | Documento HTML, normalmente en un navegador. |
QAccessible::Whitespace | 0x0000003B | Espacio en blanco entre otros objetos. |
QAccessible::Window | 0x00000009 | Una ventana de nivel superior. |
enum QAccessible::Text
Esta enumeración especifica la información en forma de cadena que devuelve un objeto accesible.
| Constante | Valor | Descripción |
|---|---|---|
QAccessible::Name | 0 | El nombre del objeto. Los clientes accesibles pueden utilizarlo tanto como identificador como para una breve descripción. |
QAccessible::Description | 1 | Un texto breve que describe el objeto. |
QAccessible::Value | 2 | El valor del objeto. |
QAccessible::Help | 3 | Un texto más extenso que proporciona información sobre cómo utilizar el objeto. |
QAccessible::Accelerator | 4 | El atajo de teclado que ejecuta la acción predeterminada del objeto. |
QAccessible::UserText | 0x0000ffff | El primer valor que se utilizará para el texto definido por el usuario. |
QAccessible::Identifier (since Qt 6.8) | 6 | Un 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.
| Constante | Valor | Descripción |
|---|---|---|
QAccessible::CharBoundary | 0 | Utiliza caracteres individuales como límites. |
QAccessible::WordBoundary | 1 | Utiliza palabras como límites. |
QAccessible::SentenceBoundary | 2 | Utilizar frases como delimitadores. |
QAccessible::ParagraphBoundary | 3 | Utilizar párrafos como delimitadores. |
QAccessible::LineBoundary | 4 | Utilizar saltos de línea como delimitadores. |
QAccessible::NoBoundary | 5 | Sin 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.