Método ITextSelection::MoveRight (tom.h)

Artículo
03/15/2023

Generaliza la funcionalidad de la tecla flecha derecha.

Sintaxis

HRESULT MoveRight(
  long Unit,
  long Count,
  long Extend,
  long *pDelta
);

Parámetros

Unit

Tipo: long

Unidad que se va a usar. Puede ser uno de los siguientes.

Valor	Combinación de teclas correspondiente	Significado
tomCharacter	Flecha derecha	Mueva una posición de carácter a la derecha. Este es el valor predeterminado.
tomWord	Ctrl+Flecha derecha	Mueve una palabra a la derecha.

Tenga en cuenta que si Count es menor que cero, el movimiento es hacia la izquierda.

Count

Tipo: long

Número de unidades que se van a mover más allá. El valor predeterminado es 1. Si Count es menor que cero, el movimiento es hacia la izquierda.

Extend

Tipo: long

Marca que indica cómo cambiar la selección. Si Extend es cero (o tomMove), el método contrae la selección en un punto de inserción en el extremo activo y, a continuación, lo mueve. Si Extend es 1 (o tomExtend), el método mueve el extremo activo y deja solo el otro extremo. El valor predeterminado es cero. Un valor extend distinto de cero corresponde a la tecla Mayús que se está presionando además de la combinación de teclas descrita en Unidad.

pDelta

Tipo: long*

El recuento real de unidades que el punto de inserción o el extremo activo se mueven a la izquierda. Este parámetro puede ser NULL. Al contraer la selección, cuando Extend es 0, se cuenta como una unidad.

Valor devuelto

Tipo: HRESULT

El método devuelve un valor HRESULT . Si el método se realiza correctamente, devuelve S_OK. Si se produce un error en el método, devuelve uno de los siguientes códigos de error. Para obtener más información sobre los códigos de error COM, vea Control de errores en COM.

Código devuelto	Descripción
E_INVALIDARG	La unidad no es válida.
S_FALSE	Error por algún otro motivo.

Comentarios

Los métodos de movimiento de Microsoft WordBasic como CharRight, CharLeft, WordRight y WordLeft son híbridos que pueden hacer cuatro cosas que están estrechamente relacionadas con el comportamiento estándar de edición de teclas de flecha:

Mueva el punto de inserción actual si no hay ninguna selección.
Mueva el final activo de la selección si hay una selección.
Convierta un punto de inserción en una selección y viceversa.
Devuelve un valor booleano que indica si se produjo el movimiento.

El argumento Extend de MoveLeft y MoveRight le permite ser coherente con los tres primeros elementos anteriores, y pDelta es una generalización del cuarto. Por ejemplo, dada una selección, s, que consta de un único intervalo, tiene las siguientes correspondencias (para caracteres de izquierda a derecha).

ITextSelection	Wordbasic	Función
s.MoveRight tomWord, 1, 1	WordRight 1,1	Mueve el extremo activo una palabra a la derecha.
s.MoveLeft tomCharacter, 1, 1	CharLeft 1,1	Mueve el extremo activo un carácter a la izquierda.

Como en WordBasic, si Count es menor que cero, se intercambian los significados de izquierda y derecha, equivale MoveLeft (Unit, Count, Extend) a MoveRight(Unit, -Count, Extend).

De forma similar a WordBasic y el comportamiento de la interfaz de usuario de la tecla flecha derecha, la llamada MoveRight(Unit, Count) a en una selección degenerada mueve el punto de inserción el número especificado de unidades. En un intervalo degenerado, la llamada a MoveRight(Unit, Count, 1) donde Count es mayor que cero hace que el intervalo deje de generarse con el extremo derecho siendo el extremo activo.

Cuando Extend es tomExtend (o es distinto de cero), MoveRight mueve solo el extremo activo de la selección, dejando el otro extremo donde está. Sin embargo, si Extend es igual a cero y la selección comienza como un intervalo no degenerado, MoveRight(Unit, Count) donde Count es mayor que cero mueve el extremo Count activo - 1 unidades a la derecha y, a continuación, mueve el otro extremo al extremo activo. En otras palabras, hace un punto de inserción en el extremo activo. Contraer el intervalo cuenta como una unidad. Por lo tanto, MoveRight(tomCharacter) convierte una selección no degenerada en una degenerada en una degenerada en el extremo derecho de la selección. Aquí, Count tiene el valor predeterminado de 1 y Extend tiene el valor predeterminado de cero. Este ejemplo corresponde a presionar la tecla flecha derecha. MoveLeft y MoveRight están relacionados con los métodos de movimiento ITextRange , pero difieren en que usan explícitamente el extremo activo (el final movido presionando la tecla Mayús).

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	tom.h
Archivo DLL	Msftedit.dll