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 de Texto.

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 de Automação da Interface do Usuário da Microsoft para examinar a árvore de Automação da Interface do Usuário para este 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 de documento no exemplo anterior dá suporte ao padrão de controle Texto, mas os dois filhos do elemento de documento não. Se um aplicativo cliente de Automação de 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 contém.

Diretrizes e convenções de implementação

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

  • A propriedade ITextChildProvider::TextContainer deve especificar o elemento ancestral mais próximo que dá suporte a interface ITextProvider, independentemente de os elementos mais altos na cadeia ancestral também oferecerem suporte a ITextProvider.
  • Um elemento não deve dar suporte aoITextProvidere à interface de ITextChildProvider**.
  • Um elemento que implementa ITextChildProvider deve ser um filho ou descendente de um elemento que implementa ITextProvider. Não é necessário que esse elemento implemente também o padrão de controle de texto .
  • A propriedade ITextChildProvider::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 delimitado.

Membros necessários para ITextChildProvider

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

Membros necessários Tipo de membro Anotações
TextContainer Propriedade Nenhum
TextRange Propriedade Nenhum

 

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

Conceitual