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

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

Sintaxis

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

Parámetros

[in] endpoint

Tipo: TextPatternRangeEndpoint

Punto de conexión que se va a mover.

[in] unit

Tipo: TextUnit de

Tipo de unidades de texto, como carácter, palabra, párrafo, etc.

[in] count

Tipo: int

Número de unidades que se van a mover. Un valor positivo mueve el punto de conexión hacia delante. Un valor negativo se 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, lo que puede ser menor 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 hrESULT código de error.

Observaciones

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

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

ITextRangeProvider::MoveEndpointByUnit desuso hasta la siguiente unidad de texto admitida si el control no admite la unidad de texto especificada.

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

• de caracteres
• formato de
• word
• de línea
• párrafo
• de página de
• documento

comportamiento de intervalo cuando se unidad de

TextUnit::Format como unidad de valor 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 unidades de texto de automatización de la interfaz de usuario o patrones de control Text y TextRange.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido	Windows Server 2003 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de	Windows
encabezado de	uiautomationcore.h (include UIAutomation.h)

Consulte también

conceptual de

ITextProvider

ITextRangeProvider

de referencia de

patrones de control Text y TextRange

Introducción a los proveedores de automatización de la interfaz de usuario de