Class RadTextBoxElement

Represents a text box element. The RadTextBox class is a simple wrapper for the RadTextBoxElement class. All UI and logic functionality is implemented in the RadTextBoxElement class. RadTextBox class acts to transfer events to and from its corresponding RadTextBoxElement instance. The RadTextBoxElement may be nested in other telerik controls.

Inheritance
System.Object
DisposableObject
RadObject
RadElement
VisualElement
RadComponentElement
RadItem
RadEditorElement
RadTextBoxElement
BaseTextBoxEditorElement
ChatInputTextBoxElement
GridSearchCellTextBoxElement
PropertyGridUITypeEditorElement
RadBrowseEditorElement
RadButtonTextBoxElement
RadCalculatorEditorContentElement
RadColorBoxElement
RadDropDownTextBoxElement
RadMaskedEditBoxElement
RadTextBoxEditorElement
RadToolbarFormTextBoxElement
SchedulerNavigatorSearchTextbox
ToolbarTextBoxElement
CellEditorTextBox
Inherited Members
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

[ComVisible(false)]
public class RadTextBoxElement : RadEditorElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IComponent, IDisposable, IBindableComponent, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode

Constructors

RadTextBoxElement()

Initializes a new instance of the RadTextBoxElement class.

Declaration
public RadTextBoxElement()

RadTextBoxElement(RadTextBoxItem)

Initializes a new instance of RadTextBoxElemenet

Declaration
public RadTextBoxElement(RadTextBoxItem textBoxItem)
Parameters
RadTextBoxItem textBoxItem

Fields

NullTextColorProperty

Declaration
public static RadProperty NullTextColorProperty
Field Value
RadProperty

Properties

Border

Gets an instance of the corresponding border primitive.

Declaration
public BorderPrimitive Border { get; }
Property Value
BorderPrimitive

ButtonsStack

Gets an instance of the corresponding StackLayoutPanel that holds the clear button.

Declaration
public StackLayoutPanel ButtonsStack { get; }
Property Value
StackLayoutPanel

ClearButton

Gets an instance of the corresponding clear button.

Declaration
public LightVisualButtonElement ClearButton { get; }
Property Value
LightVisualButtonElement

EmbeddedLabel

Gets an instance of the corresponding embedded label.

Declaration
public LightVisualElement EmbeddedLabel { get; }
Property Value
LightVisualElement

EmbeddedLabelAnimationSpeed

Gets or set the animation speed of the embedded label. The speed is an integer between 1(off) and 10(slowest) with default value of 8.

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

EmbeddedLabelBorderOffset

Gets or set the offset of the embedded label from the bottom border, when the label is down.

Declaration
public float EmbeddedLabelBorderOffset { get; set; }
Property Value
System.Single

EmbeddedLabelText

Gets or sets the text of the embedded label.

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

Fill

Gets an instance of the corresponding fill primitive.

Declaration
public FillPrimitive Fill { get; }
Property Value
FillPrimitive

NullTextColor

Gets or sets the color of prompt text that is displayed when the TextBox contains no text.

Declaration
public Color NullTextColor { get; set; }
Property Value
System.Drawing.Color

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

RepositionEmbeddedLabel

Gets or set whether to reposition the embedded label, when text box is empty.

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

ShowBorder

Gets or sets a value indicating whether the border is shown.

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

ShowClearButton

Gets or sets a value indicating whether the clear button is shown.

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

ShowEmbeddedLabel

Gets or sets the visibility of the embedded label.

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

TextAlign

Gets or set the text align of the TextBoxItem.

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

TextBoxItem

Gets an instance of the corresponding RadTextBoxItem.

Declaration
public RadTextBoxItem TextBoxItem { get; }
Property Value
RadTextBoxItem

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(RadTextBoxItem))]
[RadDefaultValue("UseGenericBorderPaint", typeof(RadTextBoxItem))]
public bool UseGenericBorderPaint { get; set; }
Property Value
System.Boolean

Methods

ArrangeOverride(SizeF)

Declaration
protected override SizeF ArrangeOverride(SizeF finalSize)
Parameters
System.Drawing.SizeF finalSize

Returns
System.Drawing.SizeF

Overrides

CallTextChanged(EventArgs)

Raises the TextChanged event.

Declaration
protected virtual void CallTextChanged(EventArgs e)
Parameters
System.EventArgs e

CallTextChanging(TextChangingEventArgs)

Raises the TextChanging event.

Declaration
protected virtual void CallTextChanging(TextChangingEventArgs e)
Parameters
TextChangingEventArgs e

CreateChildElements()

Declaration
protected override void CreateChildElements()
Overrides

CreateClearButton()

Declaration
protected virtual LightVisualButtonElement CreateClearButton()
Returns
LightVisualButtonElement

CreateEmbeddedLabel()

Declaration
protected virtual LightVisualElement CreateEmbeddedLabel()
Returns
LightVisualElement

DisposeManagedResources()

Declaration
protected override void DisposeManagedResources()
Overrides

Focus()

Declaration
public override bool Focus()
Returns
System.Boolean

Overrides

InitializeFields()

Declaration
protected override void InitializeFields()
Overrides

MeasureOverride(SizeF)

Declaration
protected override SizeF MeasureOverride(SizeF availableSize)
Parameters
System.Drawing.SizeF availableSize

Returns
System.Drawing.SizeF

Overrides

OnAcceptsTabChanged(EventArgs)

Raises the AcceptsTabChanged event.

Declaration
protected virtual void OnAcceptsTabChanged(EventArgs e)
Parameters
System.EventArgs e

OnBubbleEvent(RadElement, RoutedEventArgs)

Declaration
protected override void OnBubbleEvent(RadElement sender, RoutedEventArgs args)
Parameters
RadElement sender

RoutedEventArgs args

Overrides

OnClearButtonClick()

Declaration
protected virtual void OnClearButtonClick()

OnHideSelectionChanged(EventArgs)

Raises the HideSelectionChanged event.

Declaration
protected virtual void OnHideSelectionChanged(EventArgs e)
Parameters
System.EventArgs e

OnLoaded()

Declaration
protected override void OnLoaded()
Overrides

OnModifiedChanged(EventArgs)

Raises the ModifiedChanged event.

Declaration
protected virtual void OnModifiedChanged(EventArgs e)
Parameters
System.EventArgs e

OnMouseDown(MouseEventArgs)

Declaration
protected override void OnMouseDown(MouseEventArgs e)
Parameters
System.Windows.Forms.MouseEventArgs e

Overrides

OnMultilineChanged(EventArgs)

Raises the MultilineChanged event.

Declaration
protected virtual void OnMultilineChanged(EventArgs e)
Parameters
System.EventArgs e

OnReadOnlyChanged(EventArgs)

Raises the ReadOnlyChanged event.

Declaration
protected virtual void OnReadOnlyChanged(EventArgs e)
Parameters
System.EventArgs e

OnSelect()

Declaration
protected override void OnSelect()
Overrides

OnTextAlignChanged(EventArgs)

Raises the TextAlignChanged event.

Declaration
protected virtual void OnTextAlignChanged(EventArgs e)
Parameters
System.EventArgs e

Events

AcceptsTabChanged

Occurs when the value of the AcceptsTab property has changed.

Declaration
public event EventHandler AcceptsTabChanged
Event Type
System.EventHandler

HideSelectionChanged

Occurs when the value of the HideSelection property changes.

Declaration
public event EventHandler HideSelectionChanged
Event Type
System.EventHandler

ModifiedChanged

Occurs when the value of the Modified property has changed.

Declaration
public event EventHandler ModifiedChanged
Event Type
System.EventHandler

MultilineChanged

Occurs when the value of the Multiline property has changed.

Declaration
public event EventHandler MultilineChanged
Event Type
System.EventHandler

ReadOnlyChanged

Occurs when the ReadOnly property changes.

Declaration
public event EventHandler ReadOnlyChanged
Event Type
System.EventHandler

TextAlignChanged

Occurs when the value of the TextAlign property has changed.

Declaration
public event EventHandler TextAlignChanged
Event Type
System.EventHandler

TextChanged

Occurs when text has changed.

Declaration
public event EventHandler TextChanged
Event Type
System.EventHandler

TextChanging

Occurs when text is being changed.

Declaration
public event TextChangingEventHandler TextChanging
Event Type
TextChangingEventHandler

Extension Methods