ITextView Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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::IPropertyOwnerpublic interface class ITextView : Microsoft::VisualStudio::Utilities::IPropertyOwner__interface ITextView : Microsoft::VisualStudio::Utilities::IPropertyOwnerpublic interface ITextView : Microsoft.VisualStudio.Utilities.IPropertyOwnertype ITextView = interface
interface IPropertyOwnerPublic Interface ITextView
Implements IPropertyOwner- Abgeleitet
- Implementiert
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, Nullable<Double>, Nullable<Double>) |
Formatiert und zeigt den Inhalt des Textpuffers an, sodass der ITextViewLine enthaltende |
| DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition) |
Formatiert und zeigt den Inhalt des Textpuffers an, sodass der ITextViewLine enthaltende |
| 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) | |
| TryGetContainingTextView(ITextView, ITextView) |
ITextView Ruft für den angegebenen eingebetteten ITextViewab. |
| TryGetTextViewLineContainingBufferPosition(ITextView, SnapshotPoint, ITextViewLine) |
Siehe TryGetTextViewLineContainingBufferPosition(SnapshotPoint, ITextViewLine). |
| TryGetTextViewLines(ITextView, ITextViewLineCollection) |