Compartir a través de


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

Devuelve el elemento más interno que incluye el intervalo de texto especificado.

Sintaxis

HRESULT GetEnclosingElement(
  [out, retval] IRawElementProviderSimple **pRetVal
);

Parámetros

[out, retval] pRetVal

Tipo: IRawElementProviderSimple**

Proveedor Automatización de la interfaz de usuario del elemento más interno que incluye el ITextRangeProvider especificado.

Nota

El elemento envolvente puede abarcar más que solo el ITextRangeProvider especificado.

Si no se encuentra ningún elemento envolvente, se devuelve el elemento primario ITextProvider del ITextRangeProvider .

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.

Observaciones

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

Requisito Value
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, ITextRangeProvider::GetChildren, Automatización de la interfaz de usuario Providers Overview