TimeIntervalCollectionEx Class

Represents an advanced collection of time intervals.

Namespace: DevExpress.XtraScheduler

Assembly: DevExpress.XtraScheduler.v18.1.Core.dll

Declaration

C#

public class TimeIntervalCollectionEx :
    TimeIntervalCollection

VB.NET

Public Class TimeIntervalCollectionEx
    Inherits TimeIntervalCollection

Related API Members

The following members accept/return TimeIntervalCollectionEx objects:

• IntervalFoundEventArgs.FreeIntervals

Remarks

The TimeIntervalCollectionEx represents a collection of TimeInterval objects. The properties and methods declared by this class can be used to perform common collection operations, such as adding new or deleting existing items. Individual items can be accessed using indexer notation.

The TimeIntervalCollectionEx class provides advanced functionality compared with its immediate ancestor TimeIntervalCollection. When adding a new time interval, this collection allows intersecting time intervals to be joined and represented within the collection as a single time interval item. So, the collection always contains a minimal number of items. In the same manner, removing a time interval intersecting an existing time interval item results in the item being cut off, or divided into two items.

The following pictures illustrate how time intervals are added to the TimeIntervalCollectionEx and removed from it.

 

Add method. The original interval is merged with the one specified, resulting in one collection item.

 

Remove method. The specified interval is subtracted form the original, resulting in two separate intervals, so that two collection items appear.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the TimeIntervalCollectionEx class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-find-free-time-intervals-for-a-meeting-arrangement-e508/CS/FreeTimeIntervals/Form1.cs#L55

private void OnIntervalFound(object sender, IntervalFoundEventArgs args) {
    TimeIntervalCollectionEx freeIntervals = args.FreeIntervals;
    DateTime start = freeIntervals.Start.Date.AddDays(-1);

drag-n-drop-and-ical-import-import-of-the-ical-file-being-dropped-on-xtrascheduler-e1463/CS/Drag_iCalFromFile/Form1.cs#L21

// Time intervals of events in a calendar file.
TimeIntervalCollectionEx timeCollectionEx = new TimeIntervalCollectionEx();

VB.NET

how-to-find-free-time-intervals-for-a-meeting-arrangement-e508/VB/FreeTimeIntervals/Form1.vb#L68

Private Sub OnIntervalFound(ByVal sender As Object, ByVal args As IntervalFoundEventArgs)
    Dim freeIntervals As TimeIntervalCollectionEx = args.FreeIntervals
    Dim start As Date = freeIntervals.Start.Date.AddDays(-1)

drag-n-drop-and-ical-import-import-of-the-ical-file-being-dropped-on-xtrascheduler-e1463/VB/Drag_iCalFromFile/Form1.vb#L21

' Time intervals of events in a calendar file.
Private timeCollectionEx As New TimeIntervalCollectionEx()

Inheritance

Object

DXCollectionBase<TimeInterval>

DXCollection<TimeInterval>

NotificationCollection<TimeInterval>

DevExpress.XtraScheduler.SchedulerCollectionBase<TimeInterval>

TimeIntervalCollection

TimeIntervalCollectionEx