Interfaccia ITextSelection (tom.h)

Una selezione di testo è un intervallo di testo con l'evidenziazione della selezione.

Ereditarietà

L'interfaccia ITextSelection eredita da ITextRange. ITextSelection include anche questi tipi di membri:

Metodi

L'interfaccia ITextSelection include questi metodi.

ITextSelection::EndKey Simula la funzionalità della chiave End.
ITextSelection::GetFlags Ottiene i flag di selezione del testo.
ITextSelection::GetType Ottiene il tipo di selezione del testo.
ITextSelection::HomeKey Generalizza la funzionalità della chiave Home.
ITextSelection::MoveDown Simula la funzionalità dei tasti Freccia giù e Pagina giù.
ITextSelection::MoveLeft Generalizza la funzionalità del tasto freccia sinistra.
ITextSelection::MoveRight Generalizza la funzionalità del tasto freccia destra.
ITextSelection::MoveUp Simula la funzionalità dei tasti Freccia su e Up pagina.
ITextSelection::SetFlags Imposta i flag di selezione del testo.
ITextSelection::TypeText Digita la stringa specificata da bstr in questa selezione come se qualcuno lo digitasse. È simile al metodo SetText sottostante, ma è sensibile allo stato della chiave Insert/Overtype e alle impostazioni dell'interfaccia utente, ad esempio Correzione automatica e virgolette intelligenti.

Commenti

La selezione è associata a un certo tipo di visualizzazione e include alcuni metodi orientati all'interfaccia utente che consentono a uno di emulare l'input della tastiera. Pertanto, un'applicazione può usare i metodi ITextRange in una selezione di testo, nonché i metodi ITextSelection .

Per l'emulazione dell'input della tastiera, gli intervalli usati nelle selezioni usano il concetto della fine attiva, che in genere è la fine che è stata spostata l'ultima volta. Ad esempio, se un metodo ITextRange::Move* opera su un intervallo che è effettivamente una selezione di testo, la fine più recente spostata è quella attiva. Gli esempi più noti della fine attiva sono quelli che coinvolgono la gestione maiusc+freccia, in cui la fine attiva è quella che si sposta. Di conseguenza, i metodi ITextSelection includono metodi di spostamento per la fine attiva, ad esempio MoveLeft o MoveRight, e metodi per ottenere e impostare lo stato finale attivo. Questi metodi modificano le selezioni in modi simili alle operazioni standard del tasto tasto cursore. Ciò consente di implementare, ad esempio, una struttura di registrazione macro.

Per vedere come funzionano i metodi cursor-keypad, vedere la tabella seguente. Un metodo specificato corrisponde a un tasto cursor-keypad con i tasti CTRL e MAIUSC. Il parametro Unit è selezionato premendo o meno premendo il tasto CTRL, mentre il parametro Extend è selezionato premendo o non premendo il tasto Maiusc. Nota, MoveUp e MoveDown corrispondono a più tasti. Per altre informazioni, vedere le descrizioni dei metodi.

Metodo	Tasto tasto cursore	Unità specificata da CTRL premuta (non premuta)	Estensione specificata da MAIUSC premuta (non premuta)
EndKey	Fine	tomStory (tomLine)	tomExtend (tomMove)
Homekey	Home page	tomStory (tomLine)	tomExtend (tomMove)
MoveLeft	Freccia SINISTRA	tomWord (tomCharacter)	tomExtend (tomMove)
MoveRight	Freccia DESTRA	tomWord (tomCharacter)	tomExtend (tomMove)
MoveUp	Freccia SU	tomParagraph (tomLine)	tomExtend (tomMove)
MoveDown	Freccia GIÙ	tomParagraph (tomLine)	tomExtend (tomMove)
MoveUp	PGSU	tomWindow (tomScreen)	tomExtend (tomMove)
MoveDown	PGGIÙ	tomWindow (tomScreen)	tomExtend (tomMove)

 

Le applicazioni in genere non implementano l'interfaccia ITextSelection . Le soluzioni di testo Microsoft, ad esempio i controlli di modifica avanzati, implementano ITextSelection come parte dell'implementazione di Text Object Model (TOM).

Le applicazioni possono recuperare un puntatore ITextSelection chiamando il metodo GetSelection .

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