Class View

Namespace: Terminal.Gui.ViewBase

Assembly: Terminal.Gui.dll

View is the base class all visible elements. View can render itself and contains zero or more nested views, called SubViews. View provides basic functionality for layout, arrangement, and drawing. In addition, View provides keyboard and mouse event handling.

See the View Deep Dive for more.

public class View : IDisposable, ISupportInitializeNotification, ISupportInitialize

Inheritance: object

View

Implements: IDisposable

ISupportInitializeNotification

ISupportInitialize

Inherited Members: object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

Constructors

View(): Initializes a new instance of View.

Properties

Arrangement: Gets or sets the user actions that are enabled for the arranging this view within it's SuperView.

Border

The Adornment that offsets the Viewport from the Margin.

The Border provides the space for a visual border (drawn using line-drawing glyphs) and the Title. The Border expands inward; in other words if `Border.Thickness.Top == 2` the border and title will take up the first row and the second row will be filled with spaces.

The Border provides the UI for mouse and keyboard arrangement of the View. See Arrangement.

BorderStyle: Gets or sets whether the view has a one row/col thick border.

CanFocus: Gets or sets a value indicating whether this View can be focused.

ContentSizeTracksViewport: Gets or sets a value indicating whether the view's content size tracks the Viewport's size or not.

CursorVisibility: Gets or sets the cursor style to be used when the view is focused. The default is Invisible.

Data: Gets or sets arbitrary data for the view.

Diagnostics: Gets or sets whether diagnostic information will be drawn. This is a bit-field of ViewDiagnosticFlags.e View diagnostics.

Enabled: Gets or sets a value indicating whether this View can respond to user interaction.

Focused: Gets the currently focused SubView or Adornment of this view, or null if nothing is focused.

Frame: Gets or sets the absolute location and dimension of the view.

HasFocus: Gets or sets whether this view has focus.

HasScheme: Gets whether a Scheme has been explicitly set for this View, or if it will inherit the Scheme from its SuperView.

Height: Gets or sets the height dimension of the view.

HighlightStates: Gets or sets which MouseState changes should cause the View to change its appearance.

HorizontalScrollBar: Gets the horizontal ScrollBar. This property is lazy-loaded and will not be created until it is accessed.

HotKey

Gets or sets the hot key defined for this view. Pressing the hot key on the keyboard while this view has focus will invoke HotKey. By default, the HotKey is set to the first character of Text that is prefixed with HotKeySpecifier.

A HotKey is a keypress that causes a visible UI item to perform an action. For example, in a Dialog, with a Button with the text of "_Text" Alt+T will cause the button to gain focus and to raise its Accepting event. Or, in a Terminal.Gui.Views.Menu with "_File _Edit", Alt+F will select (show) the "_File" menu. If the "_File" menu has a sub-menu of "_New" Alt+N or N will ONLY select the "_New" sub-menu if the "_File" menu is already opened.

View subclasses can use AddCommand(Command, CommandImplementation) to define the behavior of the hot key.

HotKeyBindings: Gets the bindings for this view that will be invoked regardless of whether this view has focus or not.

HotKeySpecifier: Gets or sets the specifier character for the hot key (e.g. '_'). Set to '\xffff' to disable automatic hot key setting support for this View instance. The default is '\xffff'.

Id: Gets or sets an identifier for the view;

IsCurrentTop: Returns a value indicating if this View is currently on Top (Active)

IsInitialized: Get or sets if the View has been initialized (via BeginInit() and EndInit()).

KeyBindings: Gets the bindings for this view that will be invoked only if this view has focus.

LineCanvas: The canvas that any line drawing that is to be shared by subviews of this view should add lines to.

Margin: The Adornment that enables separation of a View from other SubViews of the same SuperView. The margin offsets the Viewport from the Frame.

MostFocused: Returns the most focused SubView down the subview-hierarchy.

MouseBindings: Gets the mouse bindings for this view.

MouseHeldDown: Handles WantContinuousButtonPressed, we have detected a button down in the view and have grabbed the mouse.

MouseState: Gets the state of the mouse relative to the View. When changed, the MouseStateChanged/ OnMouseStateChanged(EventArgs<MouseState>) event will be raised.

NeedsDraw: Gets or sets whether the view needs to be redrawn.

NeedsLayout: Indicates the View's Frame or the layout of the View's subviews (including Adornments) have changed since the last time the View was laid out.

Padding: The Adornment inside of the view that offsets the Viewport from the Border.

PreserveTrailingSpaces: Gets or sets whether trailing spaces at the end of word-wrapped lines are preserved or not when WordWrap is enabled. If true trailing spaces at the end of wrapped lines will be removed when Text is formatted for display. The default is false.

SchemeName: Gets or sets the name of the scheme to use for this View. If set, it overrides the scheme inherited from the SuperView. If a scheme was explicitly set (HasScheme is true), this property is ignored.

ScreenContents: Gets the screen buffer contents. This is a convenience property for Views that need direct access to the screen buffer.

ShadowStyle: Gets or sets whether the View is shown with a shadow effect. The shadow is drawn on the right and bottom sides of the Margin.

SubViewNeedsDraw: Gets whether any SubViews need to be redrawn.

SubViews: Gets the list of SubViews.

SuperView: Gets this Views SuperView (the View's container), or null if this view has not been added as a SubView.

SuperViewRendersLineCanvas: Gets or sets whether this View will use it's SuperView's LineCanvas for rendering any lines. If true the rendering of any borders drawn by this Frame will be done by its parent's SuperView. If false (the default) this View's OnDrawingAdornments() method will be called to render the borders.

TabStop: Gets or sets the behavior of AdvanceFocus(NavigationDirection, TabBehavior?) for keyboard navigation.

Text: The text displayed by the View.

TextAlignment: Gets or sets how the View's Text is aligned horizontally when drawn. Changing this property will redisplay the View.

TextDirection: Gets or sets the direction of the View's Text. Changing this property will redisplay the View.

TextFormatter: Gets or sets the TextFormatter used to format Text.

Title: The title to be displayed for this View. The title will be displayed if Border. Top is greater than 0. The title can be used to set the HotKey for the view by prefixing character with HotKeySpecifier (e.g. "T_itle").

ValidatePosDim: Gets or sets whether validation of Pos and Dim occurs.

VerticalScrollBar: Gets the vertical ScrollBar. This property is lazy-loaded and will not be created until it is accessed.

VerticalTextAlignment: Gets or sets how the View's Text is aligned vertically when drawn. Changing this property will redisplay the View.

Viewport: Gets or sets the rectangle describing the portion of the View's content that is visible to the user. The viewport Location is relative to the top-left corner of the inner rectangle of Padding. If the viewport Size is the same as GetContentSize(), or GetContentSize() is null the Location will be 0, 0.

ViewportSettings: Gets or sets how scrolling the Viewport on the View's Content Area is handled.

Visible: Gets or sets a value indicating whether this View is visible.

WantContinuousButtonPressed: Gets or sets whether the View wants continuous button pressed events. When set to true, and the user presses and holds the mouse button, NewMouseEvent(MouseEventArgs) will be repeatedly called with the same MouseFlags for as long as the mouse button remains pressed.

WantMousePositionReports: Gets or sets whether the View wants mouse position reports.

Width: Gets or sets the width dimension of the view.

X: Gets or sets the X position for the view (the column).

Y: Gets or sets the Y position for the view (the row).

Methods

Add(View?): Adds a SubView (child) to this view.

Add(params View[]?): Adds the specified SubView (children) to the view.

AddCommand(Command, Func<bool?>)

Sets the function that will be invoked for a Command. Views should call AddCommand for each command they support.

If AddCommand has already been called for command impl will replace the old one.

AddCommand(Command, CommandImplementation)

Sets the function that will be invoked for a Command. Views should call AddCommand for each command they support.

If AddCommand has already been called for command impl will replace the old one.

AddKeyBindingsForHotKey(Key, Key, object?): Adds key bindings for the specified HotKey. Useful for views that contain multiple items that each have their own HotKey such as RadioGroup.

AddRune(char): Adds the specified char to the display at the current cursor position. This method is a convenience method that calls AddRune(Rune) with the Rune constructor.

AddRune(int, int, Rune): Draws the specified character in the specified viewport-relative column and row of the View.

AddRune(Rune): Draws the specified character at the current draw position.

AddStr(string): Adds the str to the display at the current draw position.

AddViewportToClip(): Changes the Clip to the intersection of the current Clip and the Viewport of this View.

AdvanceFocus(NavigationDirection, TabBehavior?): Advances the focus to the next or previous view in the focus chain, based on direction. itself.

BeginInit(): Signals the View that initialization is starting. See ISupportInitialize.

ClearFocus(): Clears any focus state (e.g. the previously focused subview) from this view.

ClearNeedsDraw(): Clears NeedsDraw and SubViewNeedsDraw.

ClearViewport(DrawContext?): Clears Viewport with the normal background.

Contains(in Point): Indicates whether the specified SuperView-relative coordinates are within the View's Frame.

ContentToScreen(in Point): Converts a Content-relative location to a Screen-relative location.

Dispose(): Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resource.

Dispose(bool): Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

DoInvokeCommands(Key)

Invokes the Commands bound to key.

See for an overview of Terminal.Gui keyboard APIs.

Draw(DrawContext?): Draws the view if it needs to be drawn.

DrawAdornments(): Causes Margin, Border, and Padding to be drawn.

DrawHotString(string, bool): Utility function to draw strings that contains a hotkey using a Scheme and the "focused" state.

DrawHotString(string, Attribute, Attribute): Utility function to draw strings that contain a hotkey.

DrawSubViews(DrawContext?): Draws the SubViews.

DrawText(DrawContext?): Draws the Text of the View using the TextFormatter.

EndInit(): Signals the View that initialization is ending. See ISupportInitialize.

ExcludeFromClip(Rectangle): Removes the specified rectangle from the Clip.

ExcludeFromClip(Region?): Removes the specified rectangle from the Clip.

FillRect(Rectangle, Color?): Fills the specified Viewport-relative rectangle with the specified color.

FillRect(Rectangle, Rune): Fills the specified Viewport-relative rectangle.

FocusDeepest(NavigationDirection, TabBehavior?): Focuses the deepest focusable SubView if one exists. If there are no focusable SubViews then the focus is set to the view itself.

FrameToScreen(): Gets the Frame with a screen-relative location.

GetAdornmentsThickness(): Gets the thickness describing the sum of the Adornments' thicknesses.

GetAttributeForRole(VisualRole)

Gets the Attribute associated with a specified VisualRole from the Scheme.

Raises OnGettingAttributeForRole(in VisualRole, ref Attribute)/GettingAttributeForRole which can cancel the default behavior, and optionally change the attribute in the event args.

If Enabled is false, Disabled will be used instead of role. To override this behavior use OnGettingAttributeForRole(in VisualRole, ref Attribute)/GettingAttributeForRole to cancel the method, and return a different attribute.

If HighlightStates is not None and MouseState is In the Highlight will be used instead of role. To override this behavior use OnGettingAttributeForRole(in VisualRole, ref Attribute)/GettingAttributeForRole to cancel the method, and return a different attribute.

GetClip(): Gets the current Clip region.

GetContentSize(): Gets the size of the View's content.

GetCurrentAttribute(): Gets the current Attribute used by AddRune(Rune).

GetHeightRequiredForSubViews(): Gets the number of rows required for all the View's SubViews.

GetScheme(): Gets the scheme for the View. If the scheme has not been explicitly set (see HasScheme), gets the SuperView's scheme or falls back to the base scheme.

GetSupportedCommands(): Returns all commands that are supported by this View.

GetViewportOffsetFromFrame(): Helper to get the X and Y offset of the Viewport from the Frame. This is the sum of the Left and Top properties of Margin, Border and Padding.

GetViewsUnderLocation(in Point, ViewportSettingsFlags): Gets the Views that are under screenLocation, including Adornments. The list is ordered by depth. The deepest View is at the end of the list (the top most View is at element 0).

GetWidthRequiredForSubViews(): Gets the number of rows required for all the View's SubViews.

InvokeCommand(Command): Invokes the specified command without context.

InvokeCommand(Command, ICommandContext?): Invokes the specified command.

InvokeCommand<TBindingType>(Command, TBindingType): Invokes the specified command.

InvokeCommandsBoundToMouse(MouseEventArgs)

Invokes the Commands bound to the MouseFlags specified by mouseEventArgs.

See for an overview of Terminal.Gui mouse APIs.

InvokeCommands<TBindingType>(Command[], TBindingType): Invokes the specified commands.

IsInHierarchy(View?, View?, bool): Gets whether view is in the View hierarchy of start.

Layout(): Performs layout of the view and its subviews using the content size of either the SuperView or Screen.

Layout(Size): Performs layout of the view and its subviews within the specified content size.

Move(int, int): Moves the drawing cursor to the specified Viewport-relative location in the view.

MoveSubViewToEnd(View): Moves subview to the end of the SubViews list. If the Arrangement is Overlapped, keeps the original sorting.

MoveSubViewToStart(View): Moves subview to the start of the SubViews list.

MoveSubViewTowardsEnd(View): Moves subview one position towards the end of the SubViews list.

MoveSubViewTowardsStart(View): Moves subview one position towards the start of the SubViews list.

NewKeyDownEvent(Key): If the view is enabled, raises the related key down events on the view, and returns true if the event was handled.

NewKeyUpEvent(Key): If the view is enabled, raises the related key up events on the view, and returns true if the event was handled.

NewMouseEvent(MouseEventArgs): Processes a new MouseEvent. This method is called by RaiseMouseEvent(MouseEventArgs) when a mouse event occurs.

OnAccepting(CommandEventArgs): Called when the user is accepting the state of the View and the Accept has been invoked. Set CommandEventArgs.Handled to true and return true to indicate the event was handled and processing should stop.

OnAdvancingFocus(NavigationDirection, TabBehavior?): Called when AdvanceFocus(NavigationDirection, TabBehavior?) is about to advance focus.

OnBorderStyleChanged(): Called when the BorderStyle has changed.

OnCanFocusChanged(): Invoked when the CanFocus property from a view is changed.

OnClearedViewport(): Called when the Viewport has been cleared

OnClearingViewport(): Called when the Viewport is to be cleared.

OnCommandNotBound(CommandEventArgs): Called when a command that has not been bound is invoked. Set CommandEventArgs.Handled to true and return true to indicate the event was handled and processing should stop.

OnContentSizeChanged(SizeChangedEventArgs): Called when GetContentSize() has changed.

OnDrawComplete(DrawContext?): Called when the View is completed drawing.

OnDrawingAdornments(): Called when the View's Adornments are to be drawn. Prepares LineCanvas. If SuperViewRendersLineCanvas is true, only the LineCanvas of this view's subviews will be rendered. If SuperViewRendersLineCanvas is false (the default), this method will cause the LineCanvas be prepared to be rendered.

OnDrawingContent(): Called when the View's content is to be drawn. The default implementation does nothing.

OnDrawingContent(DrawContext?): Called when the View's content is to be drawn. The default implementation does nothing.

OnDrawingSubViews(): Called when the SubViews are to be drawn.

OnDrawingSubViews(DrawContext?): Called when the SubViews are to be drawn.

OnDrawingText(): Called when the Text of the View is to be drawn.

OnDrawingText(DrawContext?): Called when the Text of the View is to be drawn.

OnDrewText(): Called when the Text of the View has been drawn.

OnEnabledChanged(): Invoked when the Enabled property from a view is changed.

OnFocusedChanged(View?, View?): Called when the focused view has changed.

OnFrameChanged(in Rectangle): Called when Frame changes.

OnGettingAttributeForRole(in VisualRole, ref Attribute): Called when the Attribute for a GetAttributeForRole(VisualRole) is being retrieved. Implementations can return true to stop further processing and optionally set the Attribute in the event args to a different value.

OnGettingScheme(out Scheme?): Called when the Scheme for the View is being retrieved. Subclasses can return true to stop further processing and optionally set scheme to a different value.

OnHandlingHotKey(CommandEventArgs): Called when the View is handling the user pressing the View's HotKey. Set CommandEventArgs.Handled to true to indicate the event was handled and processing should stop.

OnHasFocusChanged(bool, View?, View?): Invoked after HasFocus has changed. This method is called before the HasFocusChanged event is raised.

OnHasFocusChanging(bool, bool, View?, View?): Invoked when HasFocus is about to change. This method is called before the HasFocusChanging event is raised.

OnHeightChanged(ValueChangedEventArgs<Dim>): Called after the Height property changes, allowing subclasses to react to the change.

OnHeightChanging(ValueChangingEventArgs<Dim>): Called before the Height property changes, allowing subclasses to cancel or modify the change.

OnKeyDown(Key): Called when the user presses a key, allowing subscribers to pre-process the key down event. Called before key bindings are invoked and KeyDownNotHandled is raised. Set Handled to true to stop the key from being processed further.

OnKeyDownNotHandled(Key): Called when the user has pressed key it wasn't handled by KeyDown and was not bound to a key binding.

OnKeyUp(Key): Called when a key is released. This method is called from NewKeyUpEvent(Key).

OnMouseClick(MouseEventArgs): Called when a mouse click occurs. Check Flags to see which button was clicked.

OnMouseEnter(CancelEventArgs): Called when the mouse moves over the View's Frame and no other non-SubView occludes it. MouseLeave will be raised when the mouse is no longer over the Frame.

OnMouseEvent(MouseEventArgs): Called when a mouse event occurs within the view's Viewport.

OnMouseLeave(): Called when the mouse moves outside View's Frame, or is occluded by another non-SubView.

OnMouseStateChanged(EventArgs<MouseState>): Called when MouseState has changed, indicating the View should be highlighted or not. The MouseState passed in the event indicates the highlight style that will be applied.

OnMouseWheel(MouseEventArgs): Called when a mouse wheel event occurs. Check Flags to see which wheel was moved was clicked.

OnRenderingLineCanvas(): Called when the LineCanvas is to be rendered. See RenderLineCanvas().

OnSchemeChanged(ValueChangedEventArgs<Scheme?>): Called after the scheme is set, allowing subclasses to react to the change.

OnSchemeNameChanged(ValueChangedEventArgs<string?>): Called after the SchemeName property changes, allowing subclasses to react to the change.

OnSchemeNameChanging(ValueChangingEventArgs<string?>): Called before the SchemeName property changes, allowing subclasses to cancel or modify the change.

OnSelecting(CommandEventArgs): Called when the user has performed an action (e.g. Select) causing the View to change state. Set CommandEventArgs.Handled to true and return true to indicate the event was handled and processing should stop.

OnSettingScheme(ValueChangingEventArgs<Scheme?>): Called before the scheme is set, allowing subclasses to cancel or modify the change.

OnSubViewAdded(View): Called when a SubView has been added to this View.

OnSubViewLayout(LayoutEventArgs): Called from Terminal.Gui.ViewBase.View.LayoutSubViews() before any subviews have been laid out.

OnSubViewRemoved(View): Called when a SubView has been removed from this View.

OnSubViewsLaidOut(LayoutEventArgs): Called from Terminal.Gui.ViewBase.View.LayoutSubViews() after all sub-views have been laid out.

OnSuperViewChanged(SuperViewChangedEventArgs): Called when the SuperView of this View has changed.

OnTextChanged(): Called when the Text has changed. Fires the TextChanged event.

OnTitleChanged(): Called when the Title has been changed. Invokes the TitleChanged event.

OnTitleChanging(ref string): Called before the Title changes. Invokes the TitleChanging event, which can be cancelled.

OnViewportChanged(DrawEventArgs): Called when the Viewport changes. Invokes the ViewportChanged event.

OnVisibleChanged(): Called when Visible has changed.

OnVisibleChanging(): Called when Visible is changing. Can be cancelled by returning true.

OnWidthChanged(ValueChangedEventArgs<Dim>): Called after the Width property changes, allowing subclasses to react to the change.

OnWidthChanging(ValueChangingEventArgs<Dim>): Called before the Width property changes, allowing subclasses to cancel or modify the change.

PositionCursor(): Positions the cursor in the right position based on the currently focused view in the chain.

RaiseAccepting(ICommandContext?): Called when the user is accepting the state of the View and the Accept has been invoked. Calls OnAccepting(CommandEventArgs) which can be cancelled; if not cancelled raises Accepting. event. The default Accept handler calls this method.

RaiseCommandNotBound(ICommandContext?): Called when a command that has not been bound is invoked.

RaiseHandlingHotKey(ICommandContext?): Called when the View is handling the user pressing the View's HotKeys. Calls OnHandlingHotKey(CommandEventArgs) which can be cancelled; if not cancelled raises Accepting. event. The default HotKey handler calls this method.

RaiseMouseClickEvent(MouseEventArgs): Raises the OnMouseClick(MouseEventArgs)/MouseClick event.

RaiseMouseEvent(MouseEventArgs): Raises the RaiseMouseEvent(MouseEventArgs)/MouseEvent event.

RaiseMouseWheelEvent(MouseEventArgs): Raises the OnMouseWheel(MouseEventArgs)/MouseWheel event.

RaiseSelecting(ICommandContext?): Called when the user has performed an action (e.g. Select) causing the View to change state. Calls OnSelecting(CommandEventArgs) which can be cancelled; if not cancelled raises Accepting. event. The default Select handler calls this method.

Remove(View?): Removes a SubView added via Add(View?) or Add(params View[]?) from this View.

RemoveAll(): Removes all SubViews added via Add(View?) or Add(params View[]?) from this View.

RemoveAll<TView>(): Removes all SubViews of a type added via Add(View?) or Add(params View[]?) from this View.

RenderLineCanvas(): Causes the contents of LineCanvas to be drawn. If SuperViewRendersLineCanvas is true, only the LineCanvas of this view's subviews will be rendered. If SuperViewRendersLineCanvas is false (the default), this method will cause the LineCanvas to be rendered.

ScreenToContent(in Point): Converts a Screen-relative coordinate to a Content-relative coordinate.

ScreenToFrame(in Point): Converts a screen-relative coordinate to a Frame-relative coordinate. Frame-relative means relative to the View's SuperView's Viewport.

ScreenToViewport(in Point): Converts a screen-relative coordinate to a Viewport-relative coordinate.

ScrollHorizontal(int): Scrolls the view horizontally by the specified number of columns.

ScrollVertical(int): Scrolls the view vertically by the specified number of rows.

SetAttribute(Attribute): Selects the specified Attribute as the Attribute to use for subsequent calls to AddRune(Rune) and AddStr(string).

SetAttributeForRole(VisualRole)

Selects the Attribute associated with the specified VisualRole as the Attribute to use for subsequent calls to AddRune(Rune) and AddStr(string).

Calls GetAttributeForRole(VisualRole) to get the Attribute associated with the specified role, which will raise OnGettingAttributeForRole(in VisualRole, ref Attribute)/GettingAttributeForRole.

SetClip(Region?): Sets the Clip to the specified region.

SetClipToScreen(): Sets the Clip to be the rectangle of the screen.

SetContentSize(Size?): Sets the size of the View's content.

SetFocus(): Causes this view to be focused. Calling this method has the same effect as setting HasFocus to true but with the added benefit of returning a value indicating whether the focus was set.

SetNeedsDraw(): Sets that the Viewport of this View needs to be redrawn.

SetNeedsDraw(Rectangle): Expands the area of this view needing to be redrawn to include viewPortRelativeRegion.

SetNeedsLayout(): Sets NeedsLayout to return true, indicating this View and all of it's subviews (including adornments) need to be laid out in the next Application iteration.

SetRelativeLayout(Size): Sets the position and size of this view, relative to the SuperView's ContentSize (nominally the same as this.SuperView.GetContentSize ()) based on the values of X, Y, Width, and Height.

SetScheme(Scheme?): Sets the scheme for the View, marking it as explicitly set.

SetSubViewNeedsDraw(): Sets SubViewNeedsDraw to true for this View and all Superviews.

ToString(): Pretty prints the View

UpdateTextFormatterText(): Can be overridden if the Text has different format than the default.

ViewportToScreen(): Gets the Viewport rectangle with a screen-relative location.

ViewportToScreen(in Point): Converts a Viewport-relative location to a screen-relative location.

ViewportToScreen(in Rectangle): Converts a Viewport-relative location and size to a screen-relative location and size.

Events

Accepting: Cancelable event raised when the user is accepting the state of the View and the Accept has been invoked. Set CommandEventArgs.Handled to true to indicate the event was handled and processing should stop.

AdvancingFocus: Raised when AdvanceFocus(NavigationDirection, TabBehavior?) is about to advance focus.

BorderStyleChanged: Fired when the BorderStyle has changed.

CanFocusChanged: Raised when CanFocus has been changed.

ClearedViewport: Event invoked when the Viewport has been cleared.

ClearingViewport: Event invoked when the Viewport is to be cleared.

CommandNotBound: Cancelable event raised when a command that has not been bound is invoked. Set CommandEventArgs.Handled to true to indicate the event was handled and processing should stop.

ContentSizeChanged: Event raised when the GetContentSize() changes.

Disposing: Riased when the View is being disposed.

DrawComplete: Raised when the View is completed drawing.

DrawingContent: Raised when the View's content is to be drawn.

DrawingSubViews: Raised when the SubViews are to be drawn.

DrawingText: Raised when the Text of the View is to be drawn.

DrewText: Raised when the Text of the View has been drawn.

EnabledChanged: Raised when the Enabled value is being changed.

FocusedChanged: Raised when the focused view has changed.

FrameChanged: Raised when the Frame changes. This event is raised after the Frame has been updated.

GettingAttributeForRole: Raised when the Attribute for a GetAttributeForRole(VisualRole) is being retrieved. Handlers should check if Cancel has been set to true and do nothing if so. If Cancel is false a handler can set it to true to stop further processing optionally change the CurrentValue in the event args to a different value.

GettingScheme: Raised when the Scheme for the View is being retrieved. Handlers can set Handled to true to stop further processing and optionally set Result to a different value.

HandlingHotKey: Cancelable event raised when the View is handling the user pressing the View's HotKey. Set CommandEventArgs.Handled to true to indicate the event was handled and processing should stop.

HasFocusChanged: Raised after HasFocus has changed.

HasFocusChanging: Raised when HasFocus is about to change.

HeightChanged: Raised after the Height property changes, allowing handlers to react to the change.

HeightChanging: Raised before the Height property changes, allowing handlers to modify or cancel the change.

HotKeyChanged: Raised when the HotKey is changed.

Initialized: Raised once when the View is being initialized for the first time. Allows configurations and assignments to be performed before the View being shown. View implements ISupportInitializeNotification to allow for more sophisticated initialization.

KeyDown: Raised when the user presses a key, allowing subscribers to pre-process the key down event. Called before key bindings are invoked and KeyDownNotHandled is raised. Set Handled to true to stop the key from being processed further.

KeyDownNotHandled: Raised when the user has pressed key it wasn't handled by KeyDown and was not bound to a key binding.

KeyUp

Raised when a key is released. Set Handled to true to stop the key up event from being processed by other views. Not all terminals support key distinct down/up notifications, Applications should avoid depending on distinct KeyDown and KeyUp events and instead should use KeyDown.