Skip to main content

GanttControl.ZoomMode Property

Gets or sets how the time ruler scale changes: smoothly or by predefined intervals (week, month, quarter, etc.).

Namespace: DevExpress.XtraGantt

Assembly: DevExpress.XtraGantt.v24.1.dll

NuGet Package: DevExpress.Win.Gantt

Declaration

[DefaultValue(GanttZoomMode.Default)]
[DXCategory("Appearance")]
public virtual GanttZoomMode ZoomMode { get; set; }

Property Value

Type Default Description
GanttZoomMode Default

A GanttZoomMode enumeration value that specifies how the time ruler scale changes.

Available values:

Name Description
Default

The actual mode is not explicitly specified. Enables the Smooth mode.

FixedIntervals

Switches to the next measure unit (week, month, quarter, etc.) by each wheel step.

Smooth

First decreases the size of a single division to a certain limit and then switches to the next measure unit (week, month, quarter, etc.).

Remarks

The GanttControl.OptionsMainTimeRuler.Unit property specifies the time interval that corresponds to a single measure unit on the time scale. For example, the time scale can be in hours, days, or months.

image

image

The time scale displays division marks. The GanttControl.OptionsMainTimeRuler.Count property specifies the number of measure units in a single division on the time scale. For example, if the measure unit is an hour, a single division can correspond to one, two, or six hours.

image

image

Users can hold Ctrl and use the mouse wheel to change the measure unit. The GanttControl.ZoomMode property specifies how the scale changes:

  • first decreases the size of a single division to a certain limit and then switches to the next measure unit (week, month, quarter, etc.).
  • switches to the next measure unit by each wheel step

The GanttControl.OptionsMainTimeRuler.MinUnit and GanttControl.OptionsMainTimeRuler.MaxUnit properties specify the minimum and maximum measure units.

You can call the GanttControl.ZoomIn and GanttControl.ZoomOut methods to change the measure unit in code.

See Also