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

Artículo
03/03/2024

Mueve un extremo del intervalo de texto el número especificado de unidades TextUnit dentro del intervalo de documentos.

Sintaxis

HRESULT MoveEndpointByUnit(
                TextPatternRangeEndpoint endpoint,
                TextUnit                 unit,
  [in]          int                      count,
  [out, retval] int                      *pRetVal
);

Parámetros

endpoint

unit

[in] count

Tipo: int

Número de unidades para mover. Un valor positivo mueve el punto de conexión hacia adelante. Un valor negativo lo mueve hacia atrás. Un valor de 0 no tiene ningún efecto.

[out, retval] pRetVal

Tipo: int*

Recibe el número de unidades que realmente se mueven, que pueden ser menores que el número solicitado si el movimiento del punto de conexión se ejecuta al principio o al final del documento.

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

El punto de conexión se mueve hacia delante o hacia atrás, como se especifica, al siguiente límite de unidad disponible. Si el punto de conexión original estaba en el límite de la unidad de texto especificada, el extremo se mueve al siguiente límite de unidad de texto disponible, como se muestra en la ilustración siguiente.

Ilustración en la que se muestran los puntos de conexión de un intervalo de texto que se mueve

Si el punto de conexión que se mueve cruza el otro extremo del mismo intervalo de texto, el otro extremo también se mueve, lo que da lugar a un intervalo degenerado y garantiza la ordenación correcta del punto de conexión (es decir, que el inicio siempre es menor o igual que el final).

ITextRangeProvider::MoveEndpointByUnit deja de usarse hasta la siguiente unidad de texto compatible si el control no admite la unidad de texto especificada.

El orden, de la unidad más pequeña al más grande, se muestra aquí.

Carácter
Formato
Word
Línea
Paragraph
Page
Documento

Comportamiento del intervalo cuando la unidad es `TextUnit::Format`

TextUnit::Format como un 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 (formato) del texto dentro del intervalo. Sin embargo, el uso de la unidad de texto de formato no debe mover ni expandir 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 patrones de control Text y TextRange.

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 (incluir UIAutomation.h)