StripCollection Class

Represents a collection that stores the strips of a particular axis.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v19.2.dll

Declaration

public class StripCollection :
    ChartElementNamedCollection,
    IEnumerable<IStrip>,
    IEnumerable
Public Class StripCollection
    Inherits ChartElementNamedCollection
    Implements IEnumerable(Of IStrip),
               IEnumerable

Remarks

Each axis (in particular, an axis of the AxisX or AxisY type) can hold a collection of strips which can be accessed via the Axis2D.Strips property and is represented by the StripCollection class. The properties and methods exposed by the StripCollection class can be used to perform common collection operations such as adding new or deleting existing items. Each item of the collection is represented by a Strip object. Individual strips can be accessed using either indexer notation or by their names using the specific methods of the collection.

For more information, refer to Strips.

Examples

This example demonstrates how strips can be created and customized at runtime.

Since strips reside in an appropriate axis collection, you should first cast your diagram object to the required diagram's type. Then, you can access the collection via the Axis2D.Strips property.

// Cast the chart's diagram to the XYDiagram type, to access its axes.
XYDiagram diagram = (XYDiagram)chartControl1.Diagram;

// Create a strip with its maximum and minimum axis value defined.
diagram.AxisY.Strips.Add(new Strip("Strip 1", 5, 15));

// Customize the strip's behavior.
diagram.AxisY.Strips[0].Visible = true;
diagram.AxisY.Strips[0].ShowAxisLabel = true;
diagram.AxisY.Strips[0].AxisLabelText = "My Range";
diagram.AxisY.Strips[0].ShowInLegend = true;
diagram.AxisY.Strips[0].LegendText = "A Sample Strip";

// Customize the strip's appearance.
diagram.AxisY.Strips[0].Color = Color.CornflowerBlue;
diagram.AxisY.Strips[0].FillStyle.FillMode = FillMode.Empty;
See Also