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