ITextView
ITextView
ITextView
ITextView
ITextView
ITextView
Interface
Definition
Represents a view of text in an ITextBuffer. It is the base class for a platform-specific interface that has methods to allow the formatted text to be rendered.
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- Derived
- Implements
Remarks
A text view is a platform-independent representation of a contiguous block of formatted and adorned text. The text can be accessed through the TextViewLines property.
For more information about text views, see the section "The Text View" in Inside the Editor.
The text view also instantiates an instance of an IEditorOperations component part so that it can execute various commands.
The text is formatted based on the classifiers that are attached to the underlying ITextBuffer.
Most properties and parameters that are doubles correspond to coordinates or distances in the text rendering coordinate system. In this coordinate system, x = 0.0 corresponds to the left edge of the drawing surface onto which text is rendered (x = view.ViewportLeft corresponds to the left edge of the viewport), and y = view.ViewportTop corresponds to the top edge of the viewport. The x-coordinate increases from left to right, and the y-coordinate increases from top to bottom. The horizontal and vertical axes of the view behave differently. When the text in the view is formatted, only the visible lines are formatted. As a result, a viewport cannot be scrolled horizontally and vertically in the same way. A viewport is scrolled horizontally by changing the left coordinate of the viewport so that it moves with respect to the drawing surface. A view can be scrolled vertically only by performing a new layout. Doing a layout in the view may cause the ViewportTop property of the view to change.
For example, scrolling down one line will not translate any of the visible lines. Instead it will simply change the ViewportTop property, which causes the lines to move on the screen even though their y-coordinates have not changed. Distances in the text rendering coordinate system correspond to logical pixels. If the text rendering surface is displayed without any scaling transform, then one unit in the text rendering coordinate system corresponds to one pixel in the display.