Lenguaje

ITextRangeProvider.MoveEndpointByUnit Método

Definición

Espacio de nombres:
System.Windows.Automation.Provider
Ensamblado:
UIAutomationProvider.dll
Ensamblados:
UIAutomationProvider.dll, UIAutomationTypes.dll
Ensamblado:
UIAutomationTypes.dll

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

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 va a mover.

unit
TextUnit

Unidad de texto para mover.

count
Int32

Número de unidades que van a moverse. 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.

Devoluciones

Int32

Número de unidades que realmente se mueven, 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.

Comentarios

Cuando es necesario recorrer el contenido de un intervalo de texto, una serie de pasos están implicados en segundo plano para que el Move método se ejecute correctamente.

  1. El intervalo de texto se normaliza; es decir, el intervalo de texto se contrae a un intervalo degenerado en el Start punto de conexión, lo que hace que el End punto de conexión sea 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, "{The U}RL https://www.microsoft.com/ is embedded in text" donde "{" y "}" son los puntos de conexión del intervalo de texto.

  2. El intervalo resultante se desplaza hacia atrás en el DocumentRange hasta el principio del límite solicitado unit.

  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.

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

MoveEndpointByUnit se aplaza a la siguiente mayor TextUnit compatibilidad si el control no admite el elemento especificado TextUnit .

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

Se aplica a