ITextView-Schnittstelle

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.

Namespace:  Microsoft.VisualStudio.Text.Editor
Assembly:  Microsoft.VisualStudio.Text.UI (in Microsoft.VisualStudio.Text.UI.dll)

Syntax

'Declaration
Public Interface ITextView _
    Inherits IPropertyOwner

public interface ITextView : IPropertyOwner

public interface class ITextView : IPropertyOwner

type ITextView =  
    interface 
        interface IPropertyOwner 
    end

public interface ITextView extends IPropertyOwner

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

Eigenschaften

	Name	Beschreibung
	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	Ruft die Auflistung von Eigenschaften ab, die vom Besitzer gesteuert werden. (Von IPropertyOwner geerbt.)
	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 Textrendering-Koordinatensystem ab.
	ViewportHeight	Ruft die Höhe des sichtbaren Inhaltsfensters (einschließlich des Rands) in logischen Pixeln ab.
	ViewportLeft	Ruft die Position des linken Rands des Viewports im Textrendering-Koordinatensystem ab oder legt diese fest.
	ViewportRight	Ruft die Position des rechten Rands des Viewports im Textrendering-Koordinatensystem ab.
	ViewportTop	Ruft die Position des oberen Rands des Viewports im Textrendering-Koordinatensystem ab.
	ViewportWidth	Ruft die Breite des sichtbaren Inhaltsfensters (einschließlich des Rands) 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.

Zum Seitenanfang

Methoden

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

Zum Seitenanfang

Ereignisse

	Name	Beschreibung
	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 ein, wenn der Text-Editor ein Textzeilenlayout ausführt.
	LostAggregateFocus	Tritt ein, wenn der Tastaturfokus weg von der Ansicht und ihren Zusatzelementen wechselt.
	MouseHover	Tritt ein, wenn der Mauszeiger sich auf einem Zeichen gezeigt hat.
	ViewportHeightChanged	Tritt ein, wenn die Höhe der Viewport geändert wird.Veraltet.
	ViewportLeftChanged	Tritt ein, wenn die Position für den linken Rand des Viewports geändert wird.Veraltet
	ViewportWidthChanged	Tritt ein, wenn sich die Breite der Viewport geändert wird.Veraltet.

Zum Seitenanfang

Hinweise

Eine Textansicht ist eine plattformunabhängige Darstellung eines zusammenhängenden Blocks verzierten und formatierten Texts. Der Text kann über die TextViewLines-Eigenschaft zugegriffen werden.

Weitere Informationen über Textansichten finden Sie im Abschnitt „in“ Text-Ansicht die Innerhalb des Editors.

Die Textansicht instanziiert außerdem eine Instanz einer IEditorOperations Komponente, sodass sie unterschiedliche Befehle ausführen kann.

Der Text wird auf Grundlage der Formatierung von Klassifizierern, die auf die zugrunde liegende ITextBufferangefügt werden.

Die meisten Eigenschaften und Parameter, die Doubles sind, entsprechen den Koordinaten oder Abständen im Textrendering-Koordinatensystem. In diesem Koordinatensystem ist x = 0.0 bis zur linken Kante der Zeichenoberfläche, für die Text (x = view.ViewportLeft entspricht dem linken Rand des Viewports) gerendert wird, und y = view.ViewportTop entspricht dem oberen Rand des Viewports. Die x-Koordinate vergrößert sich von links nach rechts und y-Koordinaten vergrößert sich von oben nach unten. Das horizontale und Hochachsen der Ansicht verhalten sich anders. Wenn der Text in der Ansicht formatiert wird, werden nur die sichtbaren Zeilen formatiert werden. Daher kann es sich um einen Viewport nicht auf die horizontale und vertikale Bildläufe durchgeführt werden. Ein Viewport horizontaler Bildlauf durchgeführt wird, indem die linke Koordinate des Viewports geändert wird, damit er in Bezug auf die Zeichenoberfläche befindet. Eine Sicht kann nur ein vertikaler Bildlauf durchgeführt werden, indem ein neues Lay-out ausgeführt wird. Dies eines Lay-outs in der Ansicht kann die ViewportTop-Eigenschaft der Ansicht für die Änderung.

Zum Beispiel übersetzt das Bildlauf um eine Zeile nach unten ausführen keine sichtbaren Zeilen. Stattdessen ändert er einfach die ViewportTop-Eigenschaft bewirkt, dass die Zeilen, die sich auf dem Bildschirm zu verschieben, obwohl ihre Y-Koordinaten nicht geändert haben. Lücken im Textrendering-Koordinatensystem entsprechen den logischen Pixeln. Wenn die Oberfläche Rendern von Text ohne Skalierung angezeigt wird, ist ein Gerät im Textrendering-Koordinatensystem einem Pixel in der Anzeige.

Siehe auch

Referenz

Microsoft.VisualStudio.Text.Editor-Namespace