Patrón de control TextChild

Presenta instrucciones y convenciones para implementar ITextChildProvider, incluida información sobre las propiedades y los métodos. El patrón de control TextChild se usa para tener acceso al antecesor más cercano de un elemento que admite el patrón de control Text .

Por ejemplo, supongamos que el texto de un documento contiene una imagen incrustada y un hipervínculo, como se muestra en la imagen siguiente.

Si usa herramientas de Microsoft Automatización de la interfaz de usuario para examinar el árbol de Automatización de la interfaz de usuario para este contenido del documento, puede mostrar un elemento de documento con un elemento secundario que represente la imagen y otro elemento secundario que represente el hipervínculo. Por ejemplo:

Normalmente, el elemento document del ejemplo anterior admite el patrón de control Text , pero los dos elementos secundarios del elemento de documento no lo hacen. Si una aplicación cliente Automatización de la interfaz de usuario tiene una referencia al elemento de imagen o al elemento hyperlink, el cliente puede usar el patrón de control TextChild como una manera cómoda de acceder al patrón Textcontrol expuesto por el elemento de documento contenedor.

Directrices y convenciones de implementación

Al implementar la interfaz ITextChildProvider , tenga en cuenta las siguientes directrices y convenciones:

• La propiedad ITextChildProvider::TextContainer debe especificar el elemento antecesor más cercano que admita la interfaz ITextProvider , independientemente de si los elementos superiores en la cadena antecesora también admiten ITextProvider.
• Un elemento no debe admitir la interfazITextProvider y ITextChildProvider** .
• Un elemento que implementa ITextChildProvider debe ser secundario o descendiente de un elemento que implementa ITextProvider. No es necesario que este elemento también implemente el patrón de control Text.
• La propiedad ITextChildProvider::TextRange debe especificar el mismo intervalo de texto que el elemento de proveedor de texto contenedor devuelve cuando se llama a su función ITextProvider::RangeFromChild con el elemento secundario de texto como elemento secundario incluido.

Miembros necesarios para ITextChildProvider

Estas propiedades y métodos son necesarios para implementar la interfaz ITextChildProvider .

Miembros requeridos	Tipo de miembro	Notas
TextContainer	Propiedad	None
Textrange	Propiedad	None

 

Este patrón de control no tiene métodos o propiedades asociados.

Temas relacionados

Conceptual

• Tipos de control y sus patrones de control admitidos
• Información general acerca de los patrones de control de UI Automation
• Información general sobre el árbol de la UI Automation