Class
StandardMaskTextBoxProvider

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

cs-api-definition
public class StandardMaskTextBoxProvider : IMaskProvider

Inheritance: objectStandardMaskTextBoxProvider

Derived Classes: IPMaskTextBoxProvider

Implements: IMaskProvider

Constructors

StandardMaskTextBoxProvider(string, CultureInfo, RadMaskedEditBoxElement, bool, char, char, bool)

Initializes a new instance of the StandardMaskTextBoxProvider

Declaration

cs-api-definition
public StandardMaskTextBoxProvider(string mask, CultureInfo culture, RadMaskedEditBoxElement owner, bool allowPromptAsInput, char promptChar, char passwordChar, bool restrictToAscii)

Parameters

mask

string

The mask.

culture

CultureInfo

The culture.

owner

RadMaskedEditBoxElement

The owner.

allowPromptAsInput

bool

A value indicating whether the prompt char is allowed as input.

promptChar

char

The prompt character.

passwordChar

char

The password character.

restrictToAscii

bool

A value indicating whether to restrict the input to ASCII

Fields

owner

Declaration

cs-api-definition
protected RadMaskedEditBoxElement owner

Field Value

RadMaskedEditBoxElement

provider

Declaration

cs-api-definition
protected StandardCharacterMaskEditBoxProvider provider

Field Value

StandardCharacterMaskEditBoxProvider

Properties

Culture

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

Declaration

cs-api-definition
public CultureInfo Culture { get; }

Property Value

CultureInfo

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

Implements IMaskProvider.Culture

IncludePrompt

Gets or sets a value indicating whether PromptChar is used to represent the absence of user input when displaying the formatted string.

Declaration

cs-api-definition
public bool IncludePrompt { get; set; }

Property Value

bool

Implements IMaskProvider.IncludePrompt

Mask

Gets the input mask.

Declaration

cs-api-definition
public string Mask { get; }

Property Value

string

A string containing the full mask.

Implements IMaskProvider.Mask

MaskCompleted

Gets a value indicating whether all required inputs have been entered into the formatted string.

Declaration

cs-api-definition
[Browsable(false)]
public bool MaskCompleted { get; }

Property Value

bool

true if all required input has been entered into the mask; otherwise, false.

MaskFull

Gets a value indicating whether all required and optional inputs have been entered into the formatted string.

Declaration

cs-api-definition
[Browsable(false)]
public bool MaskFull { get; }

Property Value

bool

true if all required and optional inputs have been entered; otherwise, false.

PromptChar

Gets or sets the character used to represent the absence of user input.

Declaration

cs-api-definition
public char PromptChar { get; set; }

Property Value

char

The character used to prompt the user for input..

Implements IMaskProvider.PromptChar

ResetOnPrompt

Gets or sets a value that determines how an input character that matches the prompt character should be handled.

Declaration

cs-api-definition
[Browsable(false)]
public bool ResetOnPrompt { get; set; }

Property Value

bool

true if the prompt character entered as input causes the current editable position in the mask to be reset; otherwise, false to indicate that the prompt character is to be processed as a normal input character. The default is true.

ResetOnSpace

Gets or sets a value that determines how a space input character should be handled.

Declaration

cs-api-definition
[Browsable(false)]
public bool ResetOnSpace { get; set; }

Property Value

bool

true if the space input character causes the current editable position in the mask to be reset; otherwise, false to indicate that it is to be processed as a normal input character. The default is true.

TextBoxItem

Gets the text box item.

Declaration

cs-api-definition
public RadTextBoxItem TextBoxItem { get; }

Property Value

RadTextBoxItem

Implements IMaskProvider.TextBoxItem

Value

Gets or sets the value.

Declaration

cs-api-definition
public virtual object Value { get; set; }

Property Value

object

Implements IMaskProvider.Value

Methods

Clone()

Clones this instance.

Declaration

cs-api-definition
public IMaskProvider Clone()

Returns

IMaskProvider

The cloned instance.

Implements IMaskProvider.Clone()

Delete()

Raises a delete operation over the selected text.

Declaration

cs-api-definition
public bool Delete()

Returns

bool

Implements IMaskProvider.Delete()

KeyDown(object, KeyEventArgs)

Occurs when a key is pressed.

Declaration

cs-api-definition
public virtual void KeyDown(object sender, KeyEventArgs e)

Parameters

sender

object

The sender.

e

KeyEventArgs

Key event arguments.

Implements IMaskProvider.KeyDown(object, KeyEventArgs)

KeyPress(object, KeyPressEventArgs)

Occurs when a key is pressed.

Declaration

cs-api-definition
public virtual void KeyPress(object sender, KeyPressEventArgs e)

Parameters

sender

object

The sender.

e

KeyPressEventArgs

Key event arguments.

Implements IMaskProvider.KeyPress(object, KeyPressEventArgs)

Set(string, out int, out MaskedTextResultHint)

Sets the specified string within the formatted string, returning the status of the operation.

Declaration

cs-api-definition
public bool Set(string input, out int testPosition, out MaskedTextResultHint resultHint)

Parameters

input

string

The string value that replaces the existing value.

testPosition

int

Not used.

resultHint

MaskedTextResultHint

A System.ComponentModel.MaskedTextResultHint that succinctly describes the result of the replacement operation. An output parameter.

Returns

bool

true if the operation is successful, false if not.

ToString(bool, bool)

Returns the formatted string, optionally including prompt and literal characters.

Declaration

cs-api-definition
public string ToString(bool includePrompt, bool includeLiterals)

Parameters

includePrompt

bool

true to include prompt characters in the return string; otherwise, false.

includeLiterals

bool

true to include literal characters in the return string; otherwise, false.

Returns

string

The formatted System.String that includes all the assigned character values and optionally includes literals and prompts.

Implements IMaskProvider.ToString(bool, bool)

TryGetStandardProvider()

Declaration

cs-api-definition
public virtual StandardCharacterMaskEditBoxProvider TryGetStandardProvider()

Returns

StandardCharacterMaskEditBoxProvider

Validate(string)

Validates the given string value.

Declaration

cs-api-definition
public virtual bool Validate(string value)

Parameters

value

string

The value.

Returns

bool

true if the new value was applied, otherwise false.

Implements IMaskProvider.Validate(string)