Class RadDateTimePickerElement

Represents the RadDateTimePickerElement class

Inheritance
System.Object
DisposableObject
RadObject
RadElement
VisualElement
RadComponentElement
RadItem
RadEditorElement
RadDateTimePickerElement
BaseDateTimeEditorElement
RadDateTimeEditorElement
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

public class RadDateTimePickerElement : RadEditorElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IComponent, IDisposable, IBindableComponent, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode

Constructors

RadDateTimePickerElement()

Represents RadDateTimePickerElement's constructor

Declaration
public RadDateTimePickerElement()

RadDateTimePickerElement(RadDateTimePickerBehaviorDirector)

Represents RadDateTimePickerElement's constructor

Declaration
public RadDateTimePickerElement(RadDateTimePickerBehaviorDirector behaviorDirector)
Parameters
RadDateTimePickerBehaviorDirector behaviorDirector

Fields

CalendarSizeProperty

Declaration
public static RadProperty CalendarSizeProperty
Field Value
RadProperty

IsDropDownShownProperty

Represents the IsDropDownShown dependency property

Declaration
public static RadProperty IsDropDownShownProperty
Field Value
RadProperty

MaxDateTime

Gets the maximum date value allowed for the DateTimePicker control.

Declaration
public static DateTime MaxDateTime
Field Value
System.DateTime

MinDateTime

Gets the minimum date value allowed for the DateTimePicker control.

Declaration
public static DateTime MinDateTime
Field Value
System.DateTime

Properties

ArrowButton

Declaration
public RadArrowButtonElement ArrowButton { get; }
Property Value
RadArrowButtonElement

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

Calendar

Get nested RadCalendar in the popup part of the RadDateTimePicker

Declaration
public RadCalendar Calendar { get; }
Property Value
RadCalendar

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

CheckBox

Declaration
public RadCheckBoxElement CheckBox { get; }
Property Value
RadCheckBoxElement

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 CultureInfo supported by this RadCalendar object.

Describes the names of the culture, the writing system, and the calendar used, as well as access to culture-specific objects that provide methods for common operations, such as formatting dates and sorting strings.

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

Remarks

The culture names follow the RFC 1766 standard in the format "<languagecode2>-<country/regioncode2>", where <languagecode2> is a lowercase two-letter code derived from ISO 639-1 and <country/regioncode2> is an uppercase two-letter code derived from ISO 3166. For example, U.S. English is "en-US". In cases where a two-letter language code is not available, the three-letter code derived from ISO 639-2 is used; for example, the three-letter code "div" is used for cultures that use the Dhivehi language. Some culture names have suffixes that specify the script; for example, "-Cyrl" specifies the Cyrillic script, "-Latn" specifies the Latin script.

The following predefined CultureInfo names and identifiers are accepted and used by this class and other classes in the System.Globalization namespace.

Culture Name Culture Identifier Language-Country/Region
"" (empty string) 0x007F invariant culture
af 0x0036 Afrikaans
af-ZA 0x0436 Afrikaans - South Africa
sq 0x001C Albanian
sq-AL 0x041C Albanian - Albania
ar 0x0001 Arabic
ar-DZ 0x1401 Arabic - Algeria
ar-BH 0x3C01 Arabic - Bahrain
ar-EG 0x0C01 Arabic - Egypt
ar-IQ 0x0801 Arabic - Iraq
ar-JO 0x2C01 Arabic - Jordan
ar-KW 0x3401 Arabic - Kuwait
ar-LB 0x3001 Arabic - Lebanon
ar-LY 0x1001 Arabic - Libya
ar-MA 0x1801 Arabic - Morocco
ar-OM 0x2001 Arabic - Oman
ar-QA 0x4001 Arabic - Qatar
ar-SA 0x0401 Arabic - Saudi Arabia
ar-SY 0x2801 Arabic - Syria
ar-TN 0x1C01 Arabic - Tunisia
ar-AE 0x3801 Arabic - United Arab Emirates
ar-YE 0x2401 Arabic - Yemen
hy 0x002B Armenian
hy-AM 0x042B Armenian - Armenia
az 0x002C Azeri
az-AZ-Cyrl 0x082C Azeri (Cyrillic) - Azerbaijan
az-AZ-Latn 0x042C Azeri (Latin) - Azerbaijan
eu 0x002D Basque
eu-ES 0x042D Basque - Basque
be 0x0023 Belarusian
be-BY 0x0423 Belarusian - Belarus
bg 0x0002 Bulgarian
bg-BG 0x0402 Bulgarian - Bulgaria
ca 0x0003 Catalan
ca-ES 0x0403 Catalan - Catalan
zh-HK 0x0C04 Chinese - Hong Kong SAR
zh-MO 0x1404 Chinese - Macau SAR
zh-CN 0x0804 Chinese - China
zh-CHS 0x0004 Chinese (Simplified)
zh-SG 0x1004 Chinese - Singapore
zh-TW 0x0404 Chinese - Taiwan
zh-CHT 0x7C04 Chinese (Traditional)
hr 0x001A Croatian
hr-HR 0x041A Croatian - Croatia
cs 0x0005 Czech
cs-CZ 0x0405 Czech - Czech Republic
da 0x0006 Danish
da-DK 0x0406 Danish - Denmark
div 0x0065 Dhivehi
div-MV 0x0465 Dhivehi - Maldives
nl 0x0013 Dutch
nl-BE 0x0813 Dutch - Belgium
nl-NL 0x0413 Dutch - The Netherlands
en 0x0009 English
en-AU 0x0C09 English - Australia
en-BZ 0x2809 English - Belize
en-CA 0x1009 English - Canada
en-CB 0x2409 English - Caribbean
en-IE 0x1809 English - Ireland
en-JM 0x2009 English - Jamaica
en-NZ 0x1409 English - New Zealand
en-PH 0x3409 English - Philippines
en-ZA 0x1C09 English - South Africa
en-TT 0x2C09 English - Trinidad and Tobago
en-GB 0x0809 English - United Kingdom
en-US 0x0409 English - United States
en-ZW 0x3009 English - Zimbabwe
et 0x0025 Estonian
et-EE 0x0425 Estonian - Estonia
fo 0x0038 Faroese
fo-FO 0x0438 Faroese - Faroe Islands
fa 0x0029 Farsi
fa-IR 0x0429 Farsi - Iran
fi 0x000B Finnish
fi-FI 0x040B Finnish - Finland
fr 0x000C French
fr-BE 0x080C French - Belgium
fr-CA 0x0C0C French - Canada
fr-FR 0x040C French - France
fr-LU 0x140C French - Luxembourg
fr-MC 0x180C French - Monaco
fr-CH 0x100C French - Switzerland
gl 0x0056 Galician
gl-ES 0x0456 Galician - Galician
ka 0x0037 Georgian
ka-GE 0x0437 Georgian - Georgia
de 0x0007 German
de-AT 0x0C07 German - Austria
de-DE 0x0407 German - Germany
de-LI 0x1407 German - Liechtenstein
de-LU 0x1007 German - Luxembourg
de-CH 0x0807 German - Switzerland
el 0x0008 Greek
el-GR 0x0408 Greek - Greece
gu 0x0047 Gujarati
gu-IN 0x0447 Gujarati - India
he 0x000D Hebrew
he-IL 0x040D Hebrew - Israel
hi 0x0039 Hindi
hi-IN 0x0439 Hindi - India
hu 0x000E Hungarian
hu-HU 0x040E Hungarian - Hungary
is 0x000F Icelandic
is-IS 0x040F Icelandic - Iceland
id 0x0021 Indonesian
id-ID 0x0421 Indonesian - Indonesia
it 0x0010 Italian
it-IT 0x0410 Italian - Italy
it-CH 0x0810 Italian - Switzerland
ja 0x0011 Japanese
ja-JP 0x0411 Japanese - Japan
kn 0x004B Kannada
kn-IN 0x044B Kannada - India
kk 0x003F Kazakh
kk-KZ 0x043F Kazakh - Kazakhstan
kok 0x0057 Konkani
kok-IN 0x0457 Konkani - India
ko 0x0012 Korean
ko-KR 0x0412 Korean - Korea
ky 0x0040 Kyrgyz
ky-KZ 0x0440 Kyrgyz - Kazakhstan
lv 0x0026 Latvian
lv-LV 0x0426 Latvian - Latvia
lt 0x0027 Lithuanian
lt-LT 0x0427 Lithuanian - Lithuania
mk 0x002F Macedonian
mk-MK 0x042F Macedonian - FYROM
ms 0x003E Malay
ms-BN 0x083E Malay - Brunei
ms-MY 0x043E Malay - Malaysia
mr 0x004E Marathi
mr-IN 0x044E Marathi - India
mn 0x0050 Mongolian
mn-MN 0x0450 Mongolian - Mongolia
no 0x0014 Norwegian
nb-NO 0x0414 Norwegian (Bokmål) - Norway
nn-NO 0x0814 Norwegian (Nynorsk) - Norway
pl 0x0015 Polish
pl-PL 0x0415 Polish - Poland
pt 0x0016 Portuguese
pt-BR 0x0416 Portuguese - Brazil
pt-PT 0x0816 Portuguese - Portugal
pa 0x0046 Punjabi
pa-IN 0x0446 Punjabi - India
ro 0x0018 Romanian
ro-RO 0x0418 Romanian - Romania
ru 0x0019 Russian
ru-RU 0x0419 Russian - Russia
sa 0x004F Sanskrit
sa-IN 0x044F Sanskrit - India
sr-SP-Cyrl 0x0C1A Serbian (Cyrillic) - Serbia
sr-SP-Latn 0x081A Serbian (Latin) - Serbia
sk 0x001B Slovak
sk-SK 0x041B Slovak - Slovakia
sl 0x0024 Slovenian
sl-SI 0x0424 Slovenian - Slovenia
es 0x000A Spanish
es-AR 0x2C0A Spanish - Argentina
es-BO 0x400A Spanish - Bolivia
es-CL 0x340A Spanish - Chile
es-CO 0x240A Spanish - Colombia
es-CR 0x140A Spanish - Costa Rica
es-DO 0x1C0A Spanish - Dominican Republic
es-EC 0x300A Spanish - Ecuador
es-SV 0x440A Spanish - El Salvador
es-GT 0x100A Spanish - Guatemala
es-HN 0x480A Spanish - Honduras
es-MX 0x080A Spanish - Mexico
es-NI 0x4C0A Spanish - Nicaragua
es-PA 0x180A Spanish - Panama
es-PY 0x3C0A Spanish - Paraguay
es-PE 0x280A Spanish - Peru
es-PR 0x500A Spanish - Puerto Rico
es-ES 0x0C0A Spanish - Spain
es-UY 0x380A Spanish - Uruguay
es-VE 0x200A Spanish - Venezuela
sw 0x0041 Swahili
sw-KE 0x0441 Swahili - Kenya
sv 0x001D Swedish
sv-FI 0x081D Swedish - Finland
sv-SE 0x041D Swedish - Sweden
syr 0x005A Syriac
syr-SY 0x045A Syriac - Syria
ta 0x0049 Tamil
ta-IN 0x0449 Tamil - India
tt 0x0044 Tatar
tt-RU 0x0444 Tatar - Russia
te 0x004A Telugu
te-IN 0x044A Telugu - India
th 0x001E Thai
th-TH 0x041E Thai - Thailand
tr 0x001F Turkish
tr-TR 0x041F Turkish - Turkey
uk 0x0022 Ukrainian
uk-UA 0x0422 Ukrainian - Ukraine
ur 0x0020 Urdu
ur-PK 0x0420 Urdu - Pakistan
uz 0x0043 Uzbek
uz-UZ-Cyrl 0x0843 Uzbek (Cyrillic) - Uzbekistan
uz-UZ-Latn 0x0443 Uzbek (Latin) - Uzbekistan
vi 0x002A Vietnamese
vi-VN 0x042A Vietnamese - Vietnam

CurrentBehavior

Declaration
public RadDateTimePickerBehaviorDirector CurrentBehavior { get; set; }
Property Value
RadDateTimePickerBehaviorDirector

CustomFormat

Gets or sets the custom date/time format string.

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

DefaultNullDate

Gets the default null date

Declaration
protected virtual DateTime DefaultNullDate { get; }
Property Value
System.DateTime

Format

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

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

IsDropDownShown

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

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 or sets 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

MinimumDateTime

Gets or sets the minimum date value allowed for the DateTimePicker control.

Declaration
public static DateTime MinimumDateTime { get; set; }
Property Value
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

NullValueCheckMode

Set ot get which part of the datetime structure will be included when checking for NullValue.

Declaration
public virtual NullValueCheckMode NullValueCheckMode { get; set; }
Property Value
NullValueCheckMode

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

ShowCurrentTime

Gets or sets whether the current time is shown.

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

ShowTimePicker

Show or Hide the nested TimePicker element in the popup part of the RadDateTimePicker

Declaration
public bool ShowTimePicker { 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

TextBoxElement

Gets an instance of RadTextBoxElement

Declaration
public RadMaskedEditBoxElement TextBoxElement { get; }
Property Value
RadMaskedEditBoxElement

Value

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

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

Methods

CallOnNullableValueChanged(EventArgs)

Declaration
public void CallOnNullableValueChanged(EventArgs e)
Parameters
System.EventArgs e

CallOnValueChanged(EventArgs)

Declaration
public void CallOnValueChanged(EventArgs e)
Parameters
System.EventArgs e

CallOnValueChanging(ValueChangingEventArgs)

Declaration
public void CallOnValueChanging(ValueChangingEventArgs e)
Parameters
ValueChangingEventArgs e

CreateChildElements()

Declaration
protected override void CreateChildElements()
Overrides

CreateDefaultBehavior()

Creates a new instance of RadDateTimePickerBehaviorDirector

Declaration
protected virtual RadDateTimePickerBehaviorDirector CreateDefaultBehavior()
Returns
RadDateTimePickerBehaviorDirector

DisposeManagedResources()

Declaration
protected override void DisposeManagedResources()
Overrides

GetCurrentBehavior()

Gets the current behavior of the control. By default it is showing a calendar in the drop down

Declaration
public RadDateTimePickerBehaviorDirector GetCurrentBehavior()
Returns
RadDateTimePickerBehaviorDirector

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

OnBitStateChanged(Int64, Boolean, Boolean)

Declaration
protected override void OnBitStateChanged(long key, bool oldValue, bool newValue)
Parameters
System.Int64 key

System.Boolean oldValue

System.Boolean newValue

Overrides

OnClosed(RadPopupClosedEventArgs)

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

OnClosing(RadPopupClosingEventArgs)

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

OnFormatChanged(EventArgs)

Raises the FormatChanged event

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

OnKeyDown(KeyEventArgs)

Declaration
protected override void OnKeyDown(KeyEventArgs e)
Parameters
System.Windows.Forms.KeyEventArgs e

Overrides

OnLoaded()

Declaration
protected override void OnLoaded()
Overrides

OnNotifyPropertyChanged(PropertyChangedEventArgs)

Raises the PropertyChanged event

Declaration
protected override void OnNotifyPropertyChanged(PropertyChangedEventArgs e)
Parameters
System.ComponentModel.PropertyChangedEventArgs e

Overrides

OnNullableValueChanged(EventArgs)

Raises the NullableValueChanged 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

OnPropertyChanged(RadPropertyChangedEventArgs)

Declaration
protected override void OnPropertyChanged(RadPropertyChangedEventArgs e)
Parameters
RadPropertyChangedEventArgs e

Overrides

OnValueChanged(EventArgs)

Raises the ValueChanged event

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

OnValueChanging(ValueChangingEventArgs)

Raises the ValueChanged event

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

ResetNullText()

Declaration
public void ResetNullText()

ResetValue()

Resets the current value

Declaration
public void ResetValue()

SetBehavior(RadDateTimePickerBehaviorDirector)

Sets the behavior of the date picker

Declaration
protected virtual void SetBehavior(RadDateTimePickerBehaviorDirector childrenDirector)
Parameters
RadDateTimePickerBehaviorDirector childrenDirector

SetToNullValue()

Sets the current value to behave as a null value

Declaration
public void SetToNullValue()

SetValueOnly(Nullable<DateTime>)

Declaration
public void SetValueOnly(DateTime? value)
Parameters
System.Nullable<System.DateTime> value

ShouldSerializeNullText()

Declaration
public bool ShouldSerializeNullText()
Returns
System.Boolean

ToogleDropDownState()

Closes the popup if it is open, or shows the popup if it is closed.

Declaration
protected virtual void ToogleDropDownState()

ToString()

Gets the date as a string

Declaration
public override string ToString()
Returns
System.String

string value
Overrides

UnwirePopupEvents(RadDateTimePickerCalendar)

Declaration
protected virtual void UnwirePopupEvents(RadDateTimePickerCalendar calendarBehavior)
Parameters
RadDateTimePickerCalendar calendarBehavior

WirePopupEvents(RadDateTimePickerCalendar)

Declaration
protected virtual void WirePopupEvents(RadDateTimePickerCalendar calendarBehavior)
Parameters
RadDateTimePickerCalendar calendarBehavior

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

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 has changed

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