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.
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:
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.
Tópicos relacionados
Conceitual
- tipos de controle e seus padrões de controle com suporte
- Visão geral dos padrões de controle de automação da interface do usuário
- Visão geral da árvore de automação da interface do usuário