XY Line Chart

Top  Previous  Next

An XY line chart simply connects each (X, Y) data item using straight lines.

gb_component_chart_line_xy

The line chart is based on XY Plot and XY Line Renderer. It inherits all their properties.

This is what XY line chart looks like:

ls_widgets_charts_line_xy

XY line chart supports four renderers:

Line Renderer

A renderer that displays items by drawing a line between each (x, y) point and overlaying a shape at each (x, y) point.

ls_widgets_charts_line_xy_line

Line 3D Renderer

A line renderer that uses a "pseudo-3D" effect to draw line charts.

ls_widgets_charts_line_xy_line_3d

Spline Renderer

This renderer connects data points using spline curves. This results in a smooth line passing through all the data points.

ls_widgets_charts_line_xy_spline

Step Renderer

This renderer draws items using "stepped" lines to connect each (x, y) point.

ls_widgets_charts_line_xy_step

Dataset

The XY line chart supports several data models:

Custom Data
Event-based Data
Variable-based Data

It has the following Source Data Bindings:

Binding

Expected Value Type

Description

Series

String

Textual name of the data series. Data series is represented by a single line (or set of shapes) on the chart.

X

Number

Numeric value to display along the domain (X) axis.

Y

Number

Numeric value to display along the range (Y) axis.

Common Properties

Width, Height, Bindings, Visible, Background, Border

All Common Chart Properties.

All Data-related properties.

All properties of a XY Plot.

All properties of a XY Line Renderer.

Custom Properties

X Offset

X-offset for the 3D effect.

This property is valid for Line 3D renderer.

Property name: XOffset

Property type: Float

Y Offset

Y-offset for the 3D effect.

This property is valid for Line 3D renderer.

Property name: YOffset

Property type: Float

Wall Paint

Paint used to color the "sides" (or "walls") of the plot background area.

This property is valid for Line 3D renderer.

Property name: wallPaint

Property type: Data Table

Precision

Number of line segments used to approximate the curve between data points.

This property is valid for Spline renderer.

Property name: precision

Property type: Integer

Step Point

Fraction of the domain position between two points on which the step is drawn. The default is 1.0, which means the step is drawn at the domain position of the second point. If the Step Point is 0.5 the step is drawn at half between the two points.

This property is valid for Step renderer.

Property name: stepPoint

Property type: Float

Common Events

Hidden, Shown, Moved, Resized, Mouse Clicked, Mouse Pressed, Mouse Released, Mouse Entered, Mouse Exited, Mouse Moved, Mouse Wheel Moved, Key Typed, Key Pressed, Key Released, Focus Gained, Focus Lost

Additional Examples

A line chart with many series. A shape is displayed at each data point to help to differentiate the series:

ls_widgets_charts_line_xy_many_series

A line chart where each series is displayed with a different combination of lines and/or shapes:

ls_widgets_charts_line_xy_mixed_series

A "step" chart with item labels:

ls_widgets_charts_line_xy_step_item_labels

A line chart with two range axes:

ls_widgets_charts_line_xy_two_axes

A line chart with multiple range axes:

ls_widgets_charts_line_many_axes

An XY line chart with four data series and pointer annotations:

ls_widgets_charts_line_xy_pointers

A scatter plot that displays multiple data series. It uses Line renderer with Default Lines Visibility disabled:

ls_widgets_charts_line_xy_scatter