Class RadDateTimePicker

Represents the RadDateTimePicker class

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

Syntax

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

Constructors

RadDateTimePicker()

Represents the RadDateTimePicker constructor

Declaration
public RadDateTimePicker()

Properties

AutoSelectNextPart

This property controls whether or not the next date part will be automatically selected when the user types.

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

AutoSize

Gets or sets whether the edit control is auto-sized

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

Overrides

CalendarLocation

Gets or sets the location of the drop down showing the calendar

Declaration
public Point CalendarLocation { get; set; }
Property Value
System.Drawing.Point

CalendarSize

Gets or sets the size of the calendar in the drop down

Declaration
public Size CalendarSize { get; set; }
Property Value
System.Drawing.Size

Checked

When ShowCheckBox is true, determines that the user has selected a value

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

Culture

Gets or sets the culture supported by this calendar.

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

CustomFormat

Gets or sets the custom date/time format string.

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

DateTimePickerElement

Gets the instance of RadDateTimePickerElement wrapped by this control. RadDateTimePickerElement is the main element in the hierarchy tree and encapsulates the actual functionality of RadDateTimePicker.

Declaration
public virtual RadDateTimePickerElement DateTimePickerElement { get; set; }
Property Value
RadDateTimePickerElement

DefaultSize

Gets the control's default size

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

Format

Gets or sets the format of the date and time displayed in the control.

Declaration
public virtual DateTimePickerFormat Format { get; set; }
Property Value
System.Windows.Forms.DateTimePickerFormat

MaxDate

Gets or sets the maximum date and time that can be selected in the control.

Declaration
public DateTime MaxDate { get; set; }
Property Value
System.DateTime

MaximumDateTime

Gets the maximum date value allowed for the DateTimePicker control.

Declaration
public static DateTime MaximumDateTime { get; set; }
Property Value
System.DateTime

MinDate

Gets or sets the minimum date and time that can be selected in the control.

Declaration
public DateTime MinDate { get; set; }
Property Value
System.DateTime

Name

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

NullableValue

Gets or sets the date/time value assigned to the control.

Declaration
public virtual DateTime? NullableValue { get; set; }
Property Value
System.Nullable<System.DateTime>

NullDate

The DateTime value assigned to the date picker when the Value is null

Declaration
public DateTime NullDate { get; set; }
Property Value
System.DateTime

NullText

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

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

ReadOnly

Gets or sets a value indicating whether RadDateTimePicker is read-only.

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

true if the RadDateTimePicker is read-only; otherwise, false. The default is false.

ShowCheckBox

Indicates whether a check box is displayed in the control. When the check box is unchecked no value is selected

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

ShowUpDown

Indicates whether a spin box rather than a drop down calendar is displayed for editing the control's value

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

Text

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

Overrides

Value

Gets or sets the date/time value assigned to the control.

Declaration
public virtual DateTime Value { get; set; }
Property Value
System.DateTime

Methods

ControlDefinesThemeForElement(RadElement)

Declaration
public override bool ControlDefinesThemeForElement(RadElement element)
Parameters
RadElement element

Returns
System.Boolean

Overrides

CreateAccessibilityInstance()

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

CreateChildItems(RadElement)

creates and initializes the RadDateTimePickerElement

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

Overrides

CreateElement()

Declaration
protected virtual RadDateTimePickerElement CreateElement()
Returns
RadDateTimePickerElement

Dispose(Boolean)

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

Overrides

EndInit()

Declaration
public override void EndInit()
Overrides

OnCheckedChanged(EventArgs)

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

OnClosed(RadPopupClosedEventArgs)

Declaration
protected virtual void OnClosed(RadPopupClosedEventArgs args)
Parameters
RadPopupClosedEventArgs args

OnClosing(RadPopupClosingEventArgs)

Declaration
protected virtual void OnClosing(RadPopupClosingEventArgs args)
Parameters
RadPopupClosingEventArgs args

OnEnabledChanged(EventArgs)

Declaration
protected override void OnEnabledChanged(EventArgs e)
Parameters
System.EventArgs e

Overrides

OnEnter(EventArgs)

Declaration
protected override void OnEnter(EventArgs e)
Parameters
System.EventArgs e

OnFormatChanged(EventArgs)

Raises the FormatChanged event

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

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

OnLeave(EventArgs)

Declaration
protected override void OnLeave(EventArgs e)
Parameters
System.EventArgs e

OnLostFocus(EventArgs)

Declaration
protected override void OnLostFocus(EventArgs e)
Parameters
System.EventArgs e

Overrides

OnNullableValueChanged(EventArgs)

Raises the ValueChanged event

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

OnOpened(EventArgs)

Declaration
protected virtual void OnOpened(EventArgs args)
Parameters
System.EventArgs args

OnOpening(CancelEventArgs)

Declaration
protected virtual void OnOpening(CancelEventArgs args)
Parameters
System.ComponentModel.CancelEventArgs args

OnPreviewKeyDown(PreviewKeyDownEventArgs)

Declaration
protected override void OnPreviewKeyDown(PreviewKeyDownEventArgs e)
Parameters
System.Windows.Forms.PreviewKeyDownEventArgs e

Overrides

OnRightToLeftChanged(EventArgs)

Declaration
protected override void OnRightToLeftChanged(EventArgs e)
Parameters
System.EventArgs e

Overrides

OnThemeChanged()

Declaration
protected override void OnThemeChanged()
Overrides

OnValueChanged(EventArgs)

Raises the ValueChanged event

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

OnValueChanging(ValueChangingEventArgs)

Raises the ValueChanging event

Declaration
protected virtual void OnValueChanging(ValueChangingEventArgs e)
Parameters
ValueChangingEventArgs e

ProcessAutoSizeChanged(Boolean)

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

Overrides

ResetBackColorThemeOverrides()

Declaration
protected override void ResetBackColorThemeOverrides()
Overrides

ResetCulture()

Declaration
public void ResetCulture()

ResetForeColorThemeOverrides()

Declaration
protected override void ResetForeColorThemeOverrides()
Overrides

ResetNullText()

Declaration
public void ResetNullText()

SetBackColorThemeOverrides()

Declaration
protected override void SetBackColorThemeOverrides()
Overrides

SetForeColorThemeOverrides()

Declaration
protected override void SetForeColorThemeOverrides()
Overrides

SetToNullValue()

Sets the current value to behave as a null value

Declaration
public void SetToNullValue()

ShouldSerializeMaxDate()

Declaration
public bool ShouldSerializeMaxDate()
Returns
System.Boolean

ShouldSerializeMinDate()

Declaration
public bool ShouldSerializeMinDate()
Returns
System.Boolean

WndProc(ref Message)

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

Overrides

Events

CheckedChanged

Occurs when the value of the checkbox in the editor is changed

Declaration
public event EventHandler CheckedChanged
Event Type
System.EventHandler

Closed

Occurs when the drop down is closed

Declaration
public event RadPopupClosedEventHandler Closed
Event Type
RadPopupClosedEventHandler

Closing

Occurs when the drop down is closing

Declaration
public event RadPopupClosingEventHandler Closing
Event Type
RadPopupClosingEventHandler

FormatChanged

Occurs when the format of the control has changed

Declaration
public event EventHandler FormatChanged
Event Type
System.EventHandler

KeyDown

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

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

KeyPress

Occurs when the RadItem has focus and the user presses 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

MaskProviderCreated

Occurs when MaskProvider has been created This event will be fired multiple times because the provider is created when some properties changed Properties are: Mask, Culture, MaskType and more.

Declaration
public event EventHandler MaskProviderCreated
Event Type
System.EventHandler

NullableValueChanged

Occurs when the value of the control is changing

Declaration
public event EventHandler NullableValueChanged
Event Type
System.EventHandler

Opened

Occurs when the drop down is opened

Declaration
public event EventHandler Opened
Event Type
System.EventHandler

Opening

Occurs when the drop down is opening

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

ToggleStateChanged

Occurs when the CheckBox's state changes.

Declaration
public event StateChangedEventHandler ToggleStateChanged
Event Type
StateChangedEventHandler

ToggleStateChanging

Occurs before the CheckBox's state changes.

Declaration
public event StateChangingEventHandler ToggleStateChanging
Event Type
StateChangingEventHandler

ValueChanged

Occurs when the value of the control has changed

Declaration
public event EventHandler ValueChanged
Event Type
System.EventHandler

ValueChanging

Occurs when the value of the control is changing

Declaration
public event ValueChangingEventHandler ValueChanging
Event Type
ValueChangingEventHandler

Extension Methods