ITextSelection-Schnittstelle (tom.h)

Eine Textauswahl ist ein Textbereich mit Markierungsmarkierung.

Vererbung

Die ITextSelection-Schnittstelle erbt von ITextRange. ITextSelection verfügt auch über folgende Membertypen:

Methoden

Die ITextSelection-Schnittstelle verfügt über diese Methoden.

ITextSelection::EndKey Imitiert die Funktionalität der Endtaste.
ITextSelection::GetFlags Ruft die Textauswahlflags ab.
ITextSelection::GetType Ruft den Typ der Textauswahl ab.
ITextSelection::HomeKey Generalisiert die Funktionalität des Startschlüssels.
ITextSelection::MoveDown Imitiert die Funktionalität der NACH-UNTEN- und BILD-NACH-UNTEN-TASTE.
ITextSelection::MoveLeft Generalisiert die Funktionalität der NACH-LINKS-TASTE.
ITextSelection::MoveRight Generalisiert die Funktionalität der NACH-RECHTS-TASTE.
ITextSelection::MoveUp Imitiert die Funktionalität der NACH-OBEN- und BILD-NACH-OBEN-TASTE.
ITextSelection::SetFlags Legt die Markierungen für die Textauswahl fest.
ITextSelection::TypeText Gibt die von bstr bei dieser Auswahl angegebene Zeichenfolge so ein, als ob sie von jemandem eingegeben wurde. Dies ähnelt der zugrunde liegenden SetText-Methode, ist jedoch empfindlich auf den Schlüsselzustand Einfügen/Überschreiben und Benutzeroberflächeneinstellungen wie AutoKorrektur und intelligente Anführungszeichen.

Hinweise

Die Auswahl ist einer Art von Ansicht zugeordnet und verfügt über einige UI-orientierte Methoden, mit denen Tastatureingaben emuliert werden können. Daher kann eine Anwendung die ITextRange-Methoden für eine Textauswahl sowie die ITextSelection-Methoden verwenden.

Bei der Tastatureingabeemulation verwenden bereiche, die in auswahlen verwendet werden, das Konzept des aktiven Endes, das in der Regel das Ende ist, das zuletzt verschoben wurde. Wenn beispielsweise eine ITextRange::Move*-Methode für einen Bereich arbeitet, der tatsächlich eine Textauswahl ist, ist das zuletzt verschobene Ende das aktive Ende. Die bekanntesten Beispiele für das aktive Ende sind diejenigen, die die Behandlung von UMSCHALT+PFEILtasten betreffen, wobei das aktive Ende das ist, das verschoben wird. Dementsprechend enthalten die ITextSelection-Methoden Move-Methoden für das aktive Ende, z. B. MoveLeft oder MoveRight, und Methoden zum Abrufen und Festlegen des aktiven Endes status. Diese Methoden bearbeiten Auswahlen ähnlich den standardmäßigen Cursor-Tastatur-Vorgängen. Auf diese Weise können Sie beispielsweise eine Makroaufzeichnungsfunktion implementieren.

Informationen zur Funktionsweise der Cursor-Tastatur-Methoden finden Sie in der folgenden Tabelle. Eine angegebene Methode entspricht einer Cursortastentaste mit strg- und UMSCHALTTASTE. Der Unit-Parameter wird durch Drücken oder Nicht-Drücken der STRG-TASTE ausgewählt, während der Parameter Erweitern durch Drücken oder Nicht-Drücken der UMSCHALTTASTE ausgewählt wird. Beachten Sie, dass MoveUp und MoveDown mehreren Tastenkombinationen entsprechen. Weitere Informationen finden Sie in den Beschreibungen der Methoden.

Methode	Cursor-Tastatur-Taste	Durch Strg gedrückte Einheit (nicht gedrückt)	Durch gedrückte UMSCHALTTASTE (nicht gedrückt) angegebene Erweiterung
EndKey	Ende	tomStory (tomLine)	tomExtend (tomMove)
HomeKey	Startseite	tomStory (tomLine)	tomExtend (tomMove)
MoveLeft	NACH-LINKS-TASTE	tomWord (tomCharacter)	tomExtend (tomMove)
MoveRight	NACH-RECHTS	tomWord (tomCharacter)	tomExtend (tomMove)
MoveUp	NACH-OBEN	tomParagraph (tomLine)	tomExtend (tomMove)
Movedown	NACH-UNTEN	tomParagraph (tomLine)	tomExtend (tomMove)
MoveUp	BILD-AUF	tomWindow (tomScreen)	tomExtend (tomMove)
Movedown	BILD-AB	tomWindow (tomScreen)	tomExtend (tomMove)

 

Anwendungen implementieren die ITextSelection-Schnittstelle in der Regel nicht. Stattdessen implementieren Microsoft-Textlösungen wie Rich-Edit-Steuerelemente ITextSelection als Teil ihrer TOM-Implementierung (Text Object Model).

Anwendungen können einen ITextSelection-Zeiger abrufen, indem sie die GetSelection-Methode aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	tom.h