IVsTextView-Schnittstelle

Verwaltet die Textansicht des Editorfensters und enthält Methoden, um die Textansicht zu verwalten. Die Ansicht ist im Wesentlichen das Editorfenster, die in der Benutzeroberfläche angezeigt wird.

Namespace:  Microsoft.VisualStudio.TextManager.Interop
Assembly:  Microsoft.VisualStudio.TextManager.Interop (in Microsoft.VisualStudio.TextManager.Interop.dll)

Syntax

'Declaration
<InterfaceTypeAttribute()> _
<GuidAttribute("BB23A14B-7C61-469A-9890-A95648CED5E6")> _
Public Interface IVsTextView

[InterfaceTypeAttribute()]
[GuidAttribute("BB23A14B-7C61-469A-9890-A95648CED5E6")]
public interface IVsTextView

[InterfaceTypeAttribute()]
[GuidAttribute(L"BB23A14B-7C61-469A-9890-A95648CED5E6")]
public interface class IVsTextView

[<InterfaceTypeAttribute()>]
[<GuidAttribute("BB23A14B-7C61-469A-9890-A95648CED5E6")>]
type IVsTextView =  interface end

public interface IVsTextView

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

Methoden

	Name	Beschreibung
	AddCommandFilter	Fügt dem vorhandenen Filter Instanzenweg Befehls einen Filter hinzu.
	CenterColumns	Setzt die angegebene Spalte des Texts in der Mitte der Ansicht.
	CenterLines	Platziert die angegebenen Zeilen in der Mitte der Ansicht.
	ClearSelection	Löscht die aktuelle Auswahl.
	CloseView	Schließt und hebt keine Ansicht mit dem Ansichts-Manager aufgehoben.
	EnsureSpanVisible	Stellt sicher, dass Text in der Ansicht sowohl vertikal als auch horizontal ist.
	GetBuffer	Gibt den aktuellen Inhalt des Textpuffers zurück.
	GetCaretPos	Gibt die Zeilen- und den Spaltenindex der Cursorposition zurück.
	GetLineAndColumn	Konvertiert eine Textstream Position einer Zeile und Spaltenindex.
	GetLineHeight	Gibt die Pixelhöhe eine Zeile zurück.
	GetNearestPosition	Konvertiert eine Zeile und den Spaltenindex in einer Position in den Textstream.
	GetPointOfLineColumn	Gibt die Koordinaten der linken oberen Ecke einer bestimmten Zeile und Spalte zurück.
	GetScrollInfo	Gibt die Einstellungen bildlaufleisten Kern des Text-Editors für die angegebene Bildlaufleiste zurück.
	GetSelectedText	Gibt eine Kopie des markierten Textes zurück.
	GetSelection	Gibt den Textabschnitt, der der aktuellen Auswahl zurück, sofern vorhanden.
	GetSelectionDataObject	Gibt eine Kopie des markierten Texts in IDataObject-Schnittstellen Format zurück.
	GetSelectionMode	Gibt den aktuellen Auswahlmodus zurück.
	GetSelectionSpan	Gibt den Textabschnitt zurück, der mit einer Auswahl zugeordnet ist.
	GetTextStream	Gibt einen angegebenen Stream des Texts in einer Zeichenfolge zurück.
	GetWindowHandle	Gibt das Fensterhandle für diese Ansicht zurück.
	GetWordExtent	Gibt den aktuellen Begriff Datenbindungsausdrücken zurück.
	HighlightMatchingBrace	Hebt die übereinstimmende geschweifte Klammer in einem Sprachkonstrukt hervor.
	Initialize	Erstellt die Ansicht und ermöglicht Clients, eine oder mehrere TextViewInitFlags-Optionen anzugeben.
	PositionCaretForEditing	Setzt die Einfügemarke in eine Position, die zum Bearbeiten einer Funktion geeignet ist.
	RemoveCommandFilter	Entfernt einen Filter Instanzenweg vom Filter Befehls.
	ReplaceTextOnLine	Ersetzt Text Zeilen.
	RestrictViewRange	Methodeninformationen werden nicht bereitgestellt.Methode ist nicht implementiert.
	SendExplicitFocus	Sendet expliziten Fokus für das Fenster.
	SetBuffer	Ordnet einen Textpuffer mit der Ansicht.
	SetCaretPos	Legt die Koordinaten des Endpunkts einer Auswahl fest.
	SetScrollPosition	Legt die Einstellungen für bildlaufleisten Kern des Text-Editors für die angegebene Bildlaufleiste fest.
	SetSelection	Selects gab Text an.
	SetSelectionMode	Legt den Auswahlmodus fest.
	SetTopLine	Legt die oberste Zeile und der Baseline in der Ansicht fest.
	UpdateCompletionStatus	Wird für Wort abschluss Steuerelement.
	UpdateTipWindow	Aktualisiert das Fenster Spitze.
	UpdateViewFrameCaption	Erzwingt die Ansicht, um seine Titelleiste Rahmenfenster zu aktualisieren, z „[]“ schreibgeschützt.

Zum Seitenanfang

Hinweise

Die IVsTextView-Schnittstelle ist nicht das untergeordnete MDI-Element, aber ein einzelnes Fenster Text. Wenn ein Splitter beteiligt ist, können mehrere Ansichten in ein untergeordnetes MDI-Element geben. Der Ausdruck, Einfügemarke, wird die Texteinfügemarke an, wenn der Ausdruck, Cursor, der den Mauszeiger verweist.

Warnung

Diese Schnittstelle ist nicht threadsicher.Sie sollten keine Daten für diese Schnittstelle jedoch von allen vom primären UI-Thread nicht aufrufen.

Wenn Sie alle Vorgänge in der Ansicht aus einem anderen Thread ausführen müssen, können Sie folgende Möglichkeiten:

• Verwenden Sie die Schnittstelle IVsThreadSafeTextView.

• Rufen Sie die GetWindowHandle-Methode auf, und verwenden Sie die PostMessage-Methode, um Nachrichten an den Hauptthread zu senden.

Einige Methoden für Verwendung IVsTextViewViewCol-Koordinaten (z. B. GetTextStream und GetCaretPos), während andere CharIndex-Koordinaten verwenden (z. B. GetWordExtent). Virtuellen Bereich ViewCol-Koordinaten enthalten, während CharIndex-Koordinaten nur ein Offset in einer Zeile befinden und schließen möglicherweise Puffer ein virtueller Bereich nie ein.

Wenn Sie eine Koordinate in ViewCol-Koordinaten abrufen, sollten Sie nur Methoden aufrufen, die CharIndex-Koordinaten annehmen, nachdem sie sicherstellen können, dass die ViewCol-Koordinate im virtuellen Leerraum nicht im Bereich befindet. Wenn Sie beispielsweise folgendermaßen aufrufen:

long iLine;

long cCount;

ViewCol iCol;

IVsTextView::SomeMethod(&iLine, &icol);

Dann müssen Sie überprüfen, um sicherzustellen, dass Folgendes zutrifft:

IVsTextBuffer::GetLengthOfLine(iLine, &cCount);

iCol < cCount

Rufen Sie anschließend Folgendes an:

IVsTextView::SomeOtherMethod(ViewCol(iCol ))

// where SomeOtherMethod takes ViewCol coordinates

Implementierung der Abbildungen Siehe und/oder des Aufrufs dieser Schnittstelle im Beispiel Figures Language Service.

Hinweise zu Aufrufern

Wird von Clients, die ihre Ansicht verwalten möchten.

Siehe auch

Referenz

Microsoft.VisualStudio.TextManager.Interop-Namespace