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 Automatización de la interfaz de usuario de Microsoft para examinar el árbol de automatización de la interfaz de usuario de este contenido de documento, podría 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 de documento 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 de 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 interfazITextChildProvider, tenga en cuenta las siguientes directrices y convenciones:

• La propiedad ITextChildProvider::TextContainer debe especificar el elemento antecesor más cercano que admita interfaz ITextProvider, independientemente de si los elementos superiores en la cadena antecesor también admiten ITextProvider.
• Un elemento no debe admitir tanto elITextProvider como la interfaz ITextChildProvider**.
• Un elemento que implementa ITextChildProvider debe ser secundario o descendiente de un elemento que implementa ITextProvider. No es necesario que este elemento implemente también 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 interfazITextChildProvider.

Miembros necesarios	Tipo de miembro	Notas
TextContainer	Propiedad	Ninguno
TextRange	Propiedad	Ninguno

 

Este patrón de control no tiene métodos ni eventos asociados.

Temas relacionados

conceptual de

• tipos de control y sus patrones de control admitidos
• Introducción a los patrones de control de automatización de la interfaz de usuario de
• Información general del árbol de automatización de la interfaz de usuario de