Class

RadDateTimePicker

Initializes a new instance of the RadDateTimePicker class with default settings. Sets up the control with AutoSize enabled and makes it selectable.

Declaration

public RadDateTimePicker()

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

Gets or sets whether the edit control is auto-sized

Declaration

[Browsable(true)]
public override bool AutoSize { get; set; }

Property Value

Overrides RadControl.AutoSize

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

Declaration

[Browsable(false)]
public Point CalendarLocation { get; set; }

Property Value

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

Declaration

[Browsable(false)]
public Size CalendarSize { get; set; }

Property Value

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

Declaration

public bool Checked { get; set; }

Property Value

Gets or sets the culture supported by this calendar.

Declaration

[TypeConverter(typeof(CultureInfoConverter))]
public CultureInfo Culture { get; set; }

Property Value

Gets or sets the custom date/time format string.

Declaration

public string CustomFormat { get; set; }

Property Value

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

[Browsable(false)]
public virtual RadDateTimePickerElement DateTimePickerElement { get; set; }

Property Value

Gets the control's default size, which is 164 pixels wide by 20 pixels high.

Declaration

protected override Size DefaultSize { get; }

Property Value

Overrides Control.DefaultSize

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

Declaration

public virtual DateTimePickerFormat Format { get; set; }

Property Value

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

Declaration

public DateTime MaxDate { get; set; }

Property Value

Gets the maximum date value allowed for the DateTimePicker control.

Declaration

[Browsable(false)]
public static DateTime MaximumDateTime { get; set; }

Property Value

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

Declaration

public DateTime MinDate { get; set; }

Property Value

Gets or sets the name of the control and synchronizes it with the internal TextBoxItem control.

Declaration

public string Name { get; set; }

Property Value

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

Declaration

[Bindable(false)]
public DateTime NullDate { get; set; }

Property Value

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

Declaration

public string NullText { get; set; }

Property Value

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

Declaration

[Bindable(true)]
[Browsable(false)]
public virtual DateTime? NullableValue { get; set; }

Property Value

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

Declaration

public bool ReadOnly { get; set; }

Property Value

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

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

Gets or sets the text associated with this control. This is the displayed representation of the date/time value based on the current format settings.

Declaration

[Browsable(true)]
[Bindable(true)]
[SettingsBindable(true)]
public override string Text { get; set; }

Property Value

Overrides RadControl.Text

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

Declaration

[Bindable(true)]
public virtual DateTime Value { get; set; }

Property Value

Checks whether the element's theme is defined by the control.

Declaration

public override bool ControlDefinesThemeForElement(RadElement element)

Parameters

Returns

Overrides RadControl.ControlDefinesThemeForElement(RadElement)

Remarks

Creates an accessible object for this control to support screen readers and other accessibility tools.

Declaration

protected override AccessibleObject CreateAccessibilityInstance()

Returns

Overrides Control.CreateAccessibilityInstance()

Creates and initializes the RadDateTimePickerElement that provides the main functionality for this control. Sets up all necessary event handlers for the element.

Declaration

protected override void CreateChildItems(RadElement parent)

Parameters

Overrides RadControl.CreateChildItems(RadElement)

Creates a new instance of the RadDateTimePickerElement for use in this control.

Declaration

protected virtual RadDateTimePickerElement CreateElement()

Returns

Releases the unmanaged resources used by the control and optionally releases the managed resources. Properly unregisters all event handlers to prevent memory leaks.

Declaration

protected override void Dispose(bool disposing)

Parameters

Overrides RadControl.Dispose(bool)

Signals the object that initialization is complete and triggers the creation of the mask provider for the text box element.

Declaration

public override void EndInit()

Overrides RadControl.EndInit()

Raises the CheckedChanged event.

Declaration

protected virtual void OnCheckedChanged(EventArgs e)

Parameters

Raises the Closed event.

Declaration

protected virtual void OnClosed(RadPopupClosedEventArgs args)

Parameters

Raises the Closing event.

Declaration

protected virtual void OnClosing(RadPopupClosingEventArgs args)

Parameters

Declaration

protected override void OnEnabledChanged(EventArgs e)

Parameters

Overrides RadControl.OnEnabledChanged(EventArgs)

Handles the control's enter event by shifting focus to the contained text box element.

Declaration

protected override void OnEnter(EventArgs e)

Parameters

Overrides Control.OnEnter(EventArgs)

Raises the FormatChanged event

Declaration

protected virtual void OnFormatChanged(EventArgs e)

Parameters

Handles the KeyDown event for the control.

Declaration

public virtual void OnKeyDown(object sender, KeyEventArgs e)

Parameters

Handles the KeyPress event for the control.

Declaration

public virtual void OnKeyPress(object sender, KeyPressEventArgs e)

Parameters

Handles the KeyUp event for the control.

Declaration

public virtual void OnKeyUp(object sender, KeyEventArgs e)

Parameters

Handles the control's leave event by triggering the lost focus event.

Declaration

protected override void OnLeave(EventArgs e)

Parameters

Overrides Control.OnLeave(EventArgs)

Handles the control's lost focus event with protection against recursive focus loss handling.

Declaration

protected override void OnLostFocus(EventArgs e)

Parameters

Overrides RadControl.OnLostFocus(EventArgs)

Raises the ValueChanged event

Declaration

protected virtual void OnNullableValueChanged(EventArgs e)

Parameters

Raises the Opened event.

Declaration

protected virtual void OnOpened(EventArgs args)

Parameters

Raises the Opening event.

Declaration

protected virtual void OnOpening(CancelEventArgs args)

Parameters

Declaration

protected override void OnPreviewKeyDown(PreviewKeyDownEventArgs e)

Parameters

Overrides RadControl.OnPreviewKeyDown(PreviewKeyDownEventArgs)

Handles changes to the right-to-left layout property and propagates the setting to child elements.

Declaration

protected override void OnRightToLeftChanged(EventArgs e)

Parameters

Overrides RadControl.OnRightToLeftChanged(EventArgs)

Handles theme changes to ensure all child elements properly reflect the current theme settings. Makes special adjustments for material themes.

Declaration

protected override void OnThemeChanged()

Overrides RadControl.OnThemeChanged()

Raises the ValueChanged event

Declaration

protected virtual void OnValueChanged(EventArgs e)

Parameters

Raises the ValueChanging event

Declaration

protected virtual void OnValueChanging(ValueChangingEventArgs e)

Parameters

Declaration

protected override void ProcessAutoSizeChanged(bool value)

Parameters

Overrides RadControl.ProcessAutoSizeChanged(bool)

Declaration

protected override void ResetBackColorThemeOverrides()

Overrides RadControl.ResetBackColorThemeOverrides()

Resets the Culture property to its default value ("en-US").

Declaration

public void ResetCulture()

Declaration

protected override void ResetForeColorThemeOverrides()

Overrides RadControl.ResetForeColorThemeOverrides()

Resets the NullText property to its default value (empty string).

Declaration

public void ResetNullText()

Declaration

protected override void SetBackColorThemeOverrides()

Overrides RadControl.SetBackColorThemeOverrides()

Declaration

protected override void SetForeColorThemeOverrides()

Overrides RadControl.SetForeColorThemeOverrides()

Sets the current value to behave as a null value. This clears the current date selection and displays the NullText if specified.

Declaration

public void SetToNullValue()

Declaration

protected override void WndProc(ref Message m)

Parameters

Overrides RadControl.WndProc(ref Message)

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

Declaration

public event EventHandler CheckedChanged

Event Value

Occurs when the drop down is closed

Declaration

public event RadPopupClosedEventHandler Closed

Event Value

Occurs when the drop down is closing

Declaration

public event RadPopupClosingEventHandler Closing

Event Value

Occurs when the format of the control has changed

Declaration

public event EventHandler FormatChanged

Event Value

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

Declaration

public event KeyEventHandler KeyDown

Event Value

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

Declaration

public event KeyPressEventHandler KeyPress

Event Value

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

Declaration

public event KeyEventHandler KeyUp

Event Value

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 Value

Occurs when the value of the control is changing

Declaration

public event EventHandler NullableValueChanged

Event Value

Occurs when the drop down is opened

Declaration

public event EventHandler Opened

Event Value

Occurs when the drop down is opening

Declaration

public event CancelEventHandler Opening

Event Value

Occurs when the CheckBox's state changes.

Declaration

public event StateChangedEventHandler ToggleStateChanged

Event Value

Occurs before the CheckBox's state changes.

Declaration

public event StateChangingEventHandler ToggleStateChanging

Event Value

Occurs when the value of the control has changed

Declaration

public event EventHandler ValueChanged

Event Value

Occurs when the value of the control is changing

Declaration

public event ValueChangingEventHandler ValueChanging

Event Value