RadTimePicker
Represents a control that allows the user to select a time and to display the time with a specified format.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
[TelerikToolboxCategory("Editors")]
public class RadTimePicker : RadEditorControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider
Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadEditorControlRadTimePicker...
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadTimePicker class with default settings.
public RadTimePicker()
Properties
Gets or sets a value indicating whether the edit control is automatically resized to display its entire contents.
[Browsable(true)]
public override bool AutoSize { get; set; }
true if the control automatically resizes; otherwise, false. The default value is true.
Overrides:
Gets or sets the height of the button panel in the time picker popup.
[Browsable(false)]
public int ButtonPanelHeight { get; set; }
An integer representing the button panel height in pixels. The default value is 35.
Gets or sets the position of the clock relative to the time tables in the time picker popup.
public ClockPosition ClockPosition { get; set; }
A ClockPosition enumeration value specifying the clock position. The default value is ClockBeforeTables.
Gets or sets the text displayed on the close button in the time picker popup.
public virtual string CloseButtonText { get; set; }
A string containing the text for the close button. The default value is "Close".
Gets or sets the number of columns displayed in the time picker popup.
[Browsable(false)]
public int ColumnsCount { get; set; }
An integer representing the number of columns. Valid values are between 4 and 12. The default value is 4.
Gets or sets the culture information used to format and parse time values in the time picker.
public CultureInfo Culture { get; set; }
A CultureInfo object that represents the culture to use for time formatting.
Gets the default size of the control.
protected override Size DefaultSize { get; }
Overrides:
Gets or sets the height of the header section in the time picker popup.
[Browsable(false)]
public int HeadersHeight { get; set; }
An integer representing the header height in pixels. The default value is 19.
Gets or sets the Maximal time value assigned to the control.
[Browsable(true)]
public DateTime MaxValue { get; set; }
Gets or sets the Minimal time value assigned to the control.
[Browsable(true)]
public DateTime MinValue { get; set; }
Gets or sets the text that is displayed when RadDropDownList has no text set.
public string NullText { get; set; }
Gets or sets a value indicating whether the contents of the TextBox control can be changed.
public bool ReadOnly { get; set; }
Gets or sets the height of each time row in the time picker popup.
[Browsable(false)]
public int RowHeight { get; set; }
An integer representing the row height in pixels. The default value is 29.
Indicates whether to show the spin buttons.
[Browsable(true)]
public bool ShowSpinButtons { get; set; }
Gets or sets the time interval step for the time picker in minutes.
public int Step { get; set; }
An integer representing the time step in minutes. Valid values are between 1 and 59. The default value is 5.
Gets or sets the width of the time table in the time picker popup.
[Browsable(false)]
public int TableWidth { get; set; }
An integer representing the table width in pixels. The default value is 170.
Gets the RadTimePickerElement which encapsulates the UI representation and functionality of the control.
[Browsable(false)]
public RadTimePickerElement TimePickerElement { get; }
Gets or sets the configuration of time tables displayed in the time picker popup.
public TimeTables TimeTables { get; set; }
A TimeTables enumeration value that determines how time is represented. The default value is HoursAndMinutesInTwoTables.
Methods
Creates the child elements for the RadTimePicker control.
protected override void CreateChildItems(RadElement parent)
The root element that will contain the child elements.
Overrides:
Creates the RadTimePickerElement that serves as the main element for this control.
protected virtual RadTimePickerElement CreateTimePickerElement()
A new instance of RadTimePickerElement.
Raises the KeyDown event.
public virtual void OnKeyDown(object sender, KeyEventArgs e)
The source of the event.
eKeyEventArgsA KeyEventArgs that contains the event data.
Raises the KeyPress event.
public virtual void OnKeyPress(object sender, KeyPressEventArgs e)
The source of the event.
eKeyPressEventArgsA KeyPressEventArgs that contains the event data.
Raises the KeyUp event.
public virtual void OnKeyUp(object sender, KeyEventArgs e)
The source of the event.
eKeyEventArgsA KeyEventArgs that contains the event data.
Raises the MultilineChanged event.
Occurs when right to left property is changed.
protected override void OnRightToLeftChanged(EventArgs e)
The event arguments.
Overrides:
Raises the SizeChanged event.
protected override void OnSizeChanged(EventArgs e)
An event args the contain the event data.
Overrides:
Raises the TextAlignChanged event.
Raises the ValueChanged event.
Raises the ValueChanging event.
protected virtual void OnValueChanging(object sender, CancelEventArgs e)
The source of the event.
eCancelEventArgsA CancelEventArgs that contains the event data.
Occurs when the BackColor property is reset and is used to reset overridden theme settings in the elements hierarchy.
protected override void ResetBackColorThemeOverrides()
Overrides:
Occurs when the ForeColor property is reset and is used to reset overridden theme settings in the elements hierarchy.
protected override void ResetForeColorThemeOverrides()
Overrides:
Occurs when the BackColor property is changed and is used to override theme settings in the elements hierarchy.
protected override void SetBackColorThemeOverrides()
Overrides:
Occurs when the ForeColor property is changed and is used to override theme settings in the elements hierarchy.
protected override void SetForeColorThemeOverrides()
Overrides:
Detaches from all events of its sub-elements.
protected void UnwireEvents()
Attaches to all events of its sub-elements.
protected void WireEvents()
Processes windows messages.
protected override void WndProc(ref Message m)
The windows message to process.
Overrides:
Events
Occurs when the RadItem has focus and the user presses a key down
public event KeyEventHandler KeyDown
Occurs when the RadItem has focus and the user presses a key
public event KeyPressEventHandler KeyPress
Occurs when the RadItem has focus and the user releases the pressed key up
public event KeyEventHandler KeyUp
Occurs when the value of the Multiline property has changed.
[Browsable(true)]
public event EventHandler MultilineChanged
Occurs when the value of the TextAlign property has changed.
[Browsable(true)]
public event EventHandler TextAlignChanged
Occurs when a cell changes its state.
public event TimeCellFormattingEventHandler TimeCellFormatting
Occurs when the editing value has been changed
public event EventHandler ValueChanged
Occurs when the editing value is changing.
public event CancelEventHandler ValueChanging