Compartilhar via


Método ITextRangeProvider::GetChildren (uiautomationcore.h)

Recupera uma coleção de todos os elementos contidos (parcial ou completamente) dentro do intervalo de texto especificado e são elementos filho do elemento delimitador para o intervalo de texto especificado.

Sintaxe

HRESULT GetChildren(
  [out, retval] SAFEARRAY **pRetVal
);

Parâmetros

[out, retval] pRetVal

Tipo: SAFEARRAY**

Uma matriz de ponteiros para as interfaces IRawElementProviderSimple para todos os elementos filho incluídos pelo intervalo de texto (classificado pelo ponto de extremidade Iniciar de seus intervalos).

Se o intervalo de texto não incluir nenhum elemento filho, uma coleção vazia será retornada.

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.

Comentários

Cada elemento recuperado com ITextRangeProvider::GetChildren 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

   
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, GetEnclosingElement, ITextProvider::RangeFromChild, visão geral dos provedores de Automação da Interface do Usuário, práticas recomendadaspara usar matrizes seguras