Metodo ITextSelection::MoveLeft (tom.h)

Articolo
08/26/2023

Generalizza la funzionalità del tasto freccia sinistra.

Sintassi

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

Parametri

Unit

Tipo: long

Unità da usare. Può essere una delle seguenti.

valore	Combinazione di tasti corrispondente	Significato
tomCharacter	Freccia SINISTRA	Spostare una posizione di carattere a sinistra. Questo è il valore predefinito.
tomWord	CTRL+Freccia SINISTRA	Spostare una parola a sinistra.

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

Count

Tipo: long

Numero di unità da passare. Il valore predefinito è 1. Se Count è minore di zero, il movimento è a destra.

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 la sposta. Se Extend è 1 (o tomExtend), il metodo sposta l'estremità attiva e lascia l'altra estremità da sola. Il valore predefinito è zero. Un valore Extend diverso da zero corrisponde al tasto MAIUSC premuto oltre alla combinazione di tasti descritta in Unità.

pDelta

Tipo: long*

Il numero effettivo di unità di misura a sinistra viene spostato il punto di inserimento o l'estremità attiva. Questo parametro può essere null. La compressione della selezione, quando Extend è 0, viene conteggiato 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	L'unità non è valida.
S_FALSE	Errore per un altro motivo.

Commenti

I metodi di spostamento di WordBasic come 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, data una selezione costituita da un singolo intervallo, sono disponibili le corrispondenze seguenti (per i caratteri da sinistra a destra).

ITextSelection	Wordbasic	Funzione
Selezione. MoveRight tomWord, 1, 1	WordRight 1,1	Sposta l'estremità attiva a destra di una parola.
Selezione. MoveLeft tomCharacter, 1, 1	CharLeft 1,1	Sposta l'estremità attiva di un carattere a sinistra.

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

Analogamente a WordBasic e al comportamento dell'interfaccia utente del tasto freccia sinistra, la chiamata MoveLeft ( Unit, Count) a una selezione degenerata sposta il punto di inserimento del numero specificato di unità. In un intervallo degenerato, la chiamata a MoveLeft( Unit, Count, 1) dove Count è maggiore di zero fa sì che l'intervallo diventi non generato con l'estremità sinistra che è l'estremità attiva.

Quando Extend è tomExtend (o è diverso da zero), MoveLeft sposta solo la fine attiva della selezione, lasciando l'altra estremità in cui si trova. Tuttavia, se Extend è uguale a zero e la selezione inizia come intervallo non generato, MoveLeft(Unit, Count) dove Count è maggiore di zero sposta l'estremità Count attiva - 1 unità a sinistra e quindi sposta l'altra estremità alla fine attiva. In altre parole, crea un punto di inserimento alla fine attiva. La compressione dell'intervallo viene conteggiata come un'unità. MoveLeft(tomCharacter) Converte quindi una selezione non generata in una selezione degenerata alla fine sinistra della selezione. In questo caso, Count ha il valore predefinito 1 e Extend ha il valore predefinito zero. Questo esempio corrisponde alla pressione del tasto freccia sinistra. MoveLeft e MoveRight sono correlati ai metodi di spostamento ITextRange , ma differiscono in modo che usino in modo esplicito l'estremità attiva (la fine spostata premendo MAIUSC).

Requisiti


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