ITextRangeProvider.MoveEndpointByUnit Método

Definición

Espacio de nombres:

System.Windows.Automation.Provider

Ensamblado:

UIAutomationTypes.dll

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

public:
 int MoveEndpointByUnit(System::Windows::Automation::Text::TextPatternRangeEndpoint endpoint, System::Windows::Automation::Text::TextUnit unit, int count);

public int MoveEndpointByUnit (System.Windows.Automation.Text.TextPatternRangeEndpoint endpoint, System.Windows.Automation.Text.TextUnit unit, int count);

abstract member MoveEndpointByUnit : System.Windows.Automation.Text.TextPatternRangeEndpoint * System.Windows.Automation.Text.TextUnit * int -> int

Public Function MoveEndpointByUnit (endpoint As TextPatternRangeEndpoint, unit As TextUnit, count As Integer) As Integer

Parámetros

endpoint

TextPatternRangeEndpoint

punto de conexión que se debe mover.

unit

TextUnit

Unidad textual que se debe mover.

count

Int32

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.

Devoluciones

Int32

Número de unidades que realmente se mueven. Puede ser menor que el número solicitado si al mover el punto de conexión se pasa por el principio o el final del documento.

Comentarios

Cuando es necesario atravesar el contenido de un intervalo de texto, se realizan en segundo plano una serie de pasos para que el método Move pueda ejecutarse correctamente.

1. El intervalo de texto se normaliza, es decir, se contrae, en un intervalo degenerado en el extremo Start , y el extremo End queda superfluo. Este paso es necesario para quitar la ambigüedad en situaciones en las que un intervalo de texto abarca los límites unit ; por ejemplo, "{El RL https://www.microsoft.com/ U}está incrustado en texto", donde "{" y "}" son los puntos de conexión del intervalo de texto.

2. El intervalo resultante se mueve hacia atrás en DocumentRange , al principio del límite unit solicitado.

3. A continuación, el intervalo se expande desde un estado de intervalo degenerado moviendo el extremo End en función de un límite unit solicitado.

Ejemplos de cómo se ajusta un intervalo de texto para Move() y ExpandToEnclosingUnit()

MoveEndpointByUnit se aplaza al siguiente mayor TextUnit admitido si el control especificado TextUnit no es compatible con el control .

El pedido, de la unidad más pequeña al más grande, se muestra a continuación.

• Character

• Format

• Word

• Line

• Paragraph

• Page

• Document