XamSparkline Property Reference

DisplayType

Used to determine the type of Sparkline.

The valid setting are:

DisplayType

Line

FirstMarkerBrush

Styles the Marker for the first data point by setting it to desired color. The color can be specified in one of the following:

Brush

Not set

FirstMarkerSize

Specifies the size of the Marker on the first data point. The valid settings are all positive numbers and they indicate the size in pixels. If a negative number is used, it will convert the number into a positive, for example –3 will be treated as 3.

Double

3

FirstMarkerVisibility

Visibility setting of the Marker for the first data point. The valid settings are:

Visibility

Not set

HighMarkerBrush

Styles the Marker for the highest data point by setting it to desired color. The color can be specified in one of the following:

Brush

Not set

HighMarkerSize

Specifies the size of the Marker on the highest data point. The valid settings are all positive numbers and they indicate the size in pixels. If a negative number is used, it will convert the number into a positive, for example –3 will be treated as 3.

Double

3

HighMarkerVisibility

Visibility setting of the Marker for the highest data point. The valid settings are:

Visibility

Not set

HorizontalAxisVisibility

Visibility setting allows displaying the horizontal line of X axis.

Only the minimum and maximum values per axis will display, because of the size limitation of the Sparkline.

The valid settings are:

Visibility

Not set

HorizontalAxisLabel

Allows formatting the labels on horizontal (X) axis. The DataContext for horizontal axis labels will be the first and last values in the data corresponding to the LabelMemberPath setting. The default value for HorizontalAxisLabel is “{0}” which means print the label exactly as it appears in the datasource.

Object

Not set

ItemsSource

Used to bind the control to a data that contains at least two numeric fields to represent the data points.

IEnumerable

Not set

LabelMemberPath

Identifies the labels on X axis when the Horizontal axis is visible.

String (the Name of the field to display as a label)

Not set

LastMarkerBrush

Specifies the color of the Marker on the last data point. The color can be specified in one of the following:

Brush

Not set

LastMarkerSize

Specifies the size of the Marker on the last data point. The valid settings are all positive numbers and they indicate the size in pixels. If a negative number is used, it will convert the number into a positive, for example –3 will be treated as 3.

Double

3

LastMarkerVisibility

Visibility setting of the Marker for the last data point. The valid settings are:

Visibility

Not set

LowMarkerBrush

Specifies the color of the Marker on the lowest data point. The color can be specified in one of the following:

Brush

Not set

LowMarkerSize

Specifies the size of the Marker on the lowest data point. The valid settings are all positive numbers and they indicate the size in pixels. If a negative number is used, it will convert the number into a positive, for example –3 will be treated as 3.

Double

3

LowMarkerVisibility

Visibility setting of the Marker for the lowest data point. The valid settings are:

Visibility

Not set

MarkerBrush

Specifies the color of the Marker on all data points. The color can be specified in one of the following:

Brush

Not set

MarkerSize

Specifies the size of the Marker on all data points. The valid settings are all positive numbers and they indicate the size in pixels. If a negative number is used, it will convert the number into a positive, for example –3 will be treated as 3.

Double

3

MarkerVisibility

Visibility setting of the Marker for all data point. The valid settings are:

Visibility

Collapsed

NegativeMarkerBrush

Specifies the color of the Marker on the negative data points. The color can be specified in one of the following:

Brush

Not set

NegativeMarkerSize

Specifies the size of the Marker on the negative data point. The valid settings are all positive numbers and they indicate the size in pixels. If a negative number is used, it will convert the number into a positive, for example –3 will be treated as 3.

Double

3

NegativeMarkerVisibility

Visibility setting of the markers on the negative data points.

The valid settings are:

Visibility

Not set

NormalRangeFill

Specifies the color of the Normal Range.

Brush

Gray color

NormalRangeMaximum

Specifies the upper boarder of the Normal Range.

Double

Not set

NormalRangeMinimum

Specifies the lower boarder of the Normal Range.

Double

Not set

NormalRangeVisibility

Visibility setting of the Normal Range on the data points.

The valid settings are:

Visibility

Not set

ToolTip

When this property is not set, tooltip displays the first, last, high and low data points which is the default content of the tooltip. When this property is set, the content of the tooltip is customized.

Note: This property is affective only when the ToolTipVisibility is enabled.

The ToolTip property can be set to a Data Template or a string to achieve customized look. In most cases, it is preferred to using Data Template for customization rather than string, because with a Data Template you have more options over the appearance of the tooltip.

String

Not set

ToolTipVisibility

Enables or disables the tooltip. If enabled ( Visible ), it displays the tooltip when the the mouse pointer is over the chart. The enabled tooltip displays the first, last, high and low data points by default.

The available valid options are:

Visibility

Collapsed

TrendLineBrush

Specifies the color of the Trend Line. The color can be specified in one of the following:

Brush

Gray color

TrendLinePeriod

Feeds the seed in calculation formula for the different Trend Line types. Used for calculating average type trend lines.

The valid settings are 1÷255, representing the specific number of data points the average types use to smooth out the fluctuation in data.

For example, if the period is set to 2 then the average of the first 2 data points is used as the first point, then the average of the next two data points will be used as the second point and so on.

Double

7

TrendLineThickness

Thickness of the Trend Line in pixels.

Double

1

TrendLineType

Draws a directional trend line over the Sparkline chart. The valid settings reflect the supported Trend Line:

TrendLineType

Not set

UnknownValuePlotting

Identifies and plots the unknown data points (null values). The valid settings are:

Effective only on with Line and Area Sparkline types.

String

DontPlot

ValueMemberPath

Identifies the numeric property from the underlying data as the Sparkline data points. This identification is necessary for displaying the Sparkline data points.

String (the Name of the field to display the chart)

Not set

VerticalAxisVisibility

Visibility setting of the Y axis. Displays the axis line, along with the minimum and maximum axis values. (Only the minimum and maximum values per axis will display, because of the size limitation of the Sparkline.)

The valid settings are:

String

Not set

VerticalAxisLabel

Allows formatting the labels on vertical (Y) axis. The DataContext for vertical axis labels will be the ActualMinimum or ActualMaximum for the axis. The default value for VerticalAxisLabel is “{0:n}” which means format these values as numbers.

String

Not set