ITextView Schnittstelle

Definition

Namespace:

Microsoft.VisualStudio.Text.Editor

Assembly:

Microsoft.VisualStudio.Text.UI.dll

Paket:

Microsoft.VisualStudio.Text.UI v17.9.187

Stellt eine Ansicht von Text in einem ITextBuffer dar. Dies ist die Basisklasse für eine plattformspezifische Schnittstelle mit Methoden, durch die der formatierte Text gerendert werden kann.

public interface class ITextView : Microsoft::VisualStudio::Utilities::IPropertyOwner

public interface class ITextView : Microsoft::VisualStudio::Utilities::IPropertyOwner

__interface ITextView : Microsoft::VisualStudio::Utilities::IPropertyOwner

public interface ITextView : Microsoft.VisualStudio.Utilities.IPropertyOwner

type ITextView = interface
    interface IPropertyOwner

Public Interface ITextView
Implements IPropertyOwner

Abgeleitet

Microsoft.VisualStudio.Text.Editor.ITextView2

Microsoft.VisualStudio.Text.Editor.IWpfTextView

Implementiert

IPropertyOwner

Hinweise

Eine Textansicht ist eine plattformunabhängige Darstellung eines zusammenhängenden Blocks von formatiertem und verziertem Text, auf den über die TextViewLines -Eigenschaft zugegriffen werden kann. Außerdem instanziiert er eine instance eines IEditorOperations-Komponententeils, sodass verschiedene Befehle ausgeführt werden können.

Der Text wird basierend auf den Klassifizierern formatiert, die dem zugrunde liegenden ITextBufferzugeordnet sind.

Die meisten Eigenschaften und Parameter, die Doubles sind, entsprechen Koordinaten oder Entfernungen im Textrenderingkoordinatensystem. In diesem Koordinatensystem entspricht x = 0,0 dem linken Rand der Zeichnungsfläche, auf der Text gerendert wird (x = Ansicht. ViewportLeft entspricht dem linken Rand des Viewports), und y = View. ViewportTop entspricht dem oberen Rand des Viewports. Die x-Koordinate erhöht sich von links nach rechts, und die y-Koordinate erhöht sich von oben nach unten.

Die horizontale und vertikale Achse der Ansicht verhalten sich unterschiedlich. Wenn der Text in der Ansicht formatiert ist, werden nur die sichtbaren Zeilen formatiert. Daher kann ein Viewport nicht horizontal und vertikal auf die gleiche Weise gescrollt werden.

Ein Viewport wird horizontal gescrollt, indem die linke Koordinate des Viewports so geändert wird, dass er in Bezug auf die Zeichnungsoberfläche verschoben wird.

Eine Ansicht kann nur vertikal gescrollt werden, indem ein neues Layout ausgeführt wird.

Das Erstellen eines Layouts in der Ansicht kann dazu führen, dass sich die ViewportTop-Eigenschaft der Ansicht ändert. Wenn Sie beispielsweise eine Zeile nach unten scrollen, werden keine der sichtbaren Zeilen übersetzt. Stattdessen wird einfach die ViewportTop-Eigenschaft der Ansicht geändert (wodurch sich die Linien auf dem Bildschirm bewegen, obwohl sich ihre y-Koordinaten nicht geändert haben).

Entfernungen im Textrenderingkoordinatensystem entsprechen logischen Pixeln. Wenn die Textrenderingoberfläche ohne Skalierungstransformation angezeigt wird, entspricht 1 Einheit im Textrenderingkoordinatensystem einem Pixel auf der Anzeige.

Eigenschaften

BufferGraph	Ruft den IBufferGraph mit dem Satz von Quellpuffern ab, die zu dieser Ansicht beitragen.
Caret	Ruft das Einfügemarkenelement ab.
HasAggregateFocus	Bestimmt, ob die Ansicht oder eines ihrer Zusatzelemente den Fokus besitzt.
InLayout	Bestimmt, ob das Layout für die Ansicht gerade erfolgt.
IsClosed	Bestimmt, ob diese Textansicht geschlossen wurde.
IsMouseOverViewOrAdornments	Bestimmt, ob sich die Maus über der Ansicht oder einem ihrer Zusatzelemente befindet.
LineHeight	Ruft die nominale Höhe einer Textzeile in der Ansicht ab.
MaxTextRightCoordinate	Ruft die rechte Koordinate der längsten Zeile in logischen Pixeln ab, unabhängig davon, ob diese Zeile gerade sichtbar ist.
Options	Ruft die Optionen für diese Textansicht ab.
Properties	Die Auflistung von Eigenschaften, die vom Eigenschaftenbesitzer gesteuert werden. (Geerbt von IPropertyOwner)
ProvisionalTextHighlight	Ruft den von der provisorischen Texthervorhebung abgedeckten Textabschnitt ab.
Roles	Die Rollen, die diese Ansicht einnimmt. Rollen bestimmen z. T. die Erweiterungen, die für die Ansicht instanziiert werden.
Selection	Ruft das Auswahlelement ab.
TextBuffer	Ruft den ITextBuffer ab, dessen Text in dieser Ansicht gerendert wird.
TextDataModel	Ruft das ITextDataModel dieser Textansicht ab.
TextSnapshot	Ruft den ITextSnapshot des Texts ab, der gerade in der Ansicht gerendert wird.
TextViewLines	Ruft eine schreibgeschützte Liste der in dieser Ansicht gerenderten ITextViewLine-Objekte ab.
TextViewModel	Ruft das ITextViewModel dieser Textansicht ab.
ViewportBottom	Ruft die Position des unteren Rands des Viewports im Textrenderingkoordinatensystem ab.
ViewportHeight	Ruft die Höhe des sichtbaren Inhaltsfensters in logischen Pixeln ab.
ViewportLeft	Ruft die Position des linken Rands des Viewports im Textrenderingkoordinatensystem ab oder legt diese fest.
ViewportRight	Ruft die Position des rechten Rands des Viewports im Textrenderingkoordinatensystem ab.
ViewportTop	Ruft die Position des oberen Rands des Viewports im Textrenderingkoordinatensystem ab.
ViewportWidth	Ruft die Breite des sichtbaren Inhaltsfensters in logischen Pixeln ab.
ViewScroller	Ruft ein Hilfsprogramm ab, das unterschiedliche Methoden für den Bildlauf und das Bearbeiten der Ansicht bereitstellt.
VisualSnapshot	Ruft den ITextSnapshot des visuellen Puffers ab, der gerendert wird.

Methoden

Close()	Schließt die Textansicht und ihre Ansicht.
DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition)	Formatiert und zeigt den Inhalt des Textpuffers an, sodass der ITextViewLine enthaltende bufferPosition an der gewünschten Position angezeigt wird.
DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition, Nullable<Double>, Nullable<Double>)	Formatiert und zeigt den Inhalt des Textpuffers an, sodass der ITextViewLine enthaltende bufferPosition an der gewünschten Position angezeigt wird.
GetTextElementSpan(SnapshotPoint)	Ruft die SnapshotSpan von ab, die ein Textelement (eine einzelne visuelle Darstellung) am angegebenen SnapshotPoint bildet.
GetTextViewLineContainingBufferPosition(SnapshotPoint)	Ruft die ITextViewLine ab, die die angegebene Textpufferposition enthält.
QueueSpaceReservationStackRefresh()	Fordert eine Aktualisierung des Platzreservierungsstapels an.

Ereignisse

Closed	Tritt sofort nach dem Schließen der Textansicht ein.
GotAggregateFocus	Tritt ein, wenn der Tastaturfokus zur Ansicht oder einem der Zusatzelemente wechselt.
LayoutChanged	Tritt auf, wenn sich der in der Ansicht angezeigte Text ändert.
LostAggregateFocus	Tritt ein, wenn der Tastaturfokus weg von der Ansicht und ihren Zusatzelementen wechselt.
MouseHover	Tritt auf, wenn der Mauszeiger auf dasselbe Zeichen gezeigt hat.
ViewportHeightChanged	Tritt auf, wenn die Höhe des Viewports geändert wird.
ViewportLeftChanged	Tritt auf, wenn die Position des linken Rands des Viewports geändert wird. (z. B. wenn die Ansicht horizontal gescrollt wird)
ViewportWidthChanged	Tritt auf, wenn die Breite des Viewports geändert wird.

Erweiterungsmethoden

GetInOuterLayout(ITextView)	Bestimmt, ob sich eine Ansicht gerade im Aufbau befindet oder vorbereitet wird.
GetMultiSelectionBroker(ITextView)	Ruft ein -Objekt zum Verwalten von Auswahlen in der Ansicht ab.
IsEmbeddedTextView(ITextView)	Ruft ab, ob angegeben ITextView in eine andere ITextVieweingebettet ist.
IsReadOnlyTextView(ITextView)	Ruft ab, ob angegeben ITextView als schreibgeschützt gilt.
QueuePostLayoutAction(ITextView, Action)	Siehe QueuePostLayoutAction(Action).
TryGetContainingTextView(ITextView, ITextView)	ITextView Ruft für den angegebenen eingebetteten ITextViewab.
TryGetTextViewLineContainingBufferPosition(ITextView, SnapshotPoint, ITextViewLine)	Siehe TryGetTextViewLineContainingBufferPosition(SnapshotPoint, ITextViewLine).
TryGetTextViewLines(ITextView, ITextViewLineCollection)	Siehe TryGetTextViewLines(ITextViewLineCollection).