ITextView Interfejs
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Reprezentuje widok tekstu w obiekcie ITextBuffer. Jest to klasa bazowa interfejsu specyficznego dla platformy, która ma metody umożliwiające renderowanie sformatowanego tekstu.
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
- Pochodne
- Implementuje
Uwagi
Widok tekstu to niezależna od platformy reprezentacja ciągłego bloku sformatowanego i ozdobnego tekstu dostępnego TextViewLines za pośrednictwem właściwości . Tworzy również wystąpienie składnika IEditorOperations, dzięki czemu może wykonywać różne polecenia.
Tekst jest formatowany na podstawie klasyfikatorów dołączonych do bazowego ITextBufferelementu .
Większość właściwości i parametrów, które są podwójne, odpowiada współrzędnych lub odległości w systemie współrzędnych renderowania tekstu. W tym układzie współrzędnych x = 0,0 odpowiada lewej krawędzi powierzchni rysunku, na której jest renderowany tekst (x = widok). ViewportLeft odpowiada lewej krawędzi okienka widoku) i y = view. ViewportTop odpowiada górnej krawędzi okienka widoku. Współrzędna x zwiększa się od lewej do prawej, a współrzędna y zwiększa się od góry do dołu.
Osie poziome i pionowe widoku zachowują się inaczej. Gdy tekst w widoku jest sformatowany, formatowane są tylko widoczne wiersze. W związku z tym nie można przewijać ekranu w poziomie i w pionie w taki sam sposób.
Okno widokowe jest przewijane w poziomie przez zmianę lewej współrzędnej panelu widoku, tak aby przesuwał się względem powierzchni rysunku.
Widok można przewijać tylko w pionie, wykonując nowy układ.
Wykonanie układu w widoku może spowodować zmianę właściwości ViewportTop widoku. Na przykład przewijanie w dół jednego wiersza nie spowoduje przetłumaczenia żadnego z widocznych wierszy. Zamiast tego spowoduje to po prostu zmianę właściwości ViewportTop widoku (powodując przejście wierszy na ekranie, mimo że ich współrzędne y nie uległy zmianie).
Odległości w systemie współrzędnych renderowania tekstu odpowiadają pikselom logicznym. Jeśli powierzchnia renderowania tekstu jest wyświetlana bez żadnego przekształcenia skalowania, 1 jednostka w systemie współrzędnych renderowania tekstu odpowiada jednemu pikselowi na ekranie.
Właściwości
BufferGraph |
Pobiera element IBufferGraph zawierający zestaw buforów źródłowych, które przyczyniają się do tego widoku. |
Caret |
Pobiera element karetki. |
HasAggregateFocus |
Określa, czy widok lub którykolwiek z jego ozdob ma fokus. |
InLayout |
Określa, czy widok jest w trakcie określania. |
IsClosed |
Określa, czy ten widok tekstu został zamknięty. |
IsMouseOverViewOrAdornments |
Określa, czy mysz znajduje się nad widokiem, czy z któregokolwiek z jego ozdobników. |
LineHeight |
Pobiera nominalną wysokość wiersza tekstu w widoku. |
MaxTextRightCoordinate |
Pobiera prawą współrzędną najdłuższej linii, niezależnie od tego, czy linia jest obecnie widoczna, w pikselach logicznych. |
Options |
Pobiera opcje dla tego widoku tekstu. |
Properties |
Kolekcja właściwości kontrolowana przez właściciela właściwości. (Odziedziczone po IPropertyOwner) |
ProvisionalTextHighlight |
Pobiera zakres tekstu objętego tymczasowym wyróżnieniem tekstu. |
Roles |
Role, które odgrywa ten widok. Role częściowo określają rozszerzenia, które są tworzone dla widoku. |
Selection |
Pobiera element wyboru. |
TextBuffer |
Pobiera tekst ITextBuffer , którego tekst jest renderowany w tym widoku. |
TextDataModel |
ITextDataModel Pobiera ten widok tekstu. |
TextSnapshot |
ITextSnapshot Pobiera tekst, który jest obecnie renderowany w widoku. |
TextViewLines |
Pobiera listę ITextViewLine obiektów renderowanych w tym widoku tylko do odczytu. |
TextViewModel |
ITextViewModel Pobiera ten widok tekstu. |
ViewportBottom |
Pobiera położenie dolnej krawędzi ekranu w układzie współrzędnych renderowania tekstu. |
ViewportHeight |
Pobiera wysokość widocznego okna zawartości w pikselach logicznych. |
ViewportLeft |
Pobiera lub ustawia położenie lewej krawędzi panelu widoków w układzie współrzędnych renderowania tekstu. |
ViewportRight |
Pobiera położenie prawej krawędzi ekranu w układzie współrzędnych renderowania tekstu. |
ViewportTop |
Pobiera położenie górnej krawędzi ekranu w układzie współrzędnych renderowania tekstu. |
ViewportWidth |
Pobiera szerokość widocznego okna zawartości w pikselach logicznych. |
ViewScroller |
Pobiera pomocnika, który udostępnia różne metody przewijania lub manipulowania widokiem. |
VisualSnapshot |
ITextSnapshot Pobiera bufor wizualizacji, który jest renderowany. |
Metody
Close() |
Zamyka widok tekstu i jego widok. |
DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition, Nullable<Double>, Nullable<Double>) |
Formatuje i wyświetla zawartość buforu tekstowego, tak aby ITextViewLine zawieranie |
DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition) |
Formatuje i wyświetla zawartość buforu tekstowego, tak aby ITextViewLine zawieranie |
GetTextElementSpan(SnapshotPoint) |
Pobiera tekst SnapshotSpan , który stanowi element tekstowy (pojedynczą reprezentację wizualną) na danym SnapshotPointobiekcie . |
GetTextViewLineContainingBufferPosition(SnapshotPoint) |
Pobiera element ITextViewLine zawierający określone położenie buforu tekstowego. |
QueueSpaceReservationStackRefresh() |
Żąda odświeżenia stosu rezerwacji miejsca. |
Zdarzenia
Closed |
Występuje natychmiast po zamknięciu widoku tekstu. |
GotAggregateFocus |
Występuje, gdy fokus klawiatury przełącza się do widoku lub jednego z jego ozdobników. |
LayoutChanged |
Występuje za każdym razem, gdy tekst wyświetlany w widoku ulegnie zmianie. |
LostAggregateFocus |
Występuje, gdy fokus klawiatury przełącza się z dala od widoku i dowolnych jego ozdobników. |
MouseHover |
Występuje po umieszczeniu wskaźnika myszy na tym samym znaku. |
ViewportHeightChanged |
Występuje, gdy wysokość widoku jest zmieniana. |
ViewportLeftChanged |
Występuje, gdy pozycja lewej krawędzi okienka widoku jest zmieniana. (np. gdy widok jest przewijany w poziomie) |
ViewportWidthChanged |
Występuje, gdy szerokość widoku jest zmieniana. |
Metody rozszerzania
GetInOuterLayout(ITextView) |
Określa, czy widok jest w trakcie określania, czy przygotowuje się do ustalenia. |
GetMultiSelectionBroker(ITextView) |
Pobiera obiekt do zarządzania wyborami w widoku. |
IsEmbeddedTextView(ITextView) |
Pobiera informację, czy dana ITextView wartość jest osadzona w innym ITextViewobiekcie . |
IsReadOnlyTextView(ITextView) |
Pobiera informację, czy dana wartość ITextView jest uznawana za tylko do odczytu. |
QueuePostLayoutAction(ITextView, Action) |
Zobacz: . |
TryGetContainingTextView(ITextView, ITextView) |
Pobiera element ITextView zawierający dla danej osadzonej ITextView. |
TryGetTextViewLineContainingBufferPosition(ITextView, SnapshotPoint, ITextViewLine) |
Zobacz: . |
TryGetTextViewLines(ITextView, ITextViewLineCollection) |
Zobacz: . |