Compartir a través de

función TextRange_ExpandToEnclosingUnit (uiautomationcoreapi.h)

  • Artículo
Nota Esta función está en desuso. En su lugar, las aplicaciones cliente deben usar las interfaces del Modelo de objetos componentes (COM) de Microsoft Automatización de la interfaz de usuario.
 
Expande el intervalo de texto a una unidad mayor o más pequeña, como Carácter, Word, Línea o Página.

Sintaxis

HRESULT TextRange_ExpandToEnclosingUnit(
  [in] HUIATEXTRANGE hobj,
  [in] TextUnit      unit
);

Parámetros

[in] hobj

Tipo: HUIATEXTRANGE

Objeto de intervalo de texto.

[in] unit

Tipo: TextUnit

Unidad a la que el proveedor debe expandir el intervalo de texto.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o si un valor de error de lo contrario.

Comentarios

Si el intervalo ya es un número entero de las unidades especificadas, permanece sin cambios.

Si el punto de conexión inicial no está en un límite de TextUnit , se mueve hacia atrás hasta que se encuentra en un límite. Posteriormente, si el extremo final no está en un límite o si está en el mismo límite que el punto de conexión inicial, el extremo final se mueve hacia delante hasta que se encuentra en un límite.

Nota Es habitual que un lector de pantalla lea una palabra completa, un párrafo completo, etc., en el punto de inserción o en cualquier posición del cursor virtual.
 
TextRange_ExpandToEnclosingUnit respeta el texto oculto y visible. El cliente de Automatización de la interfaz de usuario puede comprobar si hay un atributo oculto (Text_IsHidden_Attribute_GUID) para ver el texto.

TextRange_ExpandToEnclosingUnit valor predeterminado hasta el siguiente TextUnit compatible si el control no admite textUnit especificado.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado uiautomationcoreapi.h
Library Uiautomationcore.lib
Archivo DLL Uiautomationcore.dll