New to Telerik UI for ASP.NET AJAX? Start a free 30-day trial

RadTimePicker

Class

A RadDateInput control in time only mode with an integrated RadTimeView control to let users enter a time directly in the input area or select it from the popup time view control. The values of the two controls are synchronized to allow further change of the chosen time.

Definition

Namespace:Telerik.Web.UI

Assembly:Telerik.Web.UI.dll

Syntax:

[EmbeddedSkin("TimePicker", typeof(RadTimePicker))]
[EmbeddedSkin("TimePicker", "Black", typeof(RadTimePicker))]
[EmbeddedSkin("TimePicker", "Default", typeof(RadTimePicker))]
[EmbeddedSkin("TimePicker", "Office2007", typeof(RadTimePicker))]
[EmbeddedSkin("TimePicker", "Outlook", typeof(RadTimePicker))]
[EmbeddedSkin("TimePicker", "Simple", typeof(RadTimePicker))]
[EmbeddedSkin("TimePicker", "Sunset", typeof(RadTimePicker))]
[EmbeddedSkin("TimePicker", "Telerik", typeof(RadTimePicker))]
[EmbeddedSkin("TimePicker", "Vista", typeof(RadTimePicker))]
[EmbeddedSkin("TimePicker", "Web20", typeof(RadTimePicker))]
[EmbeddedSkin("TimePicker", "WebBlue", typeof(RadTimePicker))]
[EmbeddedSkin("TimePicker", "Windows7", typeof(RadTimePicker))]
[ToolboxBitmap(typeof(RadTimePicker), "Toolbox.Icons.TimePicker.png")]
[TelerikToolboxCategory("Date/Color Picker")]
[ValidationProperty("ValidationDate")]
[ControlValueProperty("SelectedDate")]
[ClientScriptResource("Telerik.Web.UI.RadDateTimePicker", "Telerik.Web.UI.Calendar.RadCalendarCommonScript.js")]
[ClientScriptResource("Telerik.Web.UI.RadDateTimePicker", "Telerik.Web.UI.Calendar.RadDateTimePickerScript.js")]
public class RadTimePicker : RadDateTimePicker, IComponent, IDisposable, IParserAccessor, IUrlResolutionService, IDataBindingsAccessor, IControlBuilderAccessor, IControlDesignerAccessor, IExpressionsAccessor, IAttributeAccessor, IScriptControl, IControlResolver, ISkinnableControl, IControl, INamingContainer, IPostBackEventHandler, IPostBackDataHandler

Inheritance: objectControlWebControlRadWebControlRadDatePickerRadDateTimePickerRadTimePicker...

Implements: IAttributeAccessorIComponentIControlIControlBuilderAccessorIControlDesignerAccessorIControlResolverIDataBindingsAccessorIDisposableIExpressionsAccessorINamingContainerIParserAccessorIPostBackDataHandlerIPostBackEventHandlerIScriptControlISkinnableControlIUrlResolutionService...

Inherited Members RadDateTimePicker.OnPreRender(EventArgs)RadDateTimePicker.OnItemDataBound(TimePickerEventArgs)RadDateTimePicker.OnItemCreated(TimePickerEventArgs)RadDateTimePicker.TruncateTimeComponent(DateTime)RadDateTimePicker.SetRenderMode(RenderMode)RadDateTimePicker.AddAdditionalControlComponents(HtmlTextWriter)RadDateTimePicker.DescribeClientProperties(IScriptDescriptor)RadDateTimePicker.DescribeClientEvents(IScriptDescriptor)RadDateTimePicker.SkinRadDateTimePicker.ImagesPathRadDateTimePicker.EnableEmbeddedSkinsRadDateTimePicker.EnableEmbeddedScriptsRadDateTimePicker.EnableEmbeddedBaseStylesheetRadDateTimePicker.RegisterWithScriptManagerRadDateTimePicker.ValidationDateRadDateTimePicker.TimeViewRadDateTimePicker.TimePopupButtonRadDateTimePicker.CultureRadDateTimePicker.SharedTimeViewIDRadDateTimePicker.SharedTimeViewRadDateTimePicker.ShouldRenderAdditionalControlsRadDateTimePicker.ItemDataBoundRadDateTimePicker.ItemCreatedRadDatePicker.defaultWidthRadDatePicker.OnChildrenCreated()RadDatePicker.OnSelectedDateChanged(SelectedDateChangedEventArgs)RadDatePicker.OnInit(EventArgs)RadDatePicker.CreateChildControls()RadDatePicker.AddAttributesToRender(HtmlTextWriter)RadDatePicker.RenderBrowserSpecificStyles(HtmlTextWriter)RadDatePicker.Render(HtmlTextWriter)RadDatePicker.RenderContents(HtmlTextWriter)RadDatePicker.RangeSelectedDateProperty(DateTime?)RadDatePicker.ConfigureCalendar()RadDatePicker.ConfigureDateInput()RadDatePicker.ControlPreRender()RadDatePicker.Focus()RadDatePicker.Clear()RadDatePicker.DescribeComponent(IScriptDescriptor)RadDatePicker.RegisterCssReferences()RadDatePicker.LoadClientState(Dictionary<string, object>)RadDatePicker.SmartPasteDescriptionRadDatePicker.LocalizationPathRadDatePicker.SupportsRenderingModeRadDatePicker.TagKeyRadDatePicker.BrowserRadDatePicker.CalendarRadDatePicker.DateInputRadDatePicker.DatePopupButtonRadDatePicker.EnabledRadDatePicker.TabIndexRadDatePicker.HiddenInputTitleAttibuteRadDatePicker.WrapperTableSummaryRadDatePicker.WrapperTableCaptionRadDatePicker.PopupDirectionRadDatePicker.EnableScreenBoundaryDetectionRadDatePicker.ZIndexRadDatePicker.EnableShadowsRadDatePicker.SelectedDateRadDatePicker.SkipMinMaxDateValidationOnServerRadDatePicker.InvalidTextBoxValueRadDatePicker.IsEmptyRadDatePicker.EnableTypingRadDatePicker.ShowPopupOnFocusRadDatePicker.MinDateRadDatePicker.MaxDateRadDatePicker.SharedCalendarIDRadDatePicker.SharedCalendarRadDatePicker.FocusedDateRadDatePicker.RenderModeRadDatePicker.WidthRadDatePicker.ShowAnimationRadDatePicker.HideAnimationRadDatePicker.EnableAriaSupportRadDatePicker.ClientEventsRadDatePicker.OverlayRadDatePicker.ControlIdRadDatePicker.ChildrenCreatedRadDatePicker.SelectedDateChangedWebControl.ApplyStyle(Style)WebControl.CopyBaseAttributes(WebControl)WebControl.CreateControlStyle()WebControl.LoadViewState(object)WebControl.TrackViewState()WebControl.MergeStyle(Style)WebControl.RenderBeginTag(HtmlTextWriter)WebControl.RenderEndTag(HtmlTextWriter)WebControl.SaveViewState()WebControl.AccessKeyWebControl.AttributesWebControl.BackColorWebControl.BorderColorWebControl.BorderWidthWebControl.BorderStyleWebControl.ControlStyleWebControl.ControlStyleCreatedWebControl.CssClassWebControl.DisabledCssClassWebControl.StyleWebControl.EnableThemingWebControl.FontWebControl.ForeColorWebControl.HasAttributesWebControl.HeightWebControl.IsEnabledWebControl.SupportsDisabledAttributeWebControl.SkinIDWebControl.TagNameWebControl.ToolTipControl.ResolveAdapter()Control.HasEvents()Control.GetRouteUrl(object)Control.GetRouteUrl(string, object)Control.GetRouteUrl(RouteValueDictionary)Control.GetRouteUrl(string, RouteValueDictionary)Control.GetUniqueIDRelativeTo(Control)Control.ApplyStyleSheetSkin(Page)Control.OnDataBinding(EventArgs)Control.DataBind()Control.DataBind(bool)Control.DataBindChildren()Control.AddParsedSubObject(object)Control.EnsureID()Control.ClearChildState()Control.ClearChildControlState()Control.ClearChildViewState()Control.ClearEffectiveClientIDMode()Control.ClearCachedClientID()Control.LoadControlState(object)Control.MapPathSecure(string)Control.OpenFile(string)Control.OnLoad(EventArgs)Control.BuildProfileTree(string, bool)Control.SaveControlState()Control.RenderControl(HtmlTextWriter)Control.RenderControl(HtmlTextWriter, ControlAdapter)Control.OnUnload(EventArgs)Control.Dispose()Control.RaiseBubbleEvent(object, EventArgs)Control.OnBubbleEvent(object, EventArgs)Control.AddedControl(Control, int)Control.CreateControlCollection()Control.ResolveUrl(string)Control.ResolveClientUrl(string)Control.FindControl(string)Control.FindControl(string, int)Control.GetDesignModeState()Control.HasControls()Control.IsLiteralContent()Control.EnsureChildControls()Control.RemovedControl(Control)Control.SetDesignModeState(IDictionary)Control.SetRenderMethodDelegate(RenderMethod)Control.ClientIDModeControl.ClientIDControl.ClientIDSeparatorControl.ContextControl.AdapterControl.DesignModeControl.EventsControl.IDControl.IsChildControlStateClearedControl.EnableViewStateControl.ViewStateModeControl.IsViewStateEnabledControl.NamingContainerControl.IdSeparatorControl.LoadViewStateByIDControl.PageControl.RenderingCompatibilityControl.TemplateControlControl.ParentControl.TemplateSourceDirectoryControl.AppRelativeTemplateSourceDirectoryControl.SiteControl.VisibleControl.UniqueIDControl.HasChildViewStateControl.ControlsControl.ValidateRequestModeControl.ViewStateControl.ViewStateIgnoresCaseControl.ChildControlsCreatedControl.IsTrackingViewStateControl.DisposedControl.DataBindingControl.InitControl.LoadControl.PreRenderControl.Unloadobject.ToString()object.Equals(object)object.Equals(object, object)object.ReferenceEquals(object, object)object.GetHashCode()object.GetType()object.MemberwiseClone()...

Constructors

RadTimePicker()

public RadTimePicker()

Properties

AutoPostBack

bool

Gets or sets a value indicating whether a postback to the server automatically occurs when the user interacts with the control.

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

Property Value:

The default value is false.

Overrides: RadDateTimePicker.AutoPostBack

Setting this property to true will make RadTimePicker postback to the server on time selection through the TimeView or the DateInput components.

AutoPostBackControl

Gets or sets a value indicating whether a postback to the server automatically occurs when the user changes the list selection.

[Browsable(false)]
public override AutoPostBackControl AutoPostBackControl { get; set; }

Property Value:

The default value is None

Overrides: RadDateTimePicker.AutoPostBackControl

Set this to Both, TimeView or Calendar if the server needs to capture the selection changed event.

This property is effective only for RadDateTimePicker; for RadTimePicker use the AutoPostBack property.

CssClassFormatString

string

The CssClass property will now be used instead of the former Skin and will be modified in AddAttributesToRender()

protected override string CssClassFormatString { get; }

Overrides: RadDateTimePicker.CssClassFormatString

Example:

protected override string CssClassFormatString
{
       get
       {
           return "RadDock RadDock_{0} rdWTitle rdWFooter";
       }
}

DbSelectedDate

object

Gets or sets the date content of RadTimePicker in a database friendly way.

[Browsable(true)]
[TypeConverter(typeof(DateTimeConverter))]
[Bindable(true, BindingDirection.TwoWay)]
public override object DbSelectedDate { get; set; }

Property Value:

A DateTime object that represents the selected date. The default value is null (Nothing in VB).

Overrides: RadDatePicker.DbSelectedDate

This property behaves similar to SelectedDate property or to SelectedTime property, depending on UseTimeSpanForBinding is se to true or false. Setting a null value will internally revert the SelectedDate to the null value, i.e. the input value will be empty.

Example:

cs-api-definition
private void Page_Load(object sender, System.EventArgs e)
{
RadDatePicker1.DbSelectedDate = tableRow["TimeOfDay"];
//or
RadDatePicker1.DbSelectedDate = tableRow["DateAndTime"];
}
cs-api-definition.skip-repl
Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load
RadDatePicker1.DbSelectedDate = tableRow("TimeOfDay")
'or
RadDatePicker1.DbSelectedDate = tableRow("DateAndTime")
End Sub

EnableKeyboardNavigation

bool

Gets or sets the enable client side navigation with keyboard.

public override bool EnableKeyboardNavigation { get; set; }

Property Value:

The enable client side navigation with keyboard.

Overrides: RadDateTimePicker.EnableKeyboardNavigation

SelectedTime

TimeSpan?

Gets or sets the time of the date in the selected date of RadTimePicker using TimeSpan object. Use values between 00:00:00 and 23:59:59 to specify the time of the day If you set SelectedTime to 'null' then the SelectedDate will also become 'null'.

[Browsable(true)]
public virtual TimeSpan? SelectedTime { get; set; }

UseTimeSpanForBinding

bool

Gets or set if TimeSpan object should be used for returning value of DbSelectedDate. Set to True if you want DbSelectedDate to return TimeSpan object. Set to False(the default value) if you want the DbSelectedDate to return DateTime object.

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

Methods

AddControlComponents(HtmlTextWriter)

protected override void AddControlComponents(HtmlTextWriter writer)

Parameters:writerHtmlTextWriter

Overrides: RadDateTimePicker.AddControlComponents(HtmlTextWriter)

CreateTimeControls()

protected override void CreateTimeControls()

Overrides: RadDateTimePicker.CreateTimeControls()

DescribeProperties(IScriptDescriptor)

protected override void DescribeProperties(IScriptDescriptor descriptor)

Parameters:descriptorIScriptDescriptor

Overrides: RadDateTimePicker.DescribeProperties(IScriptDescriptor)

isOnlyInputRendered()

protected override bool isOnlyInputRendered()

Returns:

bool

Overrides: RadDateTimePicker.isOnlyInputRendered()

RenderChildren(HtmlTextWriter)

protected override void RenderChildren(HtmlTextWriter writer)

Parameters:writerHtmlTextWriter

Overrides: RadDateTimePicker.RenderChildren(HtmlTextWriter)

SetDefaultSize()

protected override void SetDefaultSize()

Overrides: RadDateTimePicker.SetDefaultSize()