Skip to main content

SchedulerOptionsRangeControl.AutoAdjustMode Property

Gets or sets a value indicating if the RangeControl should be automatically adjusted after the scheduler visible interval or active view has been changed.

Namespace: DevExpress.XtraScheduler

Assembly: DevExpress.XtraScheduler.v24.1.dll

NuGet Package: DevExpress.Win.Scheduler

Declaration

[DefaultValue(true)]
public bool AutoAdjustMode { get; set; }

Property Value

Type Default Description
Boolean true

true if the RangeControl is automatically adjusted ; otherwise, false.

Property Paths

You can access this nested property as listed below:

Object Type Path to AutoAdjustMode
SchedulerControl
.OptionsRangeControl .AutoAdjustMode

Remarks

If the AutoAdjustMode option is switched in, the RangeControl will be automatically adjusted in the following way:

  • After the SchedulerControl.ActiveView property value has been changed, the RangeControl visible scales (ScaleBasedRangeControlClientOptions.Scales) will be automatically switched to the scales are the best for using within RangeControl for navigating within the newly set scheduler view.

    Scheduler View RangeControl scales
    Day View, Work-Week View The Day and Week scales
    Week View, Month View The Week and Month scales
    Timeline View, Gantt View Scales that are currently visible in the scheduler view

    Note

    To automatically switch a scheduler view to the most appropriate view for displaying the time range that is currently selected in the RangeControl, set the SchedulerOptionsRangeControl.AllowChangeActiveView property.

  • When the SchedulerControl.Start date is switched to a date that is beyond the RangeControl’s available time range (ScaleBasedRangeControlClientOptions.RangeMinimum, ScaleBasedRangeControlClientOptions.RangeMaximum), this range’s boundaries will be automatically recalculated so that this date will be in the middle of the newly set time range available in the RangeControl. The scheduler active view is also taken into account when recalculating the RangeControl available range.

    Scheduler View

    RangeControl Total Range

    Day View, Work-Week View

    Range Minimum = the start of the scheduler visible interval - 1 month

    Range Maximum = the start of the scheduler visible interval + 1 month

    Week View

    Range Minimum = the first day of the month visible in the scheduler - 3 months

    Range Maximum = the first day of the month visible in the scheduler + 3 months

    Month View

    Range Minimum = the first day of the month visible in the scheduler - 6 months

    Range Maximum = the first day of the month visible in the scheduler + 6 months

    Timeline View, Gantt View

    Range Minimum = the start of the scheduler visible interval - twice the duration of the scheduler visible interval

    Range Maximum = the start of the scheduler visible interval + twice the duration of the scheduler visible interval

Handle the SchedulerControl.RangeControlAutoAdjusting event for customization settings to be applied when the AutoAdjustMode property is set to true.

See Also