Class
RadDateTimePickerCalendar

Represents the RadDateTimePickerCalendar class

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

cs-api-definition
public class RadDateTimePickerCalendar : RadDateTimePickerBehaviorDirector, IDisposable

Inheritance: objectRadDateTimePickerBehaviorDirectorRadDateTimePickerCalendar

Implements: IDisposable

Constructors

RadDateTimePickerCalendar(RadDateTimePickerElement)

Initializes a new instance of the RadDateTimePickerCalendar class with the specified date time picker element.

Declaration

cs-api-definition
public RadDateTimePickerCalendar(RadDateTimePickerElement dateTimePicker)

Parameters

dateTimePicker

RadDateTimePickerElement

The RadDateTimePickerElement that owns this calendar behavior.

Properties

ArrowButton

Gets the RadArrowButtonElement instance that represents the Date Time Picker's arrow button.

Declaration

cs-api-definition
public RadArrowButtonElement ArrowButton { get; }

Property Value

RadArrowButtonElement

Calendar

Gets or sets the calendar control which is shown when the pop up control is shown

Declaration

cs-api-definition
[Browsable(true)]
public RadCalendar Calendar { get; set; }

Property Value

RadCalendar

DateTimePickerElement

Gets the instance of RadDateTimePickerElement associated to the control

Declaration

cs-api-definition
[Browsable(false)]
public override RadDateTimePickerElement DateTimePickerElement { get; }

Property Value

RadDateTimePickerElement

Overrides RadDateTimePickerBehaviorDirector.DateTimePickerElement

DropDownMaxSize

Gets or sets the drop down maximum size.

Declaration

cs-api-definition
[Browsable(true)]
public Size DropDownMaxSize { get; set; }

Property Value

Size

DropDownMinSize

Gets or sets the drop down minimum size.

Declaration

cs-api-definition
[Browsable(true)]
public Size DropDownMinSize { get; set; }

Property Value

Size

DropDownSizingMode

Gets or sets the drop down sizing mode. The mode can be: horizontal, vertical or a combination of them.

Declaration

cs-api-definition
[Browsable(true)]
public SizingMode DropDownSizingMode { get; set; }

Property Value

SizingMode

FooterPanel

Gets the TimePickerDoneButtonContent instance that provides the footer panel with Done button functionality.

Declaration

cs-api-definition
public TimePickerDoneButtonContent FooterPanel { get; }

Property Value

TimePickerDoneButtonContent

IsDropDownShow

Gets a value representing whether the drop down is shown

Declaration

cs-api-definition
[Browsable(false)]
public bool IsDropDownShow { get; }

Property Value

bool

LastShowDpiScale

Gets or sets the DPI scale factor from the last time the dropdown was shown, used for proper scaling on DPI changes.

Declaration

cs-api-definition
public SizeF LastShowDpiScale { get; set; }

Property Value

SizeF

PopupControl

Gets or sets the drop down control which is shown when the user clicks on the arrow button

Declaration

cs-api-definition
[Browsable(true)]
public RadDateTimePickerDropDown PopupControl { get; set; }

Property Value

RadDateTimePickerDropDown

ShowFooter

Gets or sets a value indicating whether the footer panel with Done button is displayed when the time picker is shown.

Declaration

cs-api-definition
public bool ShowFooter { get; set; }

Property Value

bool

ShowTimePicker

Gets or sets a value indicating whether the time picker control is displayed alongside the calendar in the dropdown.

Declaration

cs-api-definition
public bool ShowTimePicker { get; set; }

Property Value

bool

TextBoxElement

Gets the RadMaskedEditBoxElement instance that provides the text input functionality for date and time values.

Declaration

cs-api-definition
public override RadMaskedEditBoxElement TextBoxElement { get; }

Property Value

RadMaskedEditBoxElement

Overrides RadDateTimePickerBehaviorDirector.TextBoxElement

TimePicker

Gets the RadTimePickerContent instance that provides time selection functionality when ShowTimePicker is enabled.

Declaration

cs-api-definition
public RadTimePickerContent TimePicker { get; }

Property Value

RadTimePickerContent

Methods

CreateCheckBoxElement()

Creates and configures the checkbox element for the date time picker with default alignment and sizing properties.

Declaration

cs-api-definition
protected virtual RadCheckBoxElement CreateCheckBoxElement()

Returns

RadCheckBoxElement

A configured RadCheckBoxElement instance.

CreateChildren()

Creates dateTimePicker's children

Declaration

cs-api-definition
public override void CreateChildren()

Overrides RadDateTimePickerBehaviorDirector.CreateChildren()

Dispose()

Releases all resources used by the RadDateTimePickerCalendar including event subscriptions and child controls.

Declaration

cs-api-definition
public void Dispose()

Implements IDisposable.Dispose()

IntializeCalendar()

Initializes the calendar control with default settings, creates popup elements, and configures event handlers and date range constraints.

Declaration

cs-api-definition
protected virtual void IntializeCalendar()

SetDateByValue(DateTime?, DateTimePickerFormat)

Sets the date displayed in the text box using the specified date value and format type, handling culture-specific formatting and null values.

Declaration

cs-api-definition
public override void SetDateByValue(DateTime? date, DateTimePickerFormat formatType)

Parameters

date

DateTime?

The date value to set, or null to clear the text box.

formatType

DateTimePickerFormat

The DateTimePickerFormat that determines how the date should be formatted and displayed.

Overrides RadDateTimePickerBehaviorDirector.SetDateByValue(DateTime?, DateTimePickerFormat)

ShowDropDown()

Shows the drop-down window part of the combo box

Declaration

cs-api-definition
public virtual void ShowDropDown()