ITextRangeProvider.Move(TextUnit, Int32) Método

Definición

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

Mueve el intervalo de texto el número especificado de unidades de texto.

public:
 int Move(System::Windows::Automation::Text::TextUnit unit, int count);
public int Move(System.Windows.Automation.Text.TextUnit unit, int count);
abstract member Move : System.Windows.Automation.Text.TextUnit * int -> int
Public Function Move (unit As TextUnit, count As Integer) As Integer

Parámetros

unit
TextUnit

Límite de unidad de texto.

count
Int32

Número de unidades de texto que se van a mover.

Un valor positivo mueve el intervalo de texto hacia delante, un valor negativo mueve el intervalo de texto hacia atrás y 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 cualquiera de los nuevos puntos de conexión de intervalo de texto es mayor o menor que los DocumentRange puntos de conexión.

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. El intervalo resultante se mueve hacia delante o hacia atrás en DocumentRange , en función del número solicitado de límites unit .

  4. 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()

El contenido textual (o texto interno) de un contenedor de texto y un objeto incrustado, como un hipervínculo o una celda de tabla, se expone como un único flujo de texto continuo en la vista de control y en la vista de contenido del árbol de automatización de la interfaz de usuario; se omiten los límites de objeto.

Intervalos de texto distribuidos por objetos incrustados. Ejemplo de una secuencia de texto con objetos incrustados y sus intervalos de intervalos

Move respeta el texto oculto y visible.

Move 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.

El texto no se modifica de ninguna manera, el intervalo de texto solo abarca una parte diferente del texto.

Se aplica a