Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

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.2.dll

NuGet Package: DevExpress.Wpf.Scheduler

#Declaration

public TimeSpan AppointmentSearchInterval { get; set; }

#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.

<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>
See Also