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 .

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 de Padrões de Controle de Automação de Interface de Usuário
• Visão geral da árvore de automação de interface do usuário