RadTimeSpanPicker
Represents a RadTimeSpanPicker control that allows users to select a TimeSpan value. The control provides both direct text input and popup selection interfaces for editing TimeSpan values.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
[TelerikToolboxCategory("Editors")]
public class RadTimeSpanPicker : RadEditorControl, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProviderInheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadEditorControlRadTimeSpanPicker...
Implements:
Inherited Members
Constructors
Initializes a new instance of the RadTimeSpanPicker class.
public RadTimeSpanPicker()Properties
Gets or sets a value indicating whether the control automatically adjusts its size to fit its content. When enabled, the control will resize itself to properly display its content and selected time span.
[Browsable(true)]
public override bool AutoSize { get; set; }Overrides:
Gets or sets the culture information used for formatting and parsing time span values. This affects how the time span is displayed and interpreted in the control.
public CultureInfo Culture { get; set; }Gets or sets the increment step for the days component when modifying the time span value using spin buttons or keyboard navigation.
public int DaysStep { get; set; }Gets the default size of the control in pixels.
protected override Size DefaultSize { get; }Overrides:
Gets or sets the edit mode that determines how users can interact with the control to modify the time span value. This property controls whether editing is done through text input, popup interface, or both.
public TimeSpanEditMode EditMode { get; set; }Gets or sets a value indicating whether end users can set the value to null using keyboard shortcuts. When enabled, users can press Ctrl+Del or Ctrl+0 to clear the current time span value.
public virtual bool EnableNullValueInput { get; set; }Gets or sets the format string that determines how the time span value is displayed in the control. The format string controls which time components are shown and how they are formatted.
[Browsable(true)]
public string Format { get; set; }Gets or sets the increment step for the hours component when modifying the time span value using spin buttons or keyboard navigation.
public int HoursStep { get; set; }Gets or sets the maximum time span value that can be selected in the control. Values above this maximum will not be accepted or displayed.
[Browsable(true)]
public TimeSpan MaxValue { get; set; }Gets or sets the increment step for the milliseconds component when modifying the time span value using spin buttons or keyboard navigation.
public int MillisecondsStep { get; set; }Gets or sets the increment step for the minutes component when modifying the time span value using spin buttons or keyboard navigation.
public int MinutesStep { get; set; }Gets or sets the minimum time span value that can be selected in the control. Values below this minimum will not be accepted or displayed.
[Browsable(true)]
public TimeSpan MinValue { get; set; }Gets or sets the text that is displayed when the control has no time span value set. This placeholder text provides guidance to users about the expected input format.
public string NullText { get; set; }Gets the popup content element that represents the element of the popup used for time span selection.
[Browsable(false)]
public ITimeSpanPickerContentElement PopupContentElement { get; }Gets or sets a value indicating whether the contents of the control can be changed by the user. When set to true, the control becomes read-only and users cannot modify the time span value.
public bool ReadOnly { get; set; }Gets or sets the increment step for the seconds component when modifying the time span value using spin buttons or keyboard navigation.
public int SecondsStep { get; set; }Gets or sets a value indicating whether the spin buttons for incrementing and decrementing time span components are visible. When enabled, users can use up/down buttons to modify the selected time component.
[Browsable(true)]
public bool ShowSpinButtons { get; set; }Gets or sets the horizontal alignment of the text within the control.
[Browsable(true)]
public HorizontalAlignment TextAlign { get; set; }Gets the main element that provides the time span picker functionality. This element encapsulates the actual UI logic and behavior of the RadTimeSpanPicker control.
[Browsable(false)]
public RadTimeSpanPickerElement TimeSpanPickerElement { get; }Methods
Creates the child elements of the control by instantiating and configuring the internal RadTimeSpanPickerElement. This method sets up the time span picker element and establishes its basic properties.
protected override void CreateChildItems(RadElement parent)The parent RadElement that will contain the child elements.
Overrides:
Creates the main time span picker element that provides the core functionality for the control.
protected virtual RadTimeSpanPickerElement CreateTimeSpanElement()A new instance of RadTimeSpanPickerElement.
Releases the unmanaged resources used by the RadTimeSpanPicker and optionally releases the managed resources.
protected override void Dispose(bool disposing)true to release both managed and unmanaged resources; false to release only unmanaged resources.
Overrides:
Handles changes to the RightToLeft property and updates the internal element accordingly.
Raises the SizeChanged event and ensures proper layout of internal elements.
Resets theme value overrides for the background color property on the internal elements.
protected override void ResetBackColorThemeOverrides()Overrides:
Resets theme value overrides for the foreground color property on the internal elements.
protected override void ResetForeColorThemeOverrides()Overrides:
Sets theme value overrides for the background color property on the internal elements.
protected override void SetBackColorThemeOverrides()Overrides:
Sets theme value overrides for the foreground color property on the internal elements.
protected override void SetForeColorThemeOverrides()Overrides:
Unsubscribes from all previously subscribed events from the internal RadTimeSpanPickerElement.
protected void UnwireEvents()Subscribes to the necessary events from the internal RadTimeSpanPickerElement.
protected void WireEvents()Processes Windows messages and handles focus management for the internal text box control.
protected override void WndProc(ref Message m)The Windows message to process.
Overrides:
Events
Occurs when the user presses a key while the control has focus.
public event KeyEventHandler KeyDownOccurs when the user presses and releases a key while the control has focus.
public event KeyPressEventHandler KeyPressOccurs when the user releases a key while the control has focus.
public event KeyEventHandler KeyUpOccurs when the popup has been successfully closed.
public event RadPopupClosedEventHandler PopupClosedOccurs when the popup is about to be closed and allows the operation to be canceled.
public event RadPopupClosingEventHandler PopupClosingOccurs when the popup has been successfully opened.
public event EventHandler PopupOpenedOccurs when the popup is about to be opened and allows the operation to be canceled.
public event CancelEventHandler PopupOpeningOccurs when the time span value has been successfully changed.
public event EventHandler ValueChangedOccurs when the time span value is about to be changed and allows the operation to be canceled.
public event CancelEventHandler ValueChanging