Represents the main visual element of the RadRangeSelector control that provides range selection functionality with thumb controls, scale elements, and integration with associated controls for synchronized data visualization.
Gets the RangeSelectorBodyElement that contains the main visual and interactive components
including thumb controls, selection area, and view container for the associated control.
Gets the collection of scale container elements positioned at the bottom (horizontal orientation) or right (vertical orientation).
These scales provide additional visual indicators and value references for the range selection area.
Gets or sets a value indicating whether fast scrolling mode is enabled for improved performance during rapid navigation.
When enabled, scroll operations may defer certain updates to maintain responsiveness during high-frequency interactions.
This is particularly useful for large data sets where continuous updates might impact performance.
Gets or sets the ending value of the selected range as a percentage (0-100).
This value represents the position of the right thumb in horizontal orientation or top thumb in vertical orientation.
Gets or sets the refresh rate for layout operations in milliseconds.
This property controls how frequently layout updates occur during interactive operations,
balancing visual responsiveness with performance requirements.
Gets or sets the minimum allowed length of the selection range as a percentage (3-99).
This constraint prevents users from creating invalid or too-narrow selections that might cause usability issues.
The value affects both programmatic and interactive range modifications.
Gets or sets the orientation of the range selector, determining the layout direction and thumb movement patterns.
Horizontal arranges controls horizontally with left-right thumb movement,
while Vertical arranges controls vertically with up-down thumb movement.
Gets or sets the ending position of the zoom view within the range selector's viewport as a percentage (0-100).
This property controls which portion of the associated control's data is visible in the range selector's background view.
Changes to this value update the corresponding scroll element position.
Gets or sets the starting position of the zoom view within the range selector's viewport as a percentage (0-100).
This property controls which portion of the associated control's data is visible in the range selector's background view.
Changes to this value update the corresponding scroll element position.
Gets the RangeSelectorScrollElement that provides scroll functionality and zoom controls
for navigating through larger data sets within the range selector view.
Gets or sets the position where the scroll view element is displayed within the range selector layout.
TopLeft positions it at the top (horizontal) or left (vertical),
while BottomRight positions it at the bottom (horizontal) or right (vertical).
Gets or sets the ending position of the selection rectangle as a percentage (0-100).
The selection rectangle provides an alternative selection mechanism and represents the larger of the two selection values.
Values are constrained to the 0-100 range for valid percentage representation.
Gets or sets the starting position of the selection rectangle as a percentage (0-100).
The selection rectangle provides an alternative selection mechanism and represents the smaller of the two selection values.
Values are constrained to the 0-100 range for valid percentage representation.
Gets or sets a value indicating whether the range selector's thumb handles and navigation buttons are visible and interactive.
When disabled, users cannot directly manipulate the thumbs to change the selected range, but the range can still be modified programmatically.
This property is useful for display-only scenarios where range selection should be controlled externally.
Gets or sets a value indicating whether the scroll element is visible and functional.
The scroll element allows users to navigate through larger data sets by adjusting the zoom view.
Returns false if no associated element is set or if the associated element does not implement IRangeSelectorElement.
Gets or sets the starting value of the selected range as a percentage (0-100).
This value represents the position of the left thumb in horizontal orientation or bottom thumb in vertical orientation.
Gets the collection of scale container elements positioned at the top (horizontal orientation) or left (vertical orientation).
These scales provide visual indicators and value references for the range selection area.
Gets the calculated total zoom factor that combines the base zoom factor with view zoom settings.
This read-only property represents the effective zoom level applied to the associated element,
taking into account both the ZoomFactor and the current zoom start/end positions.
Returns 1.0 if no associated element implementing IRangeSelectorElement is present.
Gets or sets the update mode that controls when the associated control receives range change notifications.
Immediate provides real-time updates during thumb dragging operations,
while Deferred delays updates until the user completes the range modification.
Gets or sets a zoom factor that affects the visual scaling of the associated control within the range selector view.
Higher values increase the zoom level, making data appear larger within the background view area.
This factor is combined with view zoom settings to calculate the total zoom effect.
Arranges child elements within the final size allocated to the range selector element.
Positions scales, body element, and scroll element according to the current orientation and scroll view position settings.
Creates the child elements that compose the range selector, including the main body element and scroll element.
Establishes the fundamental visual structure by adding core components to the element hierarchy.
Initializes the range selector elements with settings from the associated control and configures scale elements.
This method rebuilds the element hierarchy based on the current associated element, processes scale initialization events, and establishes the proper visual structure for range selection operations.
Initializes the fields of the range selector element by setting stretch behavior for both horizontal and vertical directions.
This ensures the element can properly fill its available space in both dimensions.
Measures the desired size of the range selector element and its children based on the available space and orientation.
Calculates space requirements for scales, body element, and scroll element, arranging them according to the current orientation.
Called when the element is loaded and visible, triggering initialization of child elements.
This ensures that all range selector components are properly configured when the element becomes active.
Handles property change notifications and triggers appropriate updates for orientation, zoom, and range changes.
This method coordinates updates across child elements when critical properties change, ensuring consistent visual state.
Handles property change notifications from the base class and triggers additional processing for specific properties.
Ensures that right-to-left property changes are properly propagated through the notification system.
Raises the ScaleInitializing event with the specified event arguments.
This method is called when a scale element is being initialized, providing access to the scale for customization.
Raises the SelectionChanged event with the specified event arguments.
This method is called when the entire selection range has been successfully changed to notify registered handlers.
Raises the SelectionChanging event with the specified event arguments.
This method is called when the entire selection range is about to change, allowing registered handlers to validate or cancel the change.
Raises the ThumbLeftValueChanged event with the specified event arguments.
This method is called when the left thumb value has been successfully changed to notify registered handlers.
Raises the ThumbLeftValueChanging event with the specified event arguments.
This method is called before the left thumb value changes, allowing registered handlers to validate or cancel the change.
Raises the ThumbRightValueChanged event with the specified event arguments.
This method is called when the right thumb value has been successfully changed to notify registered handlers.
Raises the ThumbRightValueChanging event with the specified event arguments.
This method is called before the right thumb value changes, allowing registered handlers to validate or cancel the change.
Occurs when a scale element is being initialized, providing access to customize scale appearance and behavior.
This cancelable event allows handlers to modify scale properties, change positioning, or prevent specific scales from being displayed.
Occurs when the entire selection range has been successfully changed.
This event is fired after all range modifications are complete and the range selector is in a consistent state.
Occurs when the entire selection range is about to change, providing an opportunity to validate or cancel the modification.
This cancelable event is triggered when both thumbs move simultaneously or when the range is modified programmatically,
allowing for comprehensive range validation before the change is applied.
Occurs when the value of the left thumb has been successfully changed.
This event is fired after the left thumb position update is complete and all related processing has finished.
Occurs when the value of the left thumb is about to change, providing an opportunity to validate or cancel the modification.
This cancelable event allows handlers to implement custom validation logic before the left thumb position is updated.
Occurs when the value of the right thumb has been successfully changed.
This event is fired after the right thumb position update is complete and all related processing has finished.
Occurs when the value of the right thumb is about to change, providing an opportunity to validate or cancel the modification.
This cancelable event allows handlers to implement custom validation logic before the right thumb position is updated.