Método IUIAutomationTextRange::ExpandToEnclosingUnit (uiautomationclient.h)

Normaliza el intervalo de texto por la unidad de texto especificada. El intervalo se expande si es menor que la unidad especificada o se acorta si es mayor que la unidad especificada.

Sintaxis

HRESULT ExpandToEnclosingUnit(
  [in] TextUnit textUnit
);

Parámetros

[in] textUnit

Tipo: TextUnit

Unidad de texto, como línea o párrafo.

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

Las aplicaciones cliente, como los lectores de pantalla, usan este método para recuperar la palabra, frase o párrafo completo que existe en el punto de inserción o la posición del símbolo de intercalación.

A pesar de su nombre, el método ExpandToEnclosingUnit no expande necesariamente un intervalo de texto. En su lugar, "normaliza" un intervalo de texto moviendo los puntos de conexión para que el intervalo abarque la unidad de texto especificada. El intervalo se expande si es menor que la unidad especificada o se acorta si es mayor que la unidad especificada. Si el intervalo ya es una cantidad exacta de las unidades especificadas, permanece sin cambios. En el diagrama siguiente se muestra cómo ExpandToEnclosingUnit normaliza un intervalo de texto moviendo los puntos de conexión del intervalo.

Diagrama que muestra los puntos de conexión antes y después de ExpandToEnclosingUnit

ExpandToEnclosingUnit tiene como valor predeterminado la siguiente unidad de texto más grande admitida si el control no admite la unidad de texto especificada.

El orden, de la unidad más pequeña al más grande, es el siguiente:

• Carácter
• Formato
• Word
• Línea
• Paragraph
• Página
• Documento

ExpandToEnclosingUnit respeta el texto visible y oculto.

Comportamiento del intervalo cuando la unidad es TextUnit::Format

TextUnit::Format, como valor de unidad , coloca el límite de un intervalo de texto para expandir o mover el intervalo en función de los atributos de texto compartidos (o formato) del texto dentro del intervalo. Sin embargo, la Format unidad de texto no mueve ni expande un intervalo de texto a través del límite de un objeto incrustado, como una imagen o un hipervínculo. Para obtener más información, consulta Automatización de la interfaz de usuario unidades de texto o Automatización de la interfaz de usuario compatibilidad con contenido textual.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Actualización de plataforma para Windows Vista, Windows XP con SP3 y Actualización de plataforma para Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008, Windows Server 2003 con SP2 y Actualización de plataforma para Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	uiautomationclient.h (include UIAutomation.h)

Consulte también

Interfaz IUIAutomationTextRange, Automatización de la interfaz de usuario compatibilidad con contenido textual