Defining Markers

Purpose

This topic demonstrates, with code examples, how to define the markers for UltraSparkline™ control.

Required Background

The following table lists the topics required as a prerequisite to understanding this topic.

Topic	Purpose
UltraSparkline Overview	This topic provides an overview of the UltraSparkline control, its benefits, and the supported chart types.
Configuring UltraSparkline	This topic provides an overview of the possible ways to configure the UltraSparkline control. Links to the detailed configurations (available in separate topics) are provided as well.

In This Topic

This topic contains the following sections:

Defining Markers – Conceptual Overview
Defining Markers – Code Example
- Description
- Preview
- Code
Related Content

Defining Markers – Conceptual Overview

Introduction

Markers are symbols (circular colored icons) overlaid on the Sparkline to indicate the individual data points based on X/Y coordinates. Markers can be set on Sparkline of types Line, Area and Column. The WinLoss type of Sparkline does not accept markers.

Markers can be displayed on the first, last, highest, lowest and negative data points and as any combination of these.

By default, markers are not displayed.

Property settings

The following table maps the tasks related to displaying markers to the property settings that configure them.

Note: The Collapsed setting indicates the default state of any marker in which they are not visible.

In order to:	Use this property:	And set it to:
Display all markers	MarkerVisibility	Visible
Hide all markers	MarkerVisibility	Collapsed
Display the marker on the first data point	FirstMarkerVisibility	Visible
Hide the marker on the first data point	FirstMarkerVisibility	Collapsed
Display the marker on the last data point	LastMarkerVisibility	Visible
Hide the marker on the last data point	LastMarkerVisibility	Collapsed
Display the marker on the highest data point	HighMarkerVisibility	Visible
Hide the marker on the highest data point	HighMarkerVisibility	Collapsed
Display the marker on the lowest data point	LowMarkerVisibility	Visible
Hide the marker on the lowest data point	LowMarkerVisibility	Collapsed
Display the markers on the negative data points	NegativeMarkerVisibility	Visible
Hide the markers on the negative data points	NegativeMarkerVisibility	Collapsed

Example

The screenshot below demonstrates how the Sparkline looks as a result of the following settings:

Property	Value
MarkerVisibility	Visible
MarkerSize	15

Configuring Markers

Markers can be configured in the following aspects:

Selecting the data points to indicate, individually or in combination such as the first, last, highest, lowest and the negative values; for details, refer to the Property settings block.
Size
Color

For details on how to configure the markers’ size and color, refer to the Configuring Markers topic.

Defining Markers - Code Example

Description

The code below demonstrates how to display markers on the following data points:

The first data point
The last data point
On all negative data points

Preview

Code

In C#:

this.UltraSparkline1.MarkerVisibility = Infragistics.Portable.Components.UI.Visibility.Collapsed;
this.UltraSparkline1.LowMarkerVisibility = Infragistics.Portable.Components.UI.Visibility.Collapsed;
this.UltraSparkline1.HighMarkerVisibility = Infragistics.Portable.Components.UI.Visibility.Collapsed;
this.UltraSparkline1.FirstMarkerVisibility = Infragistics.Portable.Components.UI.Visibility.Visible;
this.UltraSparkline1.LastMarkerVisibility = Infragistics.Portable.Components.UI.Visibility.Visible;
this.UltraSparkline1.NegativeMarkerVisibility = Infragistics.Portable.Components.UI.Visibility.Visible;

In Visual Basic:

Me.UltraSparkline1.MarkerVisibility = Infragistics.Portable.Components.UI.Visibility.Collapsed
Me.UltraSparkline1.LowMarkerVisibility = Infragistics.Portable.Components.UI.Visibility.Collapsed
Me.UltraSparkline1.HighMarkerVisibility = Infragistics.Portable.Components.UI.Visibility.Collapsed
Me.UltraSparkline1.FirstMarkerVisibility = Infragistics.Portable.Components.UI.Visibility.Visible
Me.UltraSparkline1.LastMarkerVisibility = Infragistics.Portable.Components.UI.Visibility.Visible
Me.UltraSparkline1.NegativeMarkerVisibility = Infragistics.Portable.Components.UI.Visibility.Visible

Windows Forms | Help Topics