Class

RadChartElement

Declaration

public RadChartElement()

Gets or sets the navigation mode for the drill functionality, determining how drill navigation is presented to users.

Declaration

[Browsable(false)]
public DrillNavigationMode DrillNavigationMode { get; set; }

Property Value

Gets the drill navigator RadItem that provides drill-down and drill-up navigation functionality for hierarchical data exploration.

Declaration

[Browsable(false)]
public RadItem DrillNavigator { get; }

Property Value

Gets or sets the position of the drill navigation element within the chart layout.

Declaration

public DrillElementPosition DrillPosition { get; set; }

Property Value

Gets the ChartLegendElement that displays series information and provides legend functionality for the chart.

Declaration

public ChartLegendElement LegendElement { get; }

Property Value

Gets or sets the legend items layout type. The possible values are Stack and Wrap.

Declaration

public LegendItemsLayout LegendItemsLayout { get; set; }

Property Value

Gets or sets the orientation of legend items within the legend element, determining whether items are arranged horizontally or vertically.

Declaration

public Orientation LegendItemsOrientation { get; set; }

Property Value

Gets or sets the offset position of the legend element when LegendPosition is set to Float.

Declaration

public Point LegendOffset { get; set; }

Property Value

Gets or sets the docking position of the legend element relative to the chart area or allows it to float at a custom position.

Declaration

public LegendPosition LegendPosition { get; set; }

Property Value

Gets or sets the title text displayed at the top of the legend element.

Declaration

public string LegendTitle { get; set; }

Property Value

Gets or sets a value indicating whether the drill navigation element is visible and available for user interaction.

Declaration

public bool ShowDrillNavigation { get; set; }

Property Value

Gets or sets a value indicating whether the chart legend is visible and displayed to show series information and data point descriptions.

Declaration

public bool ShowLegend { get; set; }

Property Value

Gets or sets a value indicating whether the chart title element is visible and displayed above or beside the chart area.

Declaration

public bool ShowTitle { get; set; }

Property Value

Gets the ChartTitleElement that represents the visual title component of the chart.

Declaration

public ChartTitleElement TitleElement { get; }

Property Value

Gets or sets the docking position of the chart title element relative to the chart area.

Declaration

public TitlePosition TitlePosition { get; set; }

Property Value

Gets the primary ChartView that contains the chart area, series, and axes for data visualization.

Declaration

public ChartView View { get; }

Property Value

Gets the collection of ChartView objects available for drill-down navigation and multi-view scenarios.

Declaration

[Browsable(false)]
public ChartViewCollection Views { get; }

Property Value

Gets the ChartWrapper that encapsulates the chart view and handles chart rendering and interaction functionality.

Declaration

[Browsable(false)]
public ChartWrapper Wrapper { get; }

Property Value

Arranges the child elements within the available space and handles special positioning for floating legend elements.

Declaration

protected override SizeF ArrangeOverride(SizeF finalSize)

Parameters

Returns

Overrides LightVisualElement.ArrangeOverride(SizeF)

Creates and returns the chart legend element that displays series information and data point descriptions.

Declaration

protected virtual ChartLegendElement CreateChartLegendElement()

Returns

Creates and returns the chart title element that displays the chart title text.

Declaration

protected virtual ChartTitleElement CreateChartTitleElement()

Returns

Creates and returns the chart wrapper element that contains and manages the chart view and handles chart rendering.

Declaration

protected virtual ChartWrapper CreateChartWrapperElement()

Returns

Creates and initializes the child elements including the dock layout panel, title element, chart wrapper, legend element, and drill navigation components.

Declaration

protected override void CreateChildElements()

Overrides RadElement.CreateChildElements()

Creates and returns the dock layout panel that arranges the chart components including title, legend, and chart area.

Declaration

protected virtual DockLayoutPanel CreateDockLayoutElement()

Returns

Creates and returns the drill navigation container element that provides drill-down and drill-up functionality.

Declaration

protected virtual RadItem CreateDrillButtonsContainer()

Returns

Initiates a drill-down operation to navigate to a more detailed view based on the specified data point.

Declaration

public virtual bool DrillDown(DataPoint point)

Parameters

Returns

Navigates directly to a specific chart view by its index in the view collection.

Declaration

public virtual bool DrillToIndex(int viewIndex)

Parameters

Returns

Navigates to the top-level chart view, returning to the root of the drill navigation hierarchy.

Declaration

public virtual bool DrillToTop()

Returns

Initiates a drill-up operation to navigate back to the previous chart view level.

Declaration

public virtual bool DrillUp()

Returns

Determines and returns the appropriate dock position for the legend element based on the current LegendPosition.

Declaration

protected virtual Dock GetLegendDockPosition()

Returns

Returns an enumerable collection of direct stylable child objects, including the chart view and immediate child elements.

Declaration

protected override IEnumerable<RadObject> GetStylableChildren()

Returns

Overrides RadElement.GetStylableChildren()

Returns an enumerable collection of all stylable child objects in the entire hierarchy, including the chart view and all nested child elements.

Declaration

protected override IEnumerable<RadObject> GetStylableChildrenHierarchy()

Returns

Overrides RadElement.GetStylableChildrenHierarchy()

Determines and returns the appropriate dock position for the title element based on the current TitlePosition.

Declaration

protected virtual Dock GetTitleDockPosition()

Returns

Initializes member fields to their default values. This method is called prior the CreateChildItems one and allows for initialization of members on which child elements depend.

Declaration

protected override void InitializeFields()

Overrides LightVisualElement.InitializeFields()

Processes gesture events and routes them to the appropriate gesture handler based on the gesture type.

Declaration

protected override void OnGesture(GestureEventArgs args)

Parameters

Overrides RadItem.OnGesture(GestureEventArgs)

Raises the KeyDown event and forwards it to the chart wrapper for processing.

Declaration

protected override void OnKeyDown(KeyEventArgs e)

Parameters

Overrides RadItem.OnKeyDown(KeyEventArgs)

Raises the KeyPress event and forwards it to the chart wrapper for processing.

Declaration

protected override void OnKeyPress(KeyPressEventArgs e)

Parameters

Overrides RadItem.OnKeyPress(KeyPressEventArgs)

Raises the KeyUp event and forwards it to the chart wrapper for processing.

Declaration

protected override void OnKeyUp(KeyEventArgs e)

Parameters

Overrides RadItem.OnKeyUp(KeyEventArgs)

Raises the event.

Declaration

protected override void OnMouseDown(MouseEventArgs e)

Parameters

Overrides RadItem.OnMouseDown(MouseEventArgs)

Raises the event.

Declaration

protected override void OnMouseEnter(EventArgs e)

Parameters

Overrides RadElement.OnMouseEnter(EventArgs)

Raises the event.

Declaration

protected override void OnMouseHover(EventArgs e)

Parameters

Overrides RadElement.OnMouseHover(EventArgs)

Raises the event.

Declaration

protected override void OnMouseLeave(EventArgs e)

Parameters

Overrides RadItem.OnMouseLeave(EventArgs)

Raises the event.

Declaration

protected override void OnMouseMove(MouseEventArgs e)

Parameters

Overrides LightVisualElement.OnMouseMove(MouseEventArgs)

Raises the event.

Declaration

protected override void OnMouseUp(MouseEventArgs e)

Parameters

Overrides RadItem.OnMouseUp(MouseEventArgs)

Raises the MouseWheel event and forwards it to the chart wrapper for processing.

Declaration

protected override void OnMouseWheel(MouseEventArgs e)

Parameters

Overrides RadElement.OnMouseWheel(MouseEventArgs)

Processes pan gesture events and forwards them to the chart wrapper for handling chart panning operations.

Declaration

protected override void OnPanGesture(PanGestureEventArgs args)

Parameters

Overrides RadItem.OnPanGesture(PanGestureEventArgs)

Processes press and tap gesture events and forwards them to the chart wrapper for handling advanced touch interactions.

Declaration

protected override void OnPressAndTapGesture(PressAndTapGestureEventArgs args)

Parameters

Overrides RadItem.OnPressAndTapGesture(PressAndTapGestureEventArgs)

Handles render size change events and raises the RenderSizeChanged event when the chart element's size changes.

Declaration

protected override void OnRenderSizeChanged(SizeChangedInfo info)

Parameters

Overrides RadElement.OnRenderSizeChanged(SizeChangedInfo)

Processes rotate gesture events and forwards them to the chart wrapper for handling chart rotation operations.

Declaration

protected override void OnRotateGesture(RotateGestureEventArgs args)

Parameters

Overrides RadItem.OnRotateGesture(RotateGestureEventArgs)

Processes two-finger tap gesture events and forwards them to the chart wrapper for handling multi-touch interactions.

Declaration

protected override void OnTwoFingerTapGesture(GestureEventArgs args)

Parameters

Overrides RadItem.OnTwoFingerTapGesture(GestureEventArgs)

Processes zoom gesture events and forwards them to the chart wrapper for handling chart zooming operations.

Declaration

protected override void OnZoomGesture(ZoomGestureEventArgs args)

Parameters

Overrides RadItem.OnZoomGesture(ZoomGestureEventArgs)

Paints the chart element by drawing the chart view content to the provided graphics surface.

Declaration

protected override void PaintElement(IGraphics graphics, float angle, SizeF scale)

Parameters

Overrides LightVisualElement.PaintElement(IGraphics, float, SizeF)

Sets the docking position of the legend element based on the specified LegendPosition.

Declaration

protected virtual void SetLegendDock(LegendPosition position)

Parameters

Sets the docking position of the title element based on the specified TitlePosition.

Declaration

protected virtual void SetTitleDock(TitlePosition position)

Parameters

Determines whether the chart element should fallback to the default theme when no custom theme is applied.

Declaration

protected override bool ShouldFallbackToDefaultTheme()

Returns

Overrides RadItem.ShouldFallbackToDefaultTheme()

Occurs when the chart context menu is about to open, allowing customization of menu items and behavior.

Declaration

public event ChartViewContextMenuOpeningEventHandler ContextMenuOpening

Event Value

Occurs when a new DataPoint is created, allowing customization of data point properties and behavior.

Declaration

public event ChartViewCreatePointEventHandler CreatePoint

Event Value

Occurs when a new DataPointElement is created for visual representation of data points, allowing customization of point element properties.

Declaration

public event ChartViewCreatePointElementEventHandler CreatePointElement

Event Value

Occurs when the chart area requires a custom renderer to be created for the first time during chart initialization.

Declaration

public event ChartViewCreateRendererEventHandler CreateRenderer

Event Value

Occurs when the current view index changes during drill navigation operations.

Declaration

public event EventHandler CurrentViewIndexChanged

Event Value

Occurs when a drill operation is initiated, allowing navigation between different chart views or data levels.

Declaration

public event DrillEventHandler Drill

Event Value

Occurs when a data point label needs to be formatted before display, allowing customization of label content and appearance.

Declaration

public event ChartViewLabelFormattingEventHandler LabelFormatting

Event Value

Occurs when the chart element's render size changes, typically during resize operations.

Declaration

public event EventHandler RenderSizeChanged

Event Value