Compartilhar via


Método ITextProvider::RangeFromChild (uiautomationcore.h)

Recupera um intervalo de texto que inclui o elemento filho especificado (por exemplo, uma imagem, hiperlink ou outro objeto inserido).

Sintaxe

HRESULT RangeFromChild(
  [in]          IRawElementProviderSimple *childElement,
  [out, retval] ITextRangeProvider        **pRetVal
);

Parâmetros

[in] childElement

Tipo: IRawElementProviderSimple*

O provedor Automação da Interface do Usuário do elemento filho especificado.

[out, retval] pRetVal

Tipo: ITextRangeProvider**

O intervalo de texto que inclui o elemento filho.

Esse intervalo inclui completamente o conteúdo do elemento filho de modo que:

  1. ITextRangeProvider::GetEnclosingElement retorna o próprio elemento filho ou o descendente mais interno do elemento filho que compartilha o mesmo intervalo de texto que o elemento filho
  2. ITextRangeProvider::GetChildren retorna filhos do elemento de (1) que estão completamente entre o intervalo
  3. Ambos os pontos de extremidade do intervalo estão nos limites do elemento filho

Este parâmetro é passado não inicializado.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Observação

E_INVALIDARG será retornado se childElement não for um descendente de um ITextProvider ou não estiver entre um intervalo de texto válido.

Comentários

Cada elemento recuperado com ITextRangeProvider::GetChildren também tem um intervalo de texto válido que pode ser recuperado por meio de RangeFromChild. Isso inclui todos os elementos na árvore Automação da Interface do Usuário entre o ITextProvider e o elemento filho.

Exemplos

  1. Este exemplo mostra um fluxo de texto que contém um link de imagem. O link é um filho da imagem, mas ambos abrangem o mesmo intervalo de texto e são expostos como objetos inseridos no fluxo de texto.

    Hello <Image Link> World

  2. Este exemplo mostra um fluxo de texto que contém uma tabela de duas células cercada por texto.

    Iniciar texto

    Célula da Tabela 1Célula da Tabela 2

    End Text

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho uiautomationcore.h (inclua UIAutomation.h)

Confira também

ITextProvider, ITextRangeProvider, ITextRangeProvider::GetEnclosingElement, ITextRangeProvider::GetChildren, Automação da Interface do Usuário Providers Overview