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

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

Sintaxis

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

Parámetros

[in] endpoint

Tipo: TextPatternRangeEndpoint

Valor que especifica el punto de conexión (inicio o fin) que se va a mover.

[in] unit

Tipo: TextUnit

Valor que especifica la unidad de texto para mover, como línea o párrafo.

[in] count

Tipo: int

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

[out, retval] moved

Tipo: int*

Recibe el recuento de unidades que realmente se mueven. Este valor puede ser menor que el número solicitado si el traslado 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 punto de conexión 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 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).

MoveEndpointByUnit deja de usar 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 a la 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 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 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 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

IUIAutomationTextRange

Automatización de la interfaz de usuario compatibilidad con contenido textual