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