Compartir a través de

Método IUIAutomationTextRange3::GetChildrenBuildCache (uiautomationclient.h)

  • Artículo

Devuelve los elementos secundarios y las propiedades y patrones proporcionados para los elementos de un intervalo de texto en una sola llamada entre procesos. Esto equivale a llamar a GetChildren, pero agrega el patrón de caché de compilación estándar.

Sintaxis

HRESULT GetChildrenBuildCache(
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElementArray **children
);

Parámetros

[in] cacheRequest

IUIAutomationCacheRequest que especifica las propiedades y los patrones de control que se van a almacenar en caché.

[out, retval] children

Devuelve los elementos secundarios y las propiedades o patrones de cada elemento secundario del intervalo de texto que cumplen los criterios de cacheRequest proporcionados.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente; de lo contrario, devuelve un código de error HRESULT .

Comentarios

Siguiendo el diseño de GetChildren:

  • También se incluirán elementos secundarios que se superpongan con el intervalo de texto, pero que no están completamente incluidos.
  • Cuando no existen elementos secundarios, se devuelve una colección vacía.
Como resultado de una llamada correcta, los clientes Automatización de la interfaz de usuario pueden llamar a las API "Cached" de IUIAutomationElement que se proporcionan en cacheRequest, por ejemplo, IUIAutomationElement::GetCachedPropertyValue.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1703 [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado uiautomationclient.h (include UIAutomation.h)

Consulte también

IUIAutomationTextRange3

compatibilidad de Automatización de la interfaz de usuario con contenido textual