Compartilhar via


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 dá suporte ao padrão de controle Text .

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

captura de tela mostrando o texto que contém uma imagem inserida e um hiperlink

Se você usar as ferramentas do Microsoft Automação da Interface do Usuário para examinar a árvore de Automação da Interface do Usuário deste conteúdo do documento, ela poderá mostrar um elemento de documento com um elemento filho que representa a imagem e outro elemento filho que representa o hiperlink. Por exemplo:

captura de tela mostrando inspecionar relatando uma árvore de elementos de automação de interface do usuário de exemplo

Normalmente, o elemento document no exemplo anterior dá suporte ao padrão de controle Text , mas os dois filhos do elemento document não. Se um aplicativo cliente Automação da Interface do Usuário tiver uma referência ao elemento de imagem ou ao 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 o contém.

Diretrizes e convenções de implementação

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

Membros necessários para ITextChildProvider

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

Membros necessários Tipo de membro Observações
TextContainer Propriedade Nenhum
Textrange Propriedade Nenhum

 

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

Conceitual