Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Expand]Controls and Libraries
 [Expand]Common Features
  Get More Help
 [Collapse]API Reference
  [Expand]DevExpress.DataAccess.UI.Design
  [Expand]DevExpress.DataAccess.UI.EntityFramework
  [Expand]DevExpress.DataAccess.UI.Excel
  [Expand]DevExpress.DataAccess.UI.Localization
  [Expand]DevExpress.DataAccess.UI.ObjectBinding
  [Expand]DevExpress.DataAccess.UI.Sql
  [Expand]DevExpress.DataAccess.UI.Wizard
  [Expand]DevExpress.DataAccess.UI.Wizard.Services
  [Expand]DevExpress.DataAccess.UI.Wizard.Views
  [Expand]DevExpress.DocumentView
  [Expand]DevExpress.DocumentView.Controls
  [Expand]DevExpress.LookAndFeel
  [Expand]DevExpress.LookAndFeel.Helpers
  [Expand]DevExpress.Skins
  [Expand]DevExpress.Snap
  [Expand]DevExpress.Snap.API.Native
  [Expand]DevExpress.Snap.Core
  [Expand]DevExpress.Snap.Core.API
  [Expand]DevExpress.Snap.Core.Fields
  [Expand]DevExpress.Snap.Core.Forms
  [Expand]DevExpress.Snap.Core.Options
  [Expand]DevExpress.Snap.Core.Services
  [Expand]DevExpress.Snap.Extensions
  [Expand]DevExpress.Snap.Extensions.Localization
  [Expand]DevExpress.Snap.Localization
  [Expand]DevExpress.Snap.Options
  [Expand]DevExpress.Snap.Services
  [Expand]DevExpress.Utils
  [Expand]DevExpress.Utils.Animation
  [Expand]DevExpress.Utils.Controls
  [Expand]DevExpress.Utils.Drawing
  [Expand]DevExpress.Utils.Menu
  [Expand]DevExpress.Utils.Taskbar
  [Expand]DevExpress.Utils.Taskbar.Core
  [Expand]DevExpress.Utils.UI.Localization
  [Expand]DevExpress.Utils.VisualEffects
  [Expand]DevExpress.Utils.Win
  [Expand]DevExpress.XtraBars
  [Expand]DevExpress.XtraBars.Alerter
  [Expand]DevExpress.XtraBars.Docking
  [Expand]DevExpress.XtraBars.Docking2010
  [Expand]DevExpress.XtraBars.Docking2010.Customization
  [Expand]DevExpress.XtraBars.Docking2010.Views
  [Expand]DevExpress.XtraBars.Docking2010.Views.NativeMdi
  [Expand]DevExpress.XtraBars.Docking2010.Views.Tabbed
  [Expand]DevExpress.XtraBars.Docking2010.Views.Widget
  [Expand]DevExpress.XtraBars.Docking2010.Views.WindowsUI
  [Expand]DevExpress.XtraBars.Localization
  [Expand]DevExpress.XtraBars.Navigation
  [Expand]DevExpress.XtraBars.Ribbon
  [Expand]DevExpress.XtraBars.Ribbon.Gallery
  [Expand]DevExpress.XtraBars.Ribbon.ViewInfo
  [Expand]DevExpress.XtraBars.ToastNotifications
  [Expand]DevExpress.XtraBars.Utils
  [Expand]DevExpress.XtraBars.WinRTLiveTiles
  [Expand]DevExpress.XtraCharts
  [Expand]DevExpress.XtraCharts.Designer
  [Expand]DevExpress.XtraCharts.Wizard
  [Expand]DevExpress.XtraDataLayout
  [Expand]DevExpress.XtraDiagram
  [Expand]DevExpress.XtraDiagram.Options
  [Expand]DevExpress.XtraEditors
  [Expand]DevExpress.XtraEditors.ButtonPanel
  [Expand]DevExpress.XtraEditors.Calendar
  [Expand]DevExpress.XtraEditors.Camera
  [Expand]DevExpress.XtraEditors.Container
  [Expand]DevExpress.XtraEditors.Controls
  [Expand]DevExpress.XtraEditors.CustomEditor
  [Expand]DevExpress.XtraEditors.DXErrorProvider
  [Expand]DevExpress.XtraEditors.Filtering
  [Expand]DevExpress.XtraEditors.Mask
  [Expand]DevExpress.XtraEditors.Persistent
  [Expand]DevExpress.XtraEditors.Repository
  [Expand]DevExpress.XtraEditors.ViewInfo
  [Expand]DevExpress.XtraFilterEditor
  [Expand]DevExpress.XtraGauges.Presets.Styles
  [Expand]DevExpress.XtraGauges.Win
  [Expand]DevExpress.XtraGauges.Win.Base
  [Expand]DevExpress.XtraGauges.Win.Gauges.Circular
  [Expand]DevExpress.XtraGauges.Win.Gauges.Digital
  [Expand]DevExpress.XtraGauges.Win.Gauges.Linear
  [Expand]DevExpress.XtraGauges.Win.Gauges.State
  [Expand]DevExpress.XtraGrid
  [Expand]DevExpress.XtraGrid.Columns
  [Expand]DevExpress.XtraGrid.EditForm
  [Expand]DevExpress.XtraGrid.FilterEditor
  [Expand]DevExpress.XtraGrid.Localization
  [Expand]DevExpress.XtraGrid.Views.BandedGrid
  [Expand]DevExpress.XtraGrid.Views.BandedGrid.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Base
  [Expand]DevExpress.XtraGrid.Views.Base.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Card
  [Expand]DevExpress.XtraGrid.Views.Card.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Grid
  [Expand]DevExpress.XtraGrid.Views.Grid.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Layout
  [Expand]DevExpress.XtraGrid.Views.Layout.Events
  [Expand]DevExpress.XtraGrid.Views.Layout.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Printing
  [Expand]DevExpress.XtraGrid.Views.Tile
  [Expand]DevExpress.XtraGrid.Views.WinExplorer
  [Expand]DevExpress.XtraGrid.WinExplorer
  [Expand]DevExpress.XtraLayout
  [Expand]DevExpress.XtraLayout.Customization
  [Expand]DevExpress.XtraLayout.HitInfo
  [Expand]DevExpress.XtraLayout.Localization
  [Expand]DevExpress.XtraLayout.Utils
  [Expand]DevExpress.XtraMap
  [Expand]DevExpress.XtraMap.Printing
  [Expand]DevExpress.XtraNavBar
  [Expand]DevExpress.XtraNavBar.ViewInfo
  [Expand]DevExpress.XtraPdfViewer
  [Expand]DevExpress.XtraPdfViewer.Commands
  [Expand]DevExpress.XtraPdfViewer.Localization
  [Expand]DevExpress.XtraPivotGrid
  [Expand]DevExpress.XtraPivotGrid.Data
  [Expand]DevExpress.XtraPrinting
  [Expand]DevExpress.XtraPrinting.Control
  [Expand]DevExpress.XtraPrinting.Preview
  [Expand]DevExpress.XtraPrintingLinks
  [Expand]DevExpress.XtraReports.UI
  [Expand]DevExpress.XtraRichEdit
  [Expand]DevExpress.XtraRichEdit.Commands
  [Expand]DevExpress.XtraRichEdit.Export
  [Expand]DevExpress.XtraRichEdit.Import
  [Expand]DevExpress.XtraRichEdit.Localization
  [Expand]DevExpress.XtraRichEdit.Menu
  [Collapse]DevExpress.XtraScheduler
   [Expand]ActiveViewChangingEventArgs Class
    ActiveViewChangingEventHandler Delegate
   [Expand]AgendaView Class
   [Expand]AgendaViewAppearance Class
   [Expand]AppointmentDependencyFormEventArgs Class
    AppointmentDependencyFormEventHandler Delegate
   [Expand]AppointmentDependencyStorage Class
   [Expand]AppointmentDragDropOptions Class
   [Expand]AppointmentFormEventArgs Class
    AppointmentFormEventHandler Delegate
   [Expand]AppointmentImagesEventArgs Class
    AppointmentImagesEventHandler Delegate
   [Expand]AppointmentLabel Class
   [Expand]AppointmentLabelCollection Class
   [Expand]AppointmentLabelExtension Class
   [Expand]AppointmentStatus Class
   [Expand]AppointmentStatusCollection Class
   [Expand]AppointmentStatusExtension Class
   [Expand]AppointmentStorage Class
   [Expand]AppointmentViewInfoCustomizingEventArgs Class
    AppointmentViewInfoCustomizingEventHandler Delegate
   [Expand]BaseHeaderAppearance Class
   [Expand]BaseViewAppearance Class
   [Expand]CustomDrawAppointmentFlyoutSubjectEventArgs Class
    CustomDrawAppointmentFlyoutSubjectEventHandler Delegate
   [Expand]CustomDrawObjectEventArgs Class
    CustomDrawObjectEventHandler Delegate
   [Expand]CustomizeAppointmentFlyoutEventArgs Class
    CustomizeAppointmentFlyoutEventHandler Delegate
   [Expand]CustomizeDateNavigationBarCaptionEventArgs Class
    DateNavigationMode Enumeration
   [Expand]DateNavigator Class
   [Expand]DayView Class
   [Expand]DayViewAppearance Class
   [Expand]DayViewAppointmentDisplayOptionsEx Class
   [Expand]DeleteRecurrentAppointmentFormEventArgs Class
    DeleteRecurrentAppointmentFormEventHandler Delegate
    DragDropMode Enumeration
   [Expand]EditRecurrentAppointmentFormEventArgs Class
    EditRecurrentAppointmentFormEventHandler Delegate
   [Expand]FullWeekView Class
   [Expand]GanttView Class
   [Expand]GanttViewAppearance Class
   [Expand]GotoDateFormEventArgs Class
    GotoDateFormEventHandler Delegate
   [Expand]IAppointmentStorage Interface
   [Expand]InplaceEditorEventArgs Class
    InplaceEditorEventHandler Delegate
   [Expand]ISchedulerInplaceEditor Interface
   [Expand]ISchedulerStorage Interface
    LayoutElementKind Enumeration
   [Expand]LayoutViewInfoCustomizingEventArgs Class
   [Expand]MonthView Class
   [Expand]MonthViewAppearance Class
   [Expand]MonthViewAppointmentDisplayOptionsEx Class
   [Expand]PopupMenuShowingEventArgs Class
    PopupMenuShowingEventHandler Delegate
   [Expand]PrepareContextMenuEventArgs Class
    PrepareContextMenuEventHandler Delegate
   [Expand]PrepareFilterColumnEventArgs Class
    PrepareFilterColumnEventHandler Delegate
   [Expand]PreparePopupMenuEventArgs Class
    PreparePopupMenuEventHandler Delegate
   [Expand]RecurrentAppointmentActionFormEventArgs Class
   [Expand]RemindersFormEventArgs Class
    RemindersFormEventHandler Delegate
   [Expand]ResourceExtension Class
   [Expand]ResourceNavigator Class
   [Expand]ResourceStorage Class
   [Collapse]ScaleBasedRangeControlClientOptions Class
     ScaleBasedRangeControlClientOptions Members
     ScaleBasedRangeControlClientOptions Constructor
    [Collapse]ScaleBasedRangeControlClientOptions Properties
      AutoFormatScaleCaptions Property
      DataDisplayType Property
      MaxIntervalWidth Property
      MaxSelectedIntervalCount Property
      MinIntervalWidth Property
      RangeMaximum Property
      RangeMinimum Property
      Scales Property
      ThumbnailHeight Property
   [Expand]SchedulerAppearance Class
    SchedulerColorId Enumeration
   [Expand]SchedulerColorSchema Class
   [Expand]SchedulerColorSchemaCollection Class
   [Expand]SchedulerControl Class
   [Expand]SchedulerDateNavigationBar Class
   [Expand]SchedulerDeferredScrollingOption Class
   [Expand]SchedulerInplaceEditorEventArgs Class
   [Expand]SchedulerMenuCheckItem Class
   [Expand]SchedulerMenuItem Class
   [Expand]SchedulerOptionsBehavior Class
   [Expand]SchedulerOptionsPrint Class
   [Expand]SchedulerOptionsRangeControl Class
   [Expand]SchedulerOptionsView Class
   [Expand]SchedulerPopupMenu Class
   [Expand]SchedulerResourceHeaderOptions Class
   [Expand]SchedulerStorage Class
   [Expand]SchedulerViewBase Class
   [Expand]SchedulerViewRepository Class
    SchedulerViewStatusDisplayType Enumeration
   [Expand]ShowFormEventArgs Class
   [Expand]TimeIndicatorDisplayOptions Class
   [Expand]TimelineView Class
   [Expand]TimelineViewAppearance Class
   [Expand]TimelineViewAppointmentDisplayOptionsEx Class
   [Expand]WeekView Class
   [Expand]WeekViewAppearance Class
   [Expand]WeekViewAppointmentDisplayOptionsEx Class
   [Expand]WorkWeekView Class
   [Expand]WorkWeekViewAppearance Class
  [Expand]DevExpress.XtraScheduler.Drawing
  [Expand]DevExpress.XtraScheduler.Printing
  [Expand]DevExpress.XtraScheduler.Reporting
  [Expand]DevExpress.XtraScheduler.Reporting.UI
  [Expand]DevExpress.XtraScheduler.Services
  [Expand]DevExpress.XtraScheduler.Services.Implementation
  [Expand]DevExpress.XtraScheduler.UI
  [Expand]DevExpress.XtraSpellChecker
  [Expand]DevExpress.XtraSpellChecker.Localization
  [Expand]DevExpress.XtraSplashForm
  [Expand]DevExpress.XtraSplashScreen
  [Expand]DevExpress.XtraSpreadsheet
  [Expand]DevExpress.XtraSpreadsheet.Services
  [Expand]DevExpress.XtraTab
  [Expand]DevExpress.XtraTab.Buttons
  [Expand]DevExpress.XtraTab.ViewInfo
  [Expand]DevExpress.XtraTabbedMdi
  [Expand]DevExpress.XtraToolbox
  [Expand]DevExpress.XtraTreeList
  [Expand]DevExpress.XtraTreeList.Columns
  [Expand]DevExpress.XtraTreeList.Data
  [Expand]DevExpress.XtraTreeList.Localization
  [Expand]DevExpress.XtraTreeList.Menu
  [Expand]DevExpress.XtraTreeList.Nodes
  [Expand]DevExpress.XtraTreeList.Nodes.Operations
  [Expand]DevExpress.XtraTreeList.StyleFormatConditions
  [Expand]DevExpress.XtraTreeMap
  [Expand]DevExpress.XtraVerticalGrid
  [Expand]DevExpress.XtraVerticalGrid.Events
  [Expand]DevExpress.XtraVerticalGrid.Localization
  [Expand]DevExpress.XtraVerticalGrid.Rows
  [Expand]DevExpress.XtraWaitForm
  [Expand]DevExpress.XtraWizard
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

ScaleBasedRangeControlClientOptions.Scales Property

Provides access to a collection of scales displayed in the RangeControl when it is bound to a SchedulerControl.

Namespace:DevExpress.XtraScheduler
Assembly:DevExpress.XtraScheduler.v17.1.dll

Expanded Syntax

Property value

Type: TimeScaleCollection
A DevExpress.XtraScheduler.TimeScaleCollection object containing scales for a RangeControl.

Expanded Remarks

When a RangeControl is bound to a SchedulerControl, scales are inherent to the RangeControl. They appear as rulers with different time scales at the top of the RangeControl and specify a timeline to be used by end-users for navigating within a SchedulerControl. Clicking a RangeControl's scale header selects the corresponding time interval in the RangeControl and displays it in the SchedulerControl.

Use the Scales property to access the collection of scales and specify the DevExpress.XtraScheduler.TimeScale elements to be displayed within the RangeControl. When selecting scales to be enabled in the RangeControl, take into account the scheduler view and time range that contains appointments through which end-users should navigate. For example, if it is required to manipulate numerous appointments over several months, you can use the Month and Week scales. If end-users need to scroll a scheduler area in more detailed steps, you can enable the Day and Hour scales. To automatically adjust a set of visible scales depending on the scheduler active view, switch on the SchedulerOptionsRangeControl.AutoAdjustMode option.

To display a particular scale in a RangeControl, set the DevExpress.XtraScheduler.TimeScale.Enabled and DevExpress.XtraScheduler.TimeScale.Visible properties to true.

The visual appearance of scale elements can be customized via DevExpress.XtraScheduler.TimeScale.DisplayFormat and DevExpress.XtraScheduler.TimeScale.Width.

Note

If the SchedulerOptionsRangeControl.AutoAdjustMode option is enabled, the settings specified for the TimeScale items of the Scales collection will not be applied. Handle the SchedulerControl.RangeControlAutoAdjusting event to initialize a collection of scales to be displayed with the specified settings.

To apply auto-formats to header captions of RangeControl scales and leave them readable regardless of the scale element width, set the AutoFormatScaleCaptions property to true. When this option is switched on, the format of scale captions will be automatically adjusted after the RangeControl viewport has been resized or zoomed.

The RangeControl is divided into intervals according to the most detailed scale (a scale that has the minimum time interval among enabled scales). Each interval shows information about appointments contained within the corresponding time interval in the scheduler (appointment thumbnails or the number of appointments). Use the MinIntervalWidth property to specify the minimum interval width that can be set by an end-user.

You can implement your own custom scales and add them to the Scales collection.

Expanded See Also

How would you rate this topic?​​​​​​​