Compartir a través de


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

Recupera una colección de todos los elementos contenidos (parcial o completamente) dentro del intervalo de texto especificado y son elementos secundarios del elemento envolvente para el intervalo de texto especificado.

Sintaxis

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

Parámetros

[out, retval] pRetVal

Tipo: SAFEARRAY**

Matriz de punteros a las interfaces IRawElementProviderSimple para todos los elementos secundarios que se incluyen en el intervalo de texto (ordenados por el punto de conexión Start de sus intervalos).

Si el intervalo de texto no incluye ningún elemento secundario, se devuelve una colección vacía.

Este parámetro se pasa sin inicializar.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Cada elemento recuperado con ITextRangeProvider::GetChildren tiene un intervalo de texto válido que se puede recuperar a través de RangeFromChild. Esto incluye todos los elementos del árbol Automatización de la interfaz de usuario entre ITextProvider y el elemento secundario.

Ejemplos

  1. En este ejemplo se muestra una secuencia de texto que contiene un vínculo de imagen. El vínculo es un elemento secundario de la imagen, pero ambos abarcan el mismo intervalo de texto y se exponen como objetos incrustados dentro de la secuencia de texto.

    Hello <Image Link> World

  2. En este ejemplo se muestra una secuencia de texto que contiene una tabla de dos celdas rodeada de texto.

    Texto de inicio

    Celda de tabla 1Celda de tabla 2

    Texto final

Requisitos

   
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado uiautomationcore.h (include UIAutomation.h)

Consulte también

ITextProvider, ITextRangeProvider, GetEnclosingElement, ITextProvider::RangeFromChild, Automatización de la interfaz de usuario Providers Overview, Best Practices for Using Safe Arrays