ITextViewLine-Schnittstelle

Stellt Text dar, der für die Anzeige in einer Textansicht formatiert wurde.

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

Syntax

'Declaration
Public Interface ITextViewLine

public interface ITextViewLine

public interface class ITextViewLine

type ITextViewLine =  interface end

public interface ITextViewLine

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

Eigenschaften

	Name	Beschreibung
	Baseline	Ruft den Abstand zwischen dem oberen Rand des Texts und dem Baseline-Text in der Zeile ab.
	Bottom	Ruft die Position des unteren Rands dieser Zeile im Textrendering-Koordinatensystem ab.
	Change	Ruft die Änderung an dieser gerenderten Textzeile zwischen dem aktuellen Layout und dem vorherigen Layout ab.
	DefaultLineTransform	Ruft den Standardwert LineTransform ab, das verwendet wird, um diese Zeile zu rendern.
	DeltaY	Ruft die Änderung der Anfang dieser gerenderten Textzeile zwischen dem Wert von Top im aktuellen Lay-out und dem Wert von Top im vorherigen Lay-out ab.
	End	Ruft die Position des ersten Zeichens nach dem Ende der Zeile ab, ausschließlich Zeilenumbruchzeichen.
	EndIncludingLineBreak	Ruft die Position des ersten Zeichens nach dem Ende der Zeile ab, einschließlich aller Zeilenumbruchzeichen.
	EndOfLineWidth	Ruft die Entfernung vom rechten Rand des letzten Zeichens in dieser Zeile zum Ende des Leerzeichens dieser Zeile ab.
	Extent	Ruft den Umfang der Zeile ab, ausschließlich aller Zeilenumbruchzeichen.
	ExtentAsMappingSpan	Ruft die IMappingSpan ab, die dem Extent der Zeile entspricht.
	ExtentIncludingLineBreak	Ruft den Umfang der Zeile ab, einschließlich aller Zeilenumbruchzeichen.
	ExtentIncludingLineBreakAsMappingSpan	Ruft die IMappingSpan ab, die ExtentIncludingLineBreak entspricht.
	Height	Ruft die Entfernung zwischen dem oberen und dem unteren Rand dieser Zeile ab.
	IdentityTag	Ruft ein Tag ab, mit dem die Identität einer ITextViewLine über Layouts in der Ansicht hinweg verfolgt werden kann.
	IsFirstTextViewLineForSnapshotLine	Bestimmt, ob diese ITextViewLine die erste Zeile in der Liste der für eine bestimmte ITextSnapshotLine formatierten Zeilen ist.
	IsLastTextViewLineForSnapshotLine	Bestimmt, ob diese ITextViewLine die letzte Zeile in der Liste der für eine bestimmte ITextSnapshotLine formatierten Zeilen ist.
	IsValid	Bestimmt, ob diese Textansichtszeile noch gültig ist.
	Left	Ruft die Position des linken Rands dieser Zeile im Textrendering-Koordinatensystem ab.
	Length	Ruft die Länge der Zeile ab, ausschließlich aller Zeilenumbruchzeichen.
	LengthIncludingLineBreak	Ruft die Länge der Zeile ab, einschließlich aller Zeilenumbruchzeichen.
	LineBreakLength	Ruft die Länge der Zeilenumbruchsequenz ab (z. B. "\r\n"), die am Ende dieser Zeile angezeigt wird.
	LineTransform	Ruft den zum Rendern dieser Zeile verwendeten LineTransform ab.
	Right	Ruft die Position des rechten Rands dieser Zeile im Textrendering-Koordinatensystem ab.
	Snapshot	Ruft den ITextSnapshot ab, auf dem diese Zuordnung basiert.
	Start	Ruft die Position in Snapshot des ersten Zeichens in der Zeile ab.
	TextBottom	Ruft die y-Koordinate für den unteren Rand des Texts in der gerenderten Zeile ab.
	TextHeight	Ruft die vertikale Entfernung zwischen dem oberen und unteren Rand des Texts in der gerenderten Zeile ab.
	TextLeft	Ruft die x-Koordinate für den linken Rand des Texts in der gerenderten Zeile ab.
	TextRight	Ruft die x-Koordinate für den rechten Rand des Texts in der gerenderten Zeile ab.
	TextTop	Ruft die y-Koordinate für den oberen Rand des Texts in der gerenderten Zeile ab.
	TextWidth	Ruft die horizontale Entfernung zwischen TextRight und TextLeft ab.
	Top	Ruft die Position des oberen Rands dieser Zeile im Textrendering-Koordinatensystem ab.
	VirtualSpaceWidth	Ruft die Breite des virtuellen Leerzeichens am Ende dieser Zeile ab.
	VisibilityState	Ruft den Sichtbarkeitszustand dieser gerenderten Textzeile in Bezug auf den oberen und unteren Rand der Ansicht ab.
	Width	Ruft den Abstand zwischen dem linken und dem rechten Rand dieser Zeile ab.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	ContainsBufferPosition	Bestimmt, ob die angegebene Pufferposition innerhalb dieser Textzeile liegt.
	GetAdornmentBounds	Berechnet die Grenzen des angegebenen Zusatzelements.
	GetAdornmentTags	Ruft die in der Zeile positionierten Zusatzelemente ab.
	GetBufferPositionFromXCoordinate(Double)	Ruft die Pufferposition des Zeichens ab, dessen Zeichenbegrenzungen die angegebene x-Koordinate enthalten.
	GetBufferPositionFromXCoordinate(Double, Boolean)	Ruft die Pufferposition des Zeichens ab, dessen Zeichenbegrenzungen die angegebene x-Koordinate enthalten.
	GetCharacterBounds(SnapshotPoint)	Berechnet die Grenzen des Zeichens an der angegebenen Pufferposition.
	GetCharacterBounds(VirtualSnapshotPoint)	Berechnet die Grenzen des Zeichens an der angegebenen Pufferposition.
	GetExtendedCharacterBounds(SnapshotPoint)	Berechnet die Grenzen des Zeichens an der angegebenen Pufferposition, einschließlich aller benachbarten Zusatzelemente mit Platzausgleich.
	GetExtendedCharacterBounds(VirtualSnapshotPoint)	Berechnet die Grenzen des Zeichens an der angegebenen virtuellen Pufferposition, einschließlich aller benachbarten Zusatzelemente mit Platzausgleich.
	GetInsertionBufferPositionFromXCoordinate	Ruft die verwendete Pufferposition ab, wenn neue Daten an der angegebenen x-Koordinate eingefügt werden sollen.
	GetNormalizedTextBounds	Ruft eine Auflistung von TextBounds-Strukturen für den Text ab, die der angegebenen Spanne entspricht.
	GetTextElementSpan	Ruft die Spanne ab, deren Textelementindex der angegebenen Pufferposition entspricht.
	GetVirtualBufferPositionFromXCoordinate	Ruft die Pufferposition des Zeichens ab, dessen Zeichenbegrenzungen die angegebene x-Koordinate enthalten.
	IntersectsBufferSpan	Bestimmt, ob eine bufferSpan diese Textzeile schneidet.

Zum Seitenanfang

Hinweise

Weitere Informationen über Formatierungen finden Sie im Abschnitt „des formatierten Texts“ Innerhalb des Editors.

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 das ViewportTop-Eigenschaft der Ansicht (und bewirkt, dass sich die Zeilen 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, transformieren Sie dann entspricht 1 Einheit im Textrendering-Koordinatensystem einem Pixel für die Anzeige.

Siehe auch

Referenz

Microsoft.VisualStudio.Text.Formatting-Namespace