SchedulerNavigationButtonOptions.AppointmentSearchInterval Property

Specifies the time span used by Navigation Buttons to search for the nearest appointments (in days), so it is limited to a reasonable range.

Namespace: DevExpress.XtraScheduler

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

Declaration

C#

public TimeSpan AppointmentSearchInterval { get; set; }

VB.NET

Public Property AppointmentSearchInterval As TimeSpan

Property Value

Type	Description
TimeSpan	A System.TimeSpan value, specifying the search range.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to AppointmentSearchInterval
Cross-Platform Class Library	SchedulerOptionsViewBase	.NavigationButtons.AppointmentSearchInterval
WinForms Controls	SchedulerOptionsView	.NavigationButtons.AppointmentSearchInterval
WPF Controls	SchedulerOptionsView	.NavigationButtons.AppointmentSearchInterval
ASP.NET Bootstrap Controls	BootstrapSchedulerOptionsView	.NavigationButtons.AppointmentSearchInterval
ASP.NET Web Forms Controls	ASPxSchedulerOptionsView	.NavigationButtons.AppointmentSearchInterval

Remarks

When Navigation Buttons search for the nearest appointment, the following problem may arise. If the calculation algorithm encounters recurring appointments in the filtered appointment subset, it searches for the end of the recurrence chain. If the appointment doesn’t specify the recurrence end date, the search operation results in an endless loop, which hangs the application.

To solve the problem, you may use the SchedulerControl.LimitInterval property or specify the AppointmentSearchInterval.

The default value for the AppointmentSearchInterval property is 730 days.Therefore, by default, appointments older than 2 years won’t be recognized by Navigation Buttons.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the AppointmentSearchInterval property.

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#

winforms-schedulercontrol-api-t224044/CS/SchedulerAPISample/CodeExamples/CustomDraw.cs#L269

AppointmentBaseCollection apts = scheduler.DataStorage.Appointments.Items;
TimeSpan aptSearchInterval = scheduler.OptionsView.NavigationButtons.AppointmentSearchInterval;
DateTime lastVisibleTime = scheduler.ActiveView.GetVisibleIntervals().Last().End;

VB.NET

winforms-schedulercontrol-api-t224044/VB/SchedulerAPISample/CodeExamples/CustomDraw.vb#L263

Dim apts As AppointmentBaseCollection = scheduler.DataStorage.Appointments.Items
Dim aptSearchInterval As TimeSpan = scheduler.OptionsView.NavigationButtons.AppointmentSearchInterval
Dim lastVisibleTime As Date = scheduler.ActiveView.GetVisibleIntervals().Last().End