TextSelection-Schnittstelle

  • Artikel

Ermöglicht den Zugriff auf Bearbeitungsoperationen und markierten Text in Ansichten.

Namespace:  EnvDTE
Assembly:  EnvDTE (in EnvDTE.dll)

Syntax

'Declaration
<GuidAttribute("1FA0E135-399A-4D2C-A4FE-D21E2480F921")> _
Public Interface TextSelection

[GuidAttribute("1FA0E135-399A-4D2C-A4FE-D21E2480F921")]
public interface TextSelection

[GuidAttribute(L"1FA0E135-399A-4D2C-A4FE-D21E2480F921")]
public interface class TextSelection

[<GuidAttribute("1FA0E135-399A-4D2C-A4FE-D21E2480F921")>]
type TextSelection =  interface end

public interface TextSelection

Der TextSelection-Typ macht die folgenden Member verfügbar.

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft ActivePoint Ruft den aktuellen Endpunkt der Markierung ab.
Öffentliche Eigenschaft AnchorColumn Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
Öffentliche Eigenschaft AnchorPoint Ruft den Ausgangspunkt der Markierung ab.
Öffentliche Eigenschaft BottomLine Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
Öffentliche Eigenschaft BottomPoint Ruft den Punkt am Ende der Markierung ab.
Öffentliche Eigenschaft CurrentColumn Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
Öffentliche Eigenschaft CurrentLine Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
Öffentliche Eigenschaft DTE Ruft das Erweiterbarkeitsobjekt der obersten Ebene ab.
Öffentliche Eigenschaft IsActiveEndGreater Ruft ab, ob der aktive Punkt dem untersten Punkt entspricht.
Öffentliche Eigenschaft IsEmpty Ruft ab, ob der Ankerpunkt dem aktiven Punkt entspricht.
Öffentliche Eigenschaft Mode Legt einen Wert fest oder ruft einen Wert ab, der bestimmt, ob beim Ziehen des Mauszeigers eine Markierung im Stream- oder Blockmodus erfolgt.
Öffentliche Eigenschaft Parent Ruft das unmittelbar übergeordnete Objekt eines TextSelection-Objekts ab.
Öffentliche Eigenschaft Text Legt den markierten Text fest oder ruft ihn ab.
Öffentliche Eigenschaft TextPane Ruft den Textbereich ab, der den markierten Text enthält.
Öffentliche Eigenschaft TextRanges Ruft eine TextRanges-Auflistung mit einem TextRange-Objekt für jede Zeile oder Teilzeile in der Markierung ab.
Öffentliche Eigenschaft TopLine Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
Öffentliche Eigenschaft TopPoint Ruft das obere Ende der Markierung ab.

Zum Seitenanfang

Methoden

  Name Beschreibung
Öffentliche Methode Backspace Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
Öffentliche Methode Cancel Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
Öffentliche Methode ChangeCase Ändert die Groß-/Kleinschreibung des markierten Textes.
Öffentliche Methode CharLeft Verschiebt das Objekt um die angegebene Anzahl von Zeichen nach links.
Öffentliche Methode CharRight Verschiebt das Objekt um die angegebene Anzahl von Zeichen nach rechts.
Öffentliche Methode ClearBookmark Löscht alle unbenannten Lesezeichen in der aktuellen Textzeile des Puffers.
Öffentliche Methode Collapse Reduziert den markierten Text auf den aktiven Punkt.
Öffentliche Methode Copy Kopiert den markierten Text in die Zwischenablage.
Öffentliche Methode Cut Kopiert den markierten Text in die Zwischenablage und löscht diesen an der ursprünglichen Position.
Öffentliche Methode Delete Löscht den markierten Text.
Öffentliche Methode DeleteLeft Löscht eine angegebene Anzahl von Zeichen links neben dem aktiven Punkt.
Öffentliche Methode DeleteWhitespace Löscht horizontal oder vertikal die Leerzeichen (Leerraum) in unmittelbarer Umgebung der aktuellen Position im Textpuffer.
Öffentliche Methode DestructiveInsert Fügt Text ein und überschreibt dabei den vorhandenen Text.
Öffentliche Methode EndOfDocument Verschiebt das Objekt an das Ende des Dokuments.
Öffentliche Methode EndOfLine Verschiebt das Objekt an das Ende der aktuellen Zeile.
Öffentliche Methode FindPattern Sucht nach dem angegebenen Muster vom aktiven Punkt bis zum Ende des Dokuments.
Öffentliche Methode FindText Sucht nach dem angegebenen Text vom aktiven Punkt bis zum Ende des Dokuments.
Öffentliche Methode GotoLine Wechselt zum Anfang der angegebenen Zeile und markiert diese ggf.
Öffentliche Methode Indent Zieht die markierten Zeilen um die angegebene Anzahl von Einzugsebenen ein.
Öffentliche Methode Insert Fügt die angegebene Zeichenfolge an der aktuellen Einfügemarke ein.
Öffentliche Methode InsertFromFile Fügt den Inhalt der angegebenen Datei an der aktuellen Position im Puffer ein.
Öffentliche Methode LineDown Verschiebt die Einfügemarke der Textauswahl um die angegebene Anzahl von Zeilen nach unten.
Öffentliche Methode LineUp Verschiebt die Einfügemarke der Textauswahl um die angegebene Anzahl von Zeilen nach oben.
Öffentliche Methode MoveTo Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
Öffentliche Methode MoveToAbsoluteOffset Verschiebt den aktiven Punkt an den angegebenen, auf 1 basierenden absoluten Zeichenversatz.
Öffentliche Methode MoveToDisplayColumn Verschiebt den aktiven Punkt an die angegebene Anzeigespalte.
Öffentliche Methode MoveToLineAndOffset Verschiebt den aktiven Punkt an die angegebene Position.
Öffentliche Methode MoveToPoint Verschiebt den aktiven Punkt an die angegebene Position.
Öffentliche Methode NewLine Fügt ein Zeilenumbruchzeichen am aktiven Punkt ein.
Öffentliche Methode NextBookmark Wechselt zur Position des nächsten Lesezeichens im Dokument.
Öffentliche Methode OutlineSection Erstellt einen Gliederungsabschnitt, basierend auf der aktuellen Auswahl.
Öffentliche Methode PadToColumn Füllt die aktuelle Zeile im Puffer bis zur angegebenen Spalte mit Leerzeichen (Leerraum) auf.
Öffentliche Methode PageDown Verschiebt den aktiven Punkt um die angegebene Anzahl von Seiten im Dokument nach unten, wobei ein Bildlauf in der Ansicht durchgeführt wird.
Öffentliche Methode PageUp Verschiebt den aktiven Punkt um die angegebene Anzahl von Seiten im Dokument nach oben, wobei ein Bildlauf in der Ansicht durchgeführt wird.
Öffentliche Methode Paste Fügt den Inhalt der Zwischenablage an der aktuellen Position ein.
Öffentliche Methode PreviousBookmark Verschiebt die Textmarkierung auf die Position des vorherigen Lesezeichens im Dokument.
Öffentliche Methode ReplacePattern Ersetzt übereinstimmenden Text innerhalb eines gesamten Textdokuments.
Öffentliche Methode ReplaceText Infrastruktur. Nur für die interne Verwendung durch Microsoft vorgesehen.
Öffentliche Methode SelectAll Markiert das gesamte Dokument.
Öffentliche Methode SelectLine Markiert die Zeile mit dem aktiven Punkt.
Öffentliche Methode SetBookmark Setzt in der aktuellen Zeile im Puffer ein unbenanntes Lesezeichen.
Öffentliche Methode SmartFormat Formatiert die markierten Textzeilen entsprechend der aktuellen Sprache.
Öffentliche Methode StartOfDocument Verschiebt die Einfügemarke an den Anfang des Dokuments.
Öffentliche Methode StartOfLine Verschiebt das Objekt an den Anfang der aktuellen Zeile.
Öffentliche Methode SwapAnchor Vertauscht die Positionen des aktiven Punktes und des Ankerpunktes.
Öffentliche Methode Tabify Konvertiert entsprechend Ihren Tabstopp-Einstellungen Leerzeichen in der Markierung in Tabstopps.
Öffentliche Methode Unindent Entfernt Einzüge aus dem markierten Text entsprechend der angegebenen Anzahl von Einzugsebenen.
Öffentliche Methode Untabify Konvertiert die Registerkarten zu Beginn der Zeile gemäß der Tabstopp-Einstellungen des Benutzers in Leerzeichen.Die Registerkarten, die später in der Zeile gefunden werden, werden nicht in Leerzeichen konvertiert.
Öffentliche Methode WordLeft Verschiebt den markierten Text um die angegebene Anzahl von Wörtern nach links.
Öffentliche Methode WordRight Verschiebt den markierten Text um die angegebene Anzahl von Wörtern nach rechts.

Zum Seitenanfang

Hinweise

Die Eigenschaften und Methoden des TextSelection-Objekts sind eine direkte Entsprechung zu den Editorbefehlen in der integrierten Entwicklungsumgebung (IDE) von Visual Studio. Wie auch die Umgebung werden Textmarkierungsoperationen vom globalen Status des Editors beeinflusst, beispielsweise davon, ob sich der Editor im Überschreiben-Modus oder im Modus für den virtuellen Leerraum befindet.

Alle Operationen zum Ändern eines Textdokuments schlagen fehl, wenn sie Zeichen in einem schreibgeschützten Block betreffen oder das Dokument selbst schreibgeschützt ist.

Einige Eigenschaften und Methoden des TextSelection-Objekts können einen Fehler verursachen, wenn es sich beim verknüpften Dokument um ein HTML-Dokument handelt. Mögliche Fehlerursachen: Die Fenster, in denen das HTML-Dokument angezeigt wird, befinden sich nicht in der Quellansicht, oder die Daten des Textdokuments sind gesperrt.

Beispiele

Sub TextSelectionExample()
   ' Before running this example, open a text document.
   Dim objSel As TextSelection = DTE.ActiveDocument.Selection
   Dim objActive As VirtualPoint = objSel.ActivePoint
   ' Collapse the selection to the beginning of the line.
   objSel.StartOfLine()
   ' objActive is "live", tied to the position of the actual selection, 
   ' so it will reflect the new position.
   Dim iCol As Long = objActive.DisplayColumn
   ' Move the selection to the end of the line.
   objSel.EndOfLine()

   MsgBox("The length of the insertion point line is " & (objActive.DisplayColumn - iCol) & " display characters.")
End Sub

Siehe auch

Referenz

EnvDTE-Namespace