Configures selection-based zooming functionality for precise chart area examination and data analysis. Provides comprehensive control over drag-to-zoom behavior including keyboard modifiers, axis locking, and selection responsiveness. Use this component to enable rectangular selection zooming that allows users to precisely define the chart area they want to examine in detail.
Definition
Namespace:Telerik.Blazor.Components
Assembly:Telerik.Blazor.dll
Syntax:
public class ChartZoomableSelection : DataVizChildComponent, IComponent, IHandleEvent, IHandleAfterRender, IDisposableInheritance: objectComponentBaseDataVizChildComponentChartZoomableSelection
Implements:
Inherited Members
Constructors
public ChartZoomableSelection()Methods
protected override void BuildRenderTree(RenderTreeBuilder __builder)Overrides:
protected override void OnInitialized()Overrides:
protected override void OnParametersSet()Overrides:
Properties
[Parameter]
public RenderFragment ChildContent { get; set; }Controls whether selection-based zooming is enabled for precise chart area examination and data analysis. When set to true, users can drag to select a rectangular area and zoom into that specific region for detailed data exploration. Set to false to disable selection zooming while maintaining other zoom methods like mouse wheel zooming. Selection zooming provides precise control over the exact chart area users want to examine for focused data analysis.
[Parameter]
public bool? Enabled { get; set; }Specifies a keyboard key that must be pressed to activate selection-based zooming for controlled user interaction. Use this property to prevent accidental zooming by requiring a modifier key like Ctrl, Shift, or Alt during selection. Key modifiers help distinguish between zooming and other chart interactions like data point selection or tooltips. See ChartZoomableSelectionKey for available keyboard modifiers and their appropriate use cases for different interaction patterns.
[Parameter]
public ChartZoomableSelectionKey? Key { get; set; }Specifies which axis should be locked and excluded from selection-based zooming operations for controlled data exploration. Use this property to restrict selection zooming to specific axes while keeping others fixed for comparative analysis or maintaining context. For example, lock the X-axis to maintain time scale while allowing Y-axis selection zooming, or vice versa for focused analysis. See ChartAxisLock for available axis locking options and their use cases in different chart interaction scenarios.
[Parameter]
public ChartAxisLock? Lock { get; set; }