Share via


Descripción del modelo de objetos de texto de Automatización de la interfaz de usuario

En este tema se describe cómo Microsoft Automatización de la interfaz de usuario aplicaciones cliente acceden al contenido textual de un control basado en texto.

Los controles basados en texto exponen contenido textual a Automatización de la interfaz de usuario aplicaciones cliente a través de un modelo de objetos de texto simple. Las aplicaciones cliente tienen acceso al modelo de objetos de texto a través de las interfaces de patrón de control Text y TextRange , incluidos IUIAutomationTextPattern e IUIAutomationTextRange. Las aplicaciones cliente pueden usar estas interfaces para recuperar contenido textual, atributos de texto y objetos incrustados, como tablas e hipervínculos de controles basados en texto.

Los tipos de control que admiten el modelo de objetos de texto de Automatización de la interfaz de usuario incluyen los tipos de control Edit y Document. Otros tipos de control, como información sobre herramientas y texto , también pueden admitir el modelo de objetos de texto, pero no son necesarios para.

Nota

El modelo de objetos de texto Automatización de la interfaz de usuario no proporciona un medio para insertar o modificar texto. Sin embargo, algunos controles permiten insertar o modificar texto a través de la interfaz IUIAutomationValuePattern o a través de la entrada directa del teclado.

 

Modelo de objetos específico del control

Un control basado en texto que implementa su propio modelo de objetos de documento (DOM) puede exponer el DOM implementando el patrón de control ObjectModel . Exponer el DOM puede dar a las aplicaciones cliente un mayor acceso y control sobre el contenido de un control basado en texto.

Una aplicación cliente puede detectar si un control basado en texto determinado implementa un DOM recuperando la interfaz IUIAutomationElement del control. A continuación, llame al método IUIAutomationElement::GetCurrentPropertyValue , especificando el identificador de propiedad UIA_IsObjectModelPatternAvailablePropertyId y una variante que recibe TRUE si el control implementa un DOM.

Para acceder al DOM, llame al método IUIAutomationElement::GetCurrentPattern , especificando el identificador de patrón de control UIA_ObjectModelPatternId y una variable que recibe la interfaz IUIAutomationObjectModelPattern . Llame al método IUIAutomationObjectModelPattern::GetUnderlyingObjectModel para recuperar la interfaz DOM.

Patrones de control Text y TextRange

compatibilidad de Automatización de la interfaz de usuario con contenido textual

Trabajar con controles basados en texto