EditorBaseElement
Base class for in-place editor elements, providing value storage, formatting/parsing hooks and validation events shared by all editor types.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
[RadToolboxItem(false)]
public abstract class EditorBaseElement : RadEditorElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IBindableComponent, IComponent, IDisposable, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IInputEditor, IValueEditor, ISupportInitialize
Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemRadEditorElementEditorBaseElement...
Derived Classes:
Implements:
Inherited Members
Constructors
protected EditorBaseElement()
Fields
protected IEditorHandler EditorHandler
protected object originalValue
Properties
Gets or sets the value assigned to the editor when it is initialized without an explicit value.
public object DefaultValue { get; set; }
Gets or sets the child element that hosts the actual input UI; defaults to the editor itself.
public virtual RadItem EditorElement { get; set; }
public IEditorManager EditorManager { get; set; }
Implements:
Gets the identifier used to register and look up this editor type in the editor manager.
public virtual string EditorType { get; }
Gets whether the editor's value has changed since it was initialized.
public virtual bool IsModified { get; }
Implements:
public bool IsMouseCaptured { get; }
Gets whether the editor is instantiated on demand or is always availabele. Example: GridBooleanCellElement and GridViewBooleanColumn.
public virtual bool IsNestedEditor { get; }
Gets or sets the upper bound accepted by the editor, when range validation is supported.
public virtual object MaxValue { get; set; }
Gets or sets the lower bound accepted by the editor, when range validation is supported.
public virtual object MinValue { get; set; }
Gets or sets the value treated as representing a null/empty entry for this editor.
public object NullValue { get; set; }
public virtual EditorSupportedType SupportedType { get; }
Gets or sets the editor's current, unformatted value.
public virtual object Value { get; set; }
Implements:
public virtual EditorVisualMode VisualMode { get; }
Methods
public virtual void BeginEdit()
Implements:
Signals that batch initialization is starting, suspending validation until EndInit() is called.
public virtual void BeginInit()
Implements:
Signals that batch initialization has completed, resuming normal validation behavior.
public virtual void EndInit()
Implements:
Gets the VisualElement that must receive the focus, when the editor is invoked.
Initializes the provider.
public virtual void Initialize()
Initializes the provider.
public virtual void Initialize(object value)
value to be pre-loaded inside the initialized editor.
Initializes the fields of this instance with their default values.
protected override void InitializeFields()
Overrides:
Raises the KeyDown event.
protected override void OnKeyDown(KeyEventArgs e)
The key event arguments.
Overrides:
Raises the KeyUp event.
protected override void OnKeyUp(KeyEventArgs e)
The key event arguments.
Overrides:
Raises the TextChanged event.
Raises the TextChanging event.
protected override void OnTextChanging(TextChangingEventArgs e)
A TextChangingEventArgs that contains the event data.
Overrides:
protected virtual void OnValidationError(ValidationErrorEventArgs args)
protected virtual void OnValueChanging(ValueChangingEventArgs args)
public void ReleaseMouseCapture()
protected virtual void ValidateCore()
Events
Occurs when the underlying value is converted to its display representation, allowing custom formatting.
public event ConvertEventHandler Format
Occurs when the displayed text is converted back to the underlying value, allowing custom parsing.
public event ConvertEventHandler Parse
Occurs when the current value is requested, allowing a handler to supply or override it.
public event CancelEventHandler QueryValue
Occurs after the editor's value has passed validation.
public event EventHandler Validated
Implements:
Occurs before the editor's value is validated, allowing validation to be canceled.
public event CancelEventHandler Validating
Implements:
Occurs when internally the editor detects an error or when the Validating event fails.
public event ValidationErrorEventHandler ValidationError
Implements:
Occurs when the value of the editor changes.
[Browsable(true)]
public event EventHandler ValueChanged
Implements:
Reserved for future use; not currently raised.
public event ValueChangingEventHandler ValueChanging
Implements: