Class RadMaskedEditBox

Uses a mask to distinguish between proper and improper user input

Inheritance
System.Object
RadControl
RadEditorControl
RadMaskedEditBox
Inherited Members
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

[TelerikToolboxCategory("Editors")]
public class RadMaskedEditBox : RadEditorControl, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IPCHost, IAnalyticsProvider

Constructors

RadMaskedEditBox()

Declaration
public RadMaskedEditBox()

Properties

AcceptsReturn

Gets or sets a value indicating whether pressing ENTER in a multiline RadTextBox control creates a new line of text in the control or activates the default button for the form.

Declaration
[RadDefaultValue("AcceptsReturn", typeof(RadTextBoxItem))]
public bool AcceptsReturn { get; set; }
Property Value
System.Boolean

AcceptsTab

Gets or sets a value indicating 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.

Declaration
[RadDefaultValue("AcceptsTab", typeof(RadTextBoxItem))]
public bool AcceptsTab { get; set; }
Property Value
System.Boolean

AllowPromptAsInput

Declaration
public bool AllowPromptAsInput { get; set; }
Property Value
System.Boolean

AutoCompleteCustomSource

Declaration
[RadDefaultValue("AutoCompleteCustomSource", typeof(HostedTextBoxBase))]
public AutoCompleteStringCollection AutoCompleteCustomSource { get; set; }
Property Value
System.Windows.Forms.AutoCompleteStringCollection

AutoCompleteMode

Declaration
[RadDefaultValue("AutoCompleteMode", typeof(HostedTextBoxBase))]
public AutoCompleteMode AutoCompleteMode { get; set; }
Property Value
System.Windows.Forms.AutoCompleteMode

AutoCompleteSource

Declaration
[RadDefaultValue("AutoCompleteSource", typeof(HostedTextBoxBase))]
public AutoCompleteSource AutoCompleteSource { get; set; }
Property Value
System.Windows.Forms.AutoCompleteSource

AutoSize

Gets or sets whether the edit control is auto-sized

Declaration
public override bool AutoSize { get; set; }
Property Value
System.Boolean

Overrides

CharacterCasing

Gets or sets a value indicating whether the RadTextBox control modifies the case of characters as they are typed.

Declaration
public CharacterCasing CharacterCasing { get; set; }
Property Value
System.Windows.Forms.CharacterCasing

Culture

Gets the culture that determines the value of the localizable separators and placeholders in the input mask.

Declaration
public CultureInfo Culture { get; set; }
Property Value
System.Globalization.CultureInfo

A System.Globalization.CultureInfo containing the culture information associated with the input mask.

DefaultSize

Declaration
protected override Size DefaultSize { get; }
Property Value
System.Drawing.Size

EnableNullValueInput

Gets or set a value indicating whether end users can set the value to NULL. This can be achieved by pressing Ctrl + Del or Ctrl + 0 key combinations.

Declaration
public virtual bool EnableNullValueInput { get; set; }
Property Value
System.Boolean

HideSelection

Gets or sets a value indicating whether the selected text remains highlighted even when the RadTextBox has lost the focus.

Declaration
public bool HideSelection { get; set; }
Property Value
System.Boolean

Lines

Gets or sets the lines of text in multiline configurations.

Declaration
public string[] Lines { get; set; }
Property Value
System.String[]

Mask

Gets or sets a mask expression.

Declaration
public string Mask { get; set; }
Property Value
System.String

MaskedEditBoxElement

Declaration
public virtual RadMaskedEditBoxElement MaskedEditBoxElement { get; set; }
Property Value
RadMaskedEditBoxElement

MaskType

Gets or sets the mask type.

Declaration
public MaskType MaskType { get; set; }
Property Value
MaskType

Modified

Gets or sets a value indicating whether the RadTextBox control has been modified by the user since the control was created or since its contents were last set.

Declaration
public bool Modified { get; set; }
Property Value
System.Boolean

Multiline

Gets or sets a value indicating whether this is a multiline TextBox control.

Declaration
[RadDefaultValue("Multiline", typeof(RadTextBoxItem))]
public bool Multiline { get; set; }
Property Value
System.Boolean

Name

Declaration
public string Name { get; set; }
Property Value
System.String

NullText

Gets or sets the text that is displayed when the ComboBox contains a null reference.

Declaration
[RadDefaultValue("NullText", typeof(RadTextBoxItem))]
public string NullText { get; set; }
Property Value
System.String

PasswordChar

Gets or sets the character used to mask characters of a password in a single-line TextBox control.

Declaration
[RadDefaultValue("PasswordChar", typeof(RadTextBoxItem))]
public char PasswordChar { get; set; }
Property Value
System.Char

PromptChar

Declaration
public char PromptChar { get; set; }
Property Value
System.Char

ReadOnly

Gets or sets a value indicating whether the contents of the TextBox control can be changed.

Declaration
public bool ReadOnly { get; set; }
Property Value
System.Boolean

ScrollBars

Gets or sets which scroll bars should appear in a multiline TextBox control.

Declaration
public ScrollBars ScrollBars { get; set; }
Property Value
System.Windows.Forms.ScrollBars

SelectedText

Gets or sets a value indicating the currently selected text in the control.

Declaration
public string SelectedText { get; set; }
Property Value
System.String

SelectionLength

Gets or sets the number of characters selected in the text box.

Declaration
public int SelectionLength { get; set; }
Property Value
System.Int32

SelectionStart

Gets or sets the starting point of text selected in the text box.

Declaration
public int SelectionStart { get; set; }
Property Value
System.Int32

ShortcutsEnabled

Gets or sets a value indicating whether the defined shortcuts are enabled.

Declaration
public bool ShortcutsEnabled { get; set; }
Property Value
System.Boolean

Text

Declaration
public override string Text { get; set; }
Property Value
System.String

Overrides

TextAlign

Gets or sets the horizontal alignment of the text.

Declaration
public HorizontalAlignment TextAlign { get; set; }
Property Value
System.Windows.Forms.HorizontalAlignment

TextMaskFormat

Gets or sets a value that determines whether literals and prompt characters are included in the formatted string.

Declaration
public MaskFormat TextMaskFormat { get; set; }
Property Value
System.Windows.Forms.MaskFormat

One of the System.Windows.Forms.MaskFormat values. The default is System.Windows.Forms.MaskFormat.IncludeLiterals.
Exceptions
System.ComponentModel.InvalidEnumArgumentException

Property set with a System.Windows.Forms.MaskFormat value that is not valid.

UseGenericBorderPaint

Gets or sets a value indicating whether to show the bottom part of characters, clipped due to font name or size particularities

Declaration
[RadDescription("UseGenericBorderPaint", typeof(RadTextBoxElement))]
[RadDefaultValue("UseGenericBorderPaint", typeof(RadTextBoxElement))]
public bool UseGenericBorderPaint { get; set; }
Property Value
System.Boolean

Value

Gets or sets the value associated to the mask edit box

Declaration
public object Value { get; set; }
Property Value
System.Object

Methods

Clear()

Clears all text from the text box control and Value.

Declaration
public void Clear()

ClearUndo()

Clears information about the most recent operation from the undo buffer of the text box.

Declaration
public void ClearUndo()

CreateAccessibilityInstance()

Declaration
protected override AccessibleObject CreateAccessibilityInstance()
Returns
System.Windows.Forms.AccessibleObject

CreateChildItems(RadElement)

Declaration
protected override void CreateChildItems(RadElement parent)
Parameters
RadElement parent

Overrides

CreateElement()

Declaration
protected virtual RadMaskedEditBoxElement CreateElement()
Returns
RadMaskedEditBoxElement

Dispose(Boolean)

Declaration
protected override void Dispose(bool disposing)
Parameters
System.Boolean disposing

Overrides

Focus()

Declaration
public void Focus()

OnKeyDown(Object, KeyEventArgs)

Declaration
public virtual void OnKeyDown(object sender, KeyEventArgs e)
Parameters
System.Object sender

System.Windows.Forms.KeyEventArgs e

OnKeyPress(Object, KeyPressEventArgs)

Declaration
public virtual void OnKeyPress(object sender, KeyPressEventArgs e)
Parameters
System.Object sender

System.Windows.Forms.KeyPressEventArgs e

OnKeyUp(Object, KeyEventArgs)

Declaration
public virtual void OnKeyUp(object sender, KeyEventArgs e)
Parameters
System.Object sender

System.Windows.Forms.KeyEventArgs e

OnMultilineChanged(Object, EventArgs)

Declaration
public virtual void OnMultilineChanged(object sender, EventArgs e)
Parameters
System.Object sender

System.EventArgs e

OnTextAlignChanged(Object, EventArgs)

Declaration
public virtual void OnTextAlignChanged(object sender, EventArgs e)
Parameters
System.Object sender

System.EventArgs e

OnValueChanged(Object, EventArgs)

Declaration
protected virtual void OnValueChanged(object sender, EventArgs e)
Parameters
System.Object sender

System.EventArgs e

OnValueChanging(Object, CancelEventArgs)

Fires the ValueChanging event

Declaration
protected virtual void OnValueChanging(object sender, CancelEventArgs e)
Parameters
System.Object sender

System.ComponentModel.CancelEventArgs e

ProcessAutoSizeChanged(Boolean)

Declaration
protected override void ProcessAutoSizeChanged(bool value)
Parameters
System.Boolean value

Overrides

ResetBackColorThemeOverrides()

Declaration
protected override void ResetBackColorThemeOverrides()
Overrides

ResetForeColorThemeOverrides()

Declaration
protected override void ResetForeColorThemeOverrides()
Overrides

Select()

Declaration
public void Select()

SelectAll()

Selects all text in the control.

Declaration
public void SelectAll()

SetBackColorThemeOverrides()

Declaration
protected override void SetBackColorThemeOverrides()
Overrides

SetForeColorThemeOverrides()

Declaration
protected override void SetForeColorThemeOverrides()
Overrides

UnwireEvents()

Declaration
protected void UnwireEvents()

WireEvents()

Declaration
protected void WireEvents()

WndProc(ref Message)

Declaration
protected override void WndProc(ref Message m)
Parameters
System.Windows.Forms.Message m

Overrides

Events

Click

Occurs when the element is clicked.

Declaration
public event EventHandler Click
Event Type
System.EventHandler

KeyDown

Occurs when the RadItem has focus and the user pressees a key down

Declaration
public event KeyEventHandler KeyDown
Event Type
System.Windows.Forms.KeyEventHandler

KeyPress

Occurs when the RadItem has focus and the user pressees a key

Declaration
public event KeyPressEventHandler KeyPress
Event Type
System.Windows.Forms.KeyPressEventHandler

KeyUp

Occurs when the RadItem has focus and the user releases the pressed key up

Declaration
public event KeyEventHandler KeyUp
Event Type
System.Windows.Forms.KeyEventHandler

MultilineChanged

Occurs when the value of the Multiline property has changed.

Declaration
public event EventHandler MultilineChanged
Event Type
System.EventHandler

TextAlignChanged

Occurs when the value of the TextAlign property has changed.

Declaration
public event EventHandler TextAlignChanged
Event Type
System.EventHandler

ValueChanged

Occurs when the editing value has been changed

Declaration
public event EventHandler ValueChanged
Event Type
System.EventHandler

ValueChanging

Occurs when the editing value is changing.

Declaration
public event CancelEventHandler ValueChanging
Event Type
System.ComponentModel.CancelEventHandler

Extension Methods