FunnelSeriesView Class

Represents a series view of the Funnel type.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v20.1.dll

Declaration

public class FunnelSeriesView :
    FunnelSeriesViewBase,
    ISimpleDiagram2DSeriesView
Public Class FunnelSeriesView
    Inherits FunnelSeriesViewBase
    Implements ISimpleDiagram2DSeriesView

Remarks

The FunnelSeriesView class provides the functionality of a series view of the Funnel type within a chart control.

In addition to the common view settings inherited from the base SeriesViewBase class, the FunnelSeriesView class declares the funnel type specific settings, which allow you to enable the auto-calculation of a funnel's height-to-width ratio (the FunnelSeriesView.HeightToWidthRatioAuto property), to control a funnel's alignment with respect to the position of its labels (the FunnelSeriesView.AlignToCenter property), and a funnel's appearance (the FunnelSeriesView.Border and FunnelSeriesView.FillStyle properties).

Note that a particular view type can be defined for a series via its SeriesBase.View property.

For more information, refer to Funnel Series View.

Examples

The following example demonstrates how to create a ChartControl with a series of the FunnelSeriesView type, and add this chart to a form at runtime. Before proceeding with this example, create a Windows Forms Application in Visual Studio, and add all required assemblies to the References list of your project.

Then, add the following code to the Form.Load event handler.

using DevExpress.XtraCharts;
// ...

private void Form1_Load(object sender, EventArgs e) {
    // Create a new chart.
    ChartControl funnelChart = new ChartControl();

    // Create a funnel series.
    Series series1 = new Series("A Funnel Series", ViewType.Funnel);

    // Add points to the series.
    series1.Points.Add(new SeriesPoint("A", 48.5));
    series1.Points.Add(new SeriesPoint("B", 29.6));
    series1.Points.Add(new SeriesPoint("C", 17.1));
    series1.Points.Add(new SeriesPoint("D", 13.3));
    series1.Points.Add(new SeriesPoint("E", 11.6));

    // Add the series to the chart.
    funnelChart.Series.Add(series1);

    // Adjust the view-type specific properties of the series.
    FunnelSeriesView myView = (FunnelSeriesView)series1.View;

    myView.Titles.Add(new SeriesTitle());
    myView.Titles[0].Text = series1.Name;
    myView.HeightToWidthRatioAuto = false;
    myView.HeightToWidthRatio = 1.5;
    myView.PointDistance = 10;

    // Adjust the point options of the series.
    FunnelPointOptions myPointOptions = (FunnelPointOptions)series1.PointOptions;

    myPointOptions.PointView = PointView.ArgumentAndValues;
    myPointOptions.PercentOptions.ValueAsPercent = true;
    myPointOptions.ValueNumericOptions.Format = NumericFormat.Percent;
    myPointOptions.ValueNumericOptions.Precision = 0;

    // Specify the series labels position.
    ((FunnelSeriesLabel)series1.Label).Position = FunnelSeriesLabelPosition.RightColumn;

    // Hide the legend (if necessary).
    funnelChart.Legend.Visible = false;

    // Add the chart to the form.
    funnelChart.Dock = DockStyle.Fill;
    this.Controls.Add(funnelChart);
}
See Also