Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

TimeRange Constructor(TimeSpan,TimeSpan)

Create a new instance of the TimeRange class.
Syntax
'Declaration
 
Public Function New( _
   ByVal startTime As TimeSpan, _
   ByVal endTime As TimeSpan _
)
public TimeRange( 
   TimeSpan startTime,
   TimeSpan endTime
)

Parameters

startTime
The TimeSpan structure which defines the beginning of the time range, inclusively.
endTime
The TimeSpan structure which defines the end of the time range, exclusively. A TimeSpan that coincides exactly with this value is interpreted as outside the range.
Exceptions
ExceptionDescription
System.ExceptionThrown if either parameter is negative, or exceeds a value of 24 hours.
Remarks

The value of the endTime parameter is treated as an exclusive value when a TimeSlot is compared to this instance to determine whether it is within range. For example, if a TimeRange instance is created with a StartTime of 09:00, and an EndTime of 12:00, a TimeSlot whose StartTime is exactly equal to 12:00 is considered to be outside the range defined by that instance.

Example
The following code sample demonstrates how to use the Owner's DateSettings collection to specify working hours and a custom time range appearance for a particular date:

Imports System.Collections.Generic
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinSchedule
Imports System.Diagnostics

        '  Add a new Owner to the Owners collection
        Dim myOwner As Owner = Me.calendarInfo.Owners.Add("myCalendar")

        '  Create an OwnerDateSettings object for the first day of the current month
        Dim dateSettings As OwnerDateSettings = New OwnerDateSettings(New DateTime(DateTime.Today.Year, DateTime.Today.Month, 1))

        '  Designate the day as a workday
        dateSettings.IsWorkDay = DefaultableBoolean.True

        '  Add two sets of working hours, one for 9AM to 12PM,
        '  and another for 1PM to 5PM
        dateSettings.WorkingHours.Add(New TimeRange(TimeSpan.FromHours(9), TimeSpan.FromHours(12)))
        dateSettings.WorkingHours.Add(New TimeRange(TimeSpan.FromHours(13), TimeSpan.FromHours(17)))

        '  Create an appearance to indicate that the office is closed
        Dim officeClosedAppearance As Appearance = New Appearance()
        officeClosedAppearance.BackColor = Color.White
        officeClosedAppearance.BackColor2 = Color.LightGray
        officeClosedAppearance.BackGradientStyle = GradientStyle.Horizontal
        officeClosedAppearance.BorderColor = Color.Transparent

        '  Create TimeRanges for the hours during which the office is closed,
        '  which is 12AM to 6AM, and 8PM to 12AM
        Dim closed1 As TimeRange = New TimeRange(TimeSpan.FromHours(0), TimeSpan.FromHours(6))
        Dim closed2 As TimeRange = New TimeRange(TimeSpan.FromHours(20), TimeSpan.FromHours(24))

        '  Add two TimeRangeAppearance objects, one for each range during which
        '  the office is closed
        dateSettings.TimeRangeAppearances.Add(closed1, officeClosedAppearance)
        dateSettings.TimeRangeAppearances.Add(closed2, officeClosedAppearance)

        '  Add the OwnerDateSettings object to the Owner's DateSettings collection
        myOwner.DateSettings.Add(dateSettings)
using System.Collections.Generic;
using Infragistics.Win;
using Infragistics.Win.UltraWinSchedule;
using System.Diagnostics;

    //  Add a new Owner to the Owners collection
    Owner myOwner = this.calendarInfo.Owners.Add( "myCalendar" );

    //  Create an OwnerDateSettings object for the first day of the current month
    OwnerDateSettings dateSettings = new OwnerDateSettings( new DateTime(DateTime.Today.Year, DateTime.Today.Month, 1) );

    //  Designate the day as a workday
    dateSettings.IsWorkDay = DefaultableBoolean.True;

    //  Add two sets of working hours, one for 9AM to 12PM,
    //  and another for 1PM to 5PM
    dateSettings.WorkingHours.Add( new TimeRange( TimeSpan.FromHours(9), TimeSpan.FromHours(12) ) );
    dateSettings.WorkingHours.Add( new TimeRange( TimeSpan.FromHours(13), TimeSpan.FromHours(17) ) );

    //  Create an appearance to indicate that the office is closed
    Appearance officeClosedAppearance = new Appearance();
    officeClosedAppearance.BackColor = Color.White;
    officeClosedAppearance.BackColor2 = Color.LightGray;
    officeClosedAppearance.BackGradientStyle = GradientStyle.Horizontal;
    officeClosedAppearance.BorderColor = Color.Transparent;

    //  Create TimeRanges for the hours during which the office is closed,
    //  which is 12AM to 6AM, and 8PM to 12AM
    TimeRange closed1 = new TimeRange( TimeSpan.FromHours(0), TimeSpan.FromHours(6) );
    TimeRange closed2 = new TimeRange( TimeSpan.FromHours(20), TimeSpan.FromHours(24) );

    //  Add two TimeRangeAppearance objects, one for each range during which
    //  the office is closed
    dateSettings.TimeRangeAppearances.Add( closed1, officeClosedAppearance );
    dateSettings.TimeRangeAppearances.Add( closed2, officeClosedAppearance );

    //  Add the OwnerDateSettings object to the Owner's DateSettings collection
    myOwner.DateSettings.Add( dateSettings );
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also