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.
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:
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:
- A propriedade ITextChildProvider::TextContainer deve especificar o elemento ancestral mais próximo que dá suporte à interface ITextProvider , independentemente de os elementos mais altos na cadeia ancestral também oferecerem suporte a ITextProvider.
- Um elemento não deve dar suporte à interfaceITextProvider e 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 também implemente o padrão de controle 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 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.
Tópicos relacionados
Conceitual