TextBoxBase

Wisej.Web.TextBoxBase

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

Implements the basic functionality required by text controls.

public class TextBoxBase : Control, IModified, ILabel, IReadOnly, IValidation

Constructors

TextBoxBase()

Initializes an instance of a TextBoxBase derived control.

Properties

AcceptsTab

Boolean: Returns or sets whether pressing the TAB key in a multiline text box control types a TAB character in the control instead of moving the focus to the next control in the tab order. (Default: False)

The Multiline property must be true to get a TAB character in the control.

AutoComplete

AutoComplete: Returns of sets whether the browser can auto complete the field with values previously entered by the user. (Default: Default)

AutoCompleteList

String[]: Identifies a list of pre-defined options to suggest to the user. (Default: null)

AutoSize

Boolean: Returns or sets whether the height of the control is set automatically. (Default: True)

BorderStyle

BorderStyle: Returns or sets the border type of the text box control. (Default: Solid)

CanUndo

Boolean: Returns a value indicating whether the user can undo the previous operation in a text box control.

DefaultSize

Size: Returns the default size for a text box control.

EnableNativeContextMenu

Boolean: Enables or disables the browser's context menu. (Default: True)

Invalid

Boolean: Returns or sets a value that indicates that the control is invalid.

InvalidMessage

String: Returns or sets the invalid message that is shown in the invalid tooltip. (Default: "")

Label

LabelWrapper: Provides a label related to the control.

LabelText

String: Returns or sets the localizable label associated with this control. (Default: "")

Lines

String[]: Returns or sets the lines of text in a text box control.

MaxLength

Int32: Returns or sets the maximum number of characters the user can type or paste into the text box control. (Default: 0)

Throws:

Modified

Boolean: Returns or sets a value that indicates that the text box control has been modified by the user since the control was created or its contents were last set.

Multiline

Boolean: Returns or sets whether this is a multiline text box control. (Default: False)

Throws:

  • ArgumentException The property cannot be modified after the component has been created.

ReadOnly

Boolean: Returns or sets whether the text box control is read-only. (Default: False)

SelectedText

String: Returns or sets a value indicating the currently selected text in the control.

SelectionLength

Int32: Returns or sets the number of characters selected in the text box.

Throws:

SelectionStart

Int32: Returns or sets the starting point of text selected in the text box.

Throws:

SelectOnEnter

Boolean: Selects the text when gaining the focus. (Default: False)

Text

String: Returns or sets the current text in the text box. (Default: "")

TextLength

Int32: Returns the length of text in the control.

Tools

ComponentToolCollection: Returns the instance of ComponentToolCollection associated with this control.

Watermark

String: Returns or sets the text to show when the textbox is empty. (Default: null)

WordWrap

Boolean: Indicates whether a multiline text box control automatically wraps words to the beginning of the next line when necessary. (Default: True)

Methods

AppendText(text)

Appends text to the current text of a text box.

Parameter
Type
Description

text

The text to append to the current contents of the text box.

Clear()

Clears all text from the text box control.

Copy()

Copies the current selection in the text box to the Clipboard.

Cut()

Moves the current selection in the text box to the Clipboard.

DeselectAll()

Specifies that the value of the SelectionLength property is zero so that no characters are selected in the control.

Dispose(disposing)

Dispose the control.

Parameter
Type
Description

disposing

true when this method is called by the application rather than a finalizer.

OnAcceptsTabChanged(e)

Fires the AcceptsTabChanged event.

Parameter
Type
Description

e

A EventArgs that contains the event data.

OnModifiedChanged(e)

Fires the ModifiedChanged event.

Parameter
Type
Description

e

A EventArgs that contains the event data.

OnMultilineChanged(e)

Fires the MultilineChanged event.

Parameter
Type
Description

e

A EventArgs that contains the event data.

OnReadOnlyChanged(e)

Fires the ReadOnlyChanged event.

Parameter
Type
Description

e

An EventArgs that contains the event data.

OnToolClick(e)

Fires the ToolClick event.

Parameter
Type
Description

e

A ToolClickEventArgs that contains the event data.

OnValidating(e)

Fires the Validating event.

Parameter
Type
Description

e

A EventArgs that contains the event data.

OnWebEvent(e)

Processes the event from the client.

Parameter
Type
Description

e

Event arguments.

OnWebRender(config)

Renders the client component.

Parameter
Type
Description

config

Dynamic configuration object.

OnWebUpdate(state)

Updates the client component using the state information.

Parameter
Type
Description

state

Dynamic state object.

Paste()

Replaces the current selection in the text box with the contents of the Clipboard.

ScrollToX(x)

Scrolls to the given left position.

Parameter
Type
Description

x

The horizontal scroll position.

ScrollToY(y)

Scrolls to the given top position.

Parameter
Type
Description

y

The vertical scroll position.

Select(start, length)

Selects a range of text in the text box.

Parameter
Type
Description

start

The position of the first character in the current text selection within the text box.

length

The number of characters to select.

Throws:

SelectAll()

Selects all text in the text box.

SetBoundsCore(x, y, width, height, specified)

Sets the specified bounds of the ComboBox control.

Parameter
Type
Description

x

The new Left property value of the control.

y

The new Top property value of the control.

width

The new Width property value of the control.

height

Not used.

specified

A combination of the BoundsSpecified values.

Events

AcceptsTabChanged

EventHandler Fired when the value of the AcceptsTab property has changed.

ModifiedChanged

EventHandler Fired when the value of the Modified property has changed.

MultilineChanged

EventHandler Fired when the value of the Multiline property has changed.

ReadOnlyChanged

EventHandler Fired when the value of the ReadOnly property has changed.

ToolClick

ToolClickEventHandler Fired when a ComponentTool is clicked.

Inherited By

Name
Description

Uses a mask to distinguish between proper and improper user input.

Represents a text box control that allows the user to enter any value.

Represents a TextBox control that can be hosted in a DataGridViewTextBoxCell cell when the cell's WrapMode is set to False.

Represents a data field that displays a list of selectable and removable tags. The control recognizes tags as the user types and adds in front of the editable field.

Represents a text box control that allows the user to enter a typed value.

Implements

Name
Description

Provides access to the UserData and Tag properties associated to the component implementing this interface.

Bindable components implement this interface.

Controls that support drag & drop operations implement this interface.

Provides access to the LabelWrapper associated with the controls that implement this interface.

Provides access to the ReadOnly property for coontrols that support the read-only mode.

Provides access to the Modified property and ModifiedChanged event for controls that implement this interface.

Provides access to the validation events and properties property for controls that support validation.

All wisej components implement this interface.

All wisej controls derived from the Control class must implement this interface.

Allows an object to serialize itself.

Last updated

Was this helpful?