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

Declaration

C#

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

VB.NET

<DefaultValue(True)>
Public Property AutoAdjustMode As Boolean

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.