SparklineViewBase Class

The base class for sparkline views.

Namespace: DevExpress.Sparkline

Assembly: DevExpress.Sparkline.v18.1.Core.dll

Declaration

C#

public abstract class SparklineViewBase :
    IXtraSupportShouldSerialize,
    ISparklineInfo

VB.NET

Public MustInherit Class SparklineViewBase
    Implements IXtraSupportShouldSerialize,
               ISparklineInfo

Related API Members

The following members accept/return SparklineViewBase objects:

Library	Related API Members
Cross-Platform Class Library	SparklineViewBase.CreateView(SparklineViewType)
WinForms Controls	RepositoryItemSparklineEdit.View
Reporting	XRSparkline.View

Remarks

Each sparkline view is represented by the SparklineViewBase class descendant. To assign a specific view for a sparkline, set the required view to the RepositoryItemSparklineEdit.View property.

Example

This example demonstrates how to create a sparkline control, fill it with data, choose the way to represent this data, and customize the sparkline appearance.

To do this, you should create a SparklineEdit object and assign the datasource object to its BaseEdit.EditValue property. Then, you need to set the appropriate view instance to the SparklineEdit.Properties.View property and customize view properties to meet your requirements.

Note that in this sample, the AreaSparklineView class is used to display area sparklines. To display other sparklines types, use the BarSparklineView, LineSparklineView or WinLossSparklineView classes instead.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-create-a-sparkline-control-e4689

Form1.cs

using System;
using System.Drawing;
using System.Windows.Forms;
using DevExpress.Sparkline;
using DevExpress.XtraEditors;
        private SparklineEdit CreateSparkline() {
            // Create a Sparkline editor and set its dock style.
            SparklineEdit sparkline = new SparklineEdit();
            sparkline.Dock = DockStyle.Fill;

            sparkline.EditValue = CreateData();

            // Create an Area view and assign it to the sparkline.
            AreaSparklineView view = new AreaSparklineView();
            sparkline.Properties.View = view;

            // Customize area appearance.
            view.Color = Color.Aqua;
            view.AreaOpacity = 50;

            // Show markerks.
            view.HighlightStartPoint = true;
            view.HighlightEndPoint = true;
            view.HighlightMaxPoint = true;
            view.HighlightMinPoint = true;
            view.HighlightNegativePoints = true;
            view.SetSizeForAllMarkers(10);

            return sparkline;
        }

        private double[] CreateData() {
            return new double[] { 2, 4, 5, 1, -1, -2, -1, 2, 4, 5, 6, 3, 5, 4, 8, -1, 6 };
        }

Form1.vb

Imports System
Imports System.Drawing
Imports System.Windows.Forms
Imports DevExpress.Sparkline
Imports DevExpress.XtraEditors
        Private Function CreateSparkline() As SparklineEdit
            ' Create a Sparkline editor and set its dock style.
            Dim sparkline As New SparklineEdit()
            sparkline.Dock = DockStyle.Fill

            sparkline.EditValue = CreateData()

            ' Create an Area view and assign it to the sparkline.
            Dim view As New AreaSparklineView()
            sparkline.Properties.View = view

            ' Customize area appearance.
            view.Color = Color.Aqua
            view.AreaOpacity = 50

            ' Show markerks.
            view.HighlightStartPoint = True
            view.HighlightEndPoint = True
            view.HighlightMaxPoint = True
            view.HighlightMinPoint = True
            view.HighlightNegativePoints = True
            view.SetSizeForAllMarkers(10)

            Return sparkline
        End Function

        Private Function CreateData() As Double()
            Return New Double() { 2, 4, 5, 1, -1, -2, -1, 2, 4, 5, 6, 3, 5, 4, 8, -1, 6 }
        End Function

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the SparklineViewBase class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

VB.NET

how-to-show-sparklines-in-a-grid-e4694/VB/SparklineInGrid/Form1.vb#L21

Dim repositoryItemSparklineEdit1 As New RepositoryItemSparklineEdit()
Dim sparklineView As SparklineViewBase = repositoryItemSparklineEdit1.View
sparklineView.HighlightEndPoint = True

Inheritance

Object

SparklineViewBase

BarSparklineViewBase

LineSparklineView

BarSparklineView

AreaSparklineView

WinLossSparklineView