Metodo ITextSelection::MoveRight (tom.h)

Articolo
03/03/2024

Generalizza la funzionalità del tasto freccia destra.

Sintassi

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

Parametri

Unit

Tipo: long

Unità da usare. Può essere uno dei seguenti.

Valore	Combinazione di chiavi corrispondente	Significato
tomCharacter	Freccia DESTRA	Spostare una posizione di carattere a destra. Questo è il valore predefinito.
tomWord	CTRL+Freccia DESTRA	Sposta una parola a destra.

Nota, se Count è minore di zero, lo spostamento è a sinistra.

Count

Tipo: long

Numero di unità da spostare in passato. Il valore predefinito è 1. Se Count è minore di zero, lo spostamento si trova a sinistra.

Extend

Tipo: long

Flag che indica come modificare la selezione. Se Extend è zero (o tomMove), il metodo comprime la selezione in un punto di inserimento alla fine attiva e lo sposta. Se Extend è 1 (o tomExtend), il metodo sposta la fine attiva e lascia l'altra fine sola. Il valore predefinito è zero. Un valore di estensione diverso da zero corrisponde al tasto MAIUSC premuto oltre alla combinazione di tasti descritta in Unit.

pDelta

Tipo: long*

Il conteggio effettivo delle unità del punto di inserimento o della fine attiva viene spostato a sinistra. Questo parametro può essere null. Il confronto della selezione, quando Extend è 0, conta come un'unità.

Valore restituito

Tipo: HRESULT

Il metodo restituisce un valore HRESULT . Se il metodo ha esito positivo, restituisce S_OK. Se il metodo ha esito negativo, restituisce uno dei codici di errore seguenti. Per altre informazioni sui codici di errore COM, vedere Gestione degli errori in COM.

Codice restituito	Descrizione
E_INVALIDARG	Unità non valida.
S_FALSE	Errore per qualche altro motivo.

Commenti

I metodi di spostamento di Microsoft WordBasic, ad esempio CharRight, CharLeft, WordRight e WordLeft sono ibridi che possono eseguire quattro operazioni strettamente correlate al comportamento di modifica del tasto freccia standard:

Spostare il punto di inserimento corrente se non è presente alcuna selezione.
Spostare la fine attiva della selezione se è presente una selezione.
Trasformare un punto di inserimento in una selezione e viceversa.
Restituisce un valore booleano che indica se si è verificato lo spostamento.

L'argomento Extend di MoveLeft e MoveRight consente di essere coerenti con i primi tre elementi precedenti e pDelta è una generalizzazione del quarto. Ad esempio, dato una selezione, s, costituita da un singolo intervallo, si hanno le corrispondenze seguenti (per i caratteri da sinistra a destra).

ITextSelection	Wordbasic	Funzione
s.MoveRight tomWord, 1, 1	WordRight 1,1	Sposta una parola attiva a destra.
s.MoveLeft tomCharacter, 1, 1	CharLeft 1,1	Sposta un carattere attivo a sinistra.

Come in WordBasic, se Count è minore di zero, i significati di sinistra e destra vengono interscambiati, ovvero MoveLeft (Unit, Count, Extend) equivalenti a MoveRight(Unit, -Count, Extend).

Analogamente a WordBasic e al comportamento dell'interfaccia utente della freccia destra, la chiamata MoveRight(Unit, Count) a una selezione degenerata sposta il punto di inserimento il numero specificato di unità. In un intervallo degenerato, la chiamata MoveRight(Unit, Count, 1) a dove Count è maggiore di zero causa la mancata generazione dell'intervallo con la fine destra.

Quando Extend è tomExtend (o è diverso da zero), MoveRight sposta solo la fine attiva della selezione, lasciando l'altra estremità in cui è. Tuttavia, se Extend è uguale a zero e la selezione inizia come intervallo non generato, MoveRight(Unit, Count) dove Count è maggiore di zero sposta la fine Count attiva - 1 unità a destra e quindi sposta l'altra estremità alla fine attiva. In altre parole, rende un punto di inserimento alla fine attiva. Il confronto tra l'intervallo viene conteggiato come un'unica unità. Quindi, MoveRight(tomCharacter) converte una selezione non generata in una degenerata alla fine destra della selezione. In questo caso, Count ha il valore predefinito 1 e Extend ha il valore predefinito pari a zero. In questo esempio viene premuto il tasto Freccia destra. MoveLeft e MoveRight sono correlati ai metodi di spostamento ITextRange , ma differiscono in modo esplicito con la fine attiva (la fine spostata premendo il tasto Maiusc).

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	tom.h
DLL	Msftedit.dll