Padrão de controle TextChild

Apresenta diretrizes e convenções para implementar ITextChildProvider, incluindo informações sobre propriedades e métodos. O padrão de controle TextChild é usado para acessar o ancestral mais próximo de um elemento que suporta o padrão de controle Text.

Por exemplo, suponha que o texto em um documento contenha uma imagem incorporada e um hiperlink, conforme mostrado na imagem a seguir.

Se você usar as ferramentas de automação da interface do usuário da Microsoft para examinar a árvore de automação da interface do usuário para o conteúdo deste documento, ele pode mostrar um elemento de documento com um elemento filho que representa a imagem e outro elemento filho que representa o hiperlink. Por exemplo:

Normalmente, o elemento document no exemplo anterior oferece suporte ao padrão de controle Text, mas os dois filhos do elemento document não. Se um aplicativo cliente de Automação da Interface do Usuário tiver uma referência ao elemento image ou elemento de hiperlink, o cliente poderá usar o padrão de controle TextChild como uma maneira conveniente de acessar o padrão Textcontrol exposto pelo elemento de documento que contém.

Orientações e convenções de aplicação

Ao implementar o ITextChildProvider interface, observe as seguintes diretrizes e convenções:

• A propriedade ITextChildProvider::TextContainer deve especificar o elemento ancestral mais próximo que suporta interface ITextProvider, independentemente de elementos mais altos na cadeia ancestral também suportarem ITextProvider.
• Um elemento não deve suportar oITextProvidere a interface ITextChildProvider**.
• Um elemento que implementa ITextChildProvider deve ser filho ou descendente de um elemento que implementa ITextProvider. Não é necessário que esse elemento também implemente o padrão de controle Text.
• A propriedadeITextChildProvider::TextRange deve especificar o mesmo intervalo de texto que o elemento do provedor de texto que contém retorna quando sua função ITextProvider::RangeFromChild é chamada com o elemento filho de texto como o elemento filho incluído.

Membros necessários para ITextChildProvider

Essas propriedades e métodos são necessários para implementar o ITextChildProvider interface.

Esse padrão de controle não tem métodos ou eventos associados.

Tópicos relacionados

Conceptual

• tipos de controle e seus padrões de controle suportados
• Visão geral dos padrões de controle de automação da interface do do usuário
• Visão geral da árvore de automação da interface do usuário