NavigationButtonOptions.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.Xpf.Scheduler

Assembly: DevExpress.Xpf.Scheduler.v24.1.dll

NuGet Package: DevExpress.Wpf.Scheduler

Declaration

C#

public TimeSpan AppointmentSearchInterval { get; set; }

VB.NET

Public Property AppointmentSearchInterval As TimeSpan

Property Value

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

Property Paths

You can access this nested property as listed below:

Object Type	Path to AppointmentSearchInterval
OptionsView	.NavigationButtonOptions .AppointmentSearchInterval

Remarks

Important

You are viewing documentation for the legacy WPF Scheduler control. If you’re starting a new project, we strongly recommend that you use a new control declared in the DevExpress.Xpf.Scheduling namespace. If you decide to upgrade an existing project in order to switch to the updated scheduler control, see the Migration Guidelines document.

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 does not specify the recurrence end date, the search operation results in an endless loop, which hangs the application.

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

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

Example

This example demonstrates how to specify the Scheduler control’s presentation, using the SchedulerControl.OptionsView property.

XAML

<dxsch:SchedulerControl.OptionsView>
    <dxsch:OptionsView FirstDayOfWeek="Tuesday" ShowOnlyResourceAppointments="True">
        <dxsch:OptionsView.NavigationButtonOptions>
            <dxsch:NavigationButtonOptions Visibility="Auto" AppointmentSearchInterval="2"/>
        </dxsch:OptionsView.NavigationButtonOptions>
    </dxsch:OptionsView>
</dxsch:SchedulerControl.OptionsView>