Skip to main content
A newer version of this page is available. .

StripCollection Class

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

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v20.2.dll

NuGet Packages: DevExpress.Charts, DevExpress.WindowsDesktop.Charts

Declaration

public class StripCollection :
    ChartElementNamedCollection,
    IEnumerable<IStrip>,
    IEnumerable

The following members return StripCollection objects:

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.

Example

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