Skip to main content
All docs
V25.1
  • 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.v25.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