Class TextField

Single-line text entry View
Inheritance
object
Responder
View
TextField
DateField
TimeField
Implements
Inherited Members
Namespace: Terminal.Gui
Assembly: Terminal.Gui.dll
Syntax
public class TextField : View, IDisposable, ISupportInitializeNotification, ISupportInitialize
Remarks
The TextField View provides editing functionality and mouse support.

Constructors

| Edit this page View Source

TextField()

Initializes a new instance of the TextField class using Computed positioning.
Declaration
public TextField()
| Edit this page View Source

TextField(ustring)

Initializes a new instance of the TextField class using Computed positioning.
Declaration
public TextField(ustring text)
Parameters
Type Name Description
ustring text Initial text contents.
| Edit this page View Source

TextField(int, int, int, ustring)

Initializes a new instance of the TextField class using Absolute positioning.
Declaration
public TextField(int x, int y, int w, ustring text)
Parameters
Type Name Description
int x The x coordinate.
int y The y coordinate.
int w The width.
ustring text Initial text contents.
| Edit this page View Source

TextField(string)

Initializes a new instance of the TextField class using Computed positioning.
Declaration
public TextField(string text)
Parameters
Type Name Description
string text Initial text contents.

Properties

| Edit this page View Source

Autocomplete

Provides autocomplete context menu based on suggestions at the current cursor position. Populate AllSuggestions to enable this feature.
Declaration
public IAutocomplete Autocomplete { get; protected set; }
Property Value
Type Description
IAutocomplete
| Edit this page View Source

CanFocus

Gets or sets a value indicating whether this Responder can focus.
Declaration
public override bool CanFocus { get; set; }
Property Value
Type Description
bool true if can focus; otherwise, false.
Overrides
| Edit this page View Source

ContextMenu

Get the ContextMenu for this view.
Declaration
public ContextMenu ContextMenu { get; }
Property Value
Type Description
ContextMenu
| Edit this page View Source

CursorPosition

Sets or gets the current cursor position.
Declaration
public virtual int CursorPosition { get; set; }
Property Value
Type Description
int
| Edit this page View Source

DesiredCursorVisibility

Get / Set the wished cursor when the field is focused
Declaration
public CursorVisibility DesiredCursorVisibility { get; set; }
Property Value
Type Description
CursorVisibility
| Edit this page View Source

Frame

Gets or sets the frame for the view. The frame is relative to the view's container (SuperView).
Declaration
public override Rect Frame { get; set; }
Property Value
Type Description
Rect The frame.
Overrides
Remarks

Change the Frame when using the Absolute layout style to move or resize views.

Altering the Frame of a view will trigger the redrawing of the view as well as the redrawing of the affected regions of the SuperView.

| Edit this page View Source

HasHistoryChanges

Indicates whatever the text has history changes or not. true if the text has history changes false otherwise.
Declaration
public bool HasHistoryChanges { get; }
Property Value
Type Description
bool
| Edit this page View Source

IsDirty

Indicates whatever the text was changed or not. true if the text was changed false otherwise.
Declaration
public bool IsDirty { get; }
Property Value
Type Description
bool
| Edit this page View Source

ReadOnly

If set to true its not allow any changes in the text.
Declaration
public bool ReadOnly { get; set; }
Property Value
Type Description
bool
| Edit this page View Source

ScrollOffset

Gets the left offset position.
Declaration
public int ScrollOffset { get; }
Property Value
Type Description
int
| Edit this page View Source

Secret

Sets the secret property.
Declaration
public bool Secret { get; set; }
Property Value
Type Description
bool
Remarks
This makes the text entry suitable for entering passwords.
| Edit this page View Source

SelectedLength

Length of the selected text.
Declaration
public int SelectedLength { get; }
Property Value
Type Description
int
| Edit this page View Source

SelectedStart

Start position of the selected text.
Declaration
public int SelectedStart { get; set; }
Property Value
Type Description
int
| Edit this page View Source

SelectedText

The selected text.
Declaration
public ustring SelectedText { get; }
Property Value
Type Description
ustring
| Edit this page View Source

Text

Sets or gets the text held by the view.
Declaration
public ustring Text { get; set; }
Property Value
Type Description
ustring
| Edit this page View Source

Used

Tracks whether the text field should be considered "used", that is, that the user has moved in the entry, so new input should be appended at the cursor position, rather than clearing the entry
Declaration
public bool Used { get; set; }
Property Value
Type Description
bool

Methods

| Edit this page View Source

ClearAllSelection()

Clear the selected text.
Declaration
public void ClearAllSelection()
| Edit this page View Source

ClearHistoryChanges()

Allows clearing the HistoryText.HistoryTextItem items updating the original text.
Declaration
public void ClearHistoryChanges()
| Edit this page View Source

Copy()

Copy the selected text to the clipboard.
Declaration
public virtual void Copy()
| Edit this page View Source

Cut()

Cut the selected text to the clipboard.
Declaration
public virtual void Cut()
| Edit this page View Source

DeleteAll()

Deletes all text.
Declaration
public void DeleteAll()
| Edit this page View Source

DeleteCharLeft(bool)

Deletes the left character.
Declaration
public virtual void DeleteCharLeft(bool useOldCursorPos = true)
Parameters
Type Name Description
bool useOldCursorPos
| Edit this page View Source

DeleteCharRight()

Deletes the right character.
Declaration
public virtual void DeleteCharRight()
| Edit this page View Source

GetNormalColor()

Determines the current ColorScheme based on the Enabled value.
Declaration
public override Attribute GetNormalColor()
Returns
Type Description
Attribute Normal if Enabled is true or Disabled if Enabled is false. If it's overridden can return other values.
Overrides
| Edit this page View Source

InsertText(string, bool)

Inserts the given toAdd text at the current cursor position exactly as if the user had just typed it
Declaration
public void InsertText(string toAdd, bool useOldCursorPos = true)
Parameters
Type Name Description
string toAdd Text to add
bool useOldCursorPos If uses the oldCursorPos.
| Edit this page View Source

KillWordBackwards()

Deletes word backwards.
Declaration
public virtual void KillWordBackwards()
| Edit this page View Source

KillWordForwards()

Deletes word forwards.
Declaration
public virtual void KillWordForwards()
| Edit this page View Source

MouseEvent(MouseEvent)

Method invoked when a mouse event is generated
Declaration
public override bool MouseEvent(MouseEvent ev)
Parameters
Type Name Description
MouseEvent ev
Returns
Type Description
bool true, if the event was handled, false otherwise.
Overrides
| Edit this page View Source

OnEnter(View)

Method invoked when a view gets focus.
Declaration
public override bool OnEnter(View view)
Parameters
Type Name Description
View view The view that is losing focus.
Returns
Type Description
bool true, if the event was handled, false otherwise.
Overrides
| Edit this page View Source

OnLeave(View)

Method invoked when a view loses focus.
Declaration
public override bool OnLeave(View view)
Parameters
Type Name Description
View view The view that is getting focus.
Returns
Type Description
bool true, if the event was handled, false otherwise.
Overrides
| Edit this page View Source

OnTextChanging(ustring)

Virtual method that invoke the TextChanging event if it's defined.
Declaration
public virtual TextChangingEventArgs OnTextChanging(ustring newText)
Parameters
Type Name Description
ustring newText The new text to be replaced.
Returns
Type Description
TextChangingEventArgs Returns the TextChangingEventArgs
| Edit this page View Source

Paste()

Paste the selected text from the clipboard.
Declaration
public virtual void Paste()
| Edit this page View Source

PositionCursor()

Sets the cursor position.
Declaration
public override void PositionCursor()
Overrides
| Edit this page View Source

ProcessKey(KeyEvent)

Processes key presses for the TextField.
Declaration
public override bool ProcessKey(KeyEvent kb)
Parameters
Type Name Description
KeyEvent kb
Returns
Type Description
bool
Overrides
Remarks
The TextField control responds to the following keys:
KeysFunction
Delete, BackspaceDeletes the character before cursor.
| Edit this page View Source

Redraw(Rect)

Redraws this view and its subviews; only redraws the views that have been flagged for a re-display.
Declaration
public override void Redraw(Rect bounds)
Parameters
Type Name Description
Rect bounds The bounds (view-relative region) to redraw.
Overrides
Remarks

Always use Bounds (view-relative) when calling Redraw(Rect), NOT Frame (superview-relative).

Views should set the color that they want to use on entry, as otherwise this will inherit the last color that was set globally on the driver.

Overrides of Redraw(Rect) must ensure they do not set Driver.Clip to a clip region larger than the parameter, as this will cause the driver to clip the entire region.

| Edit this page View Source

SelectAll()

Selects all text.
Declaration
public void SelectAll()

Events

| Edit this page View Source

TextChanged

Changed event, raised when the text has changed.
Declaration
public event Action<ustring> TextChanged
Event Type
Type Description
Action<ustring>
Remarks
This event is raised when the Text changes.
| Edit this page View Source

TextChanging

Changing event, raised before the Text changes and can be canceled or changing the new text.
Declaration
public event Action<TextChangingEventArgs> TextChanging
Event Type
Type Description
Action<TextChangingEventArgs>

Implements