Freigeben über


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