StripCollection Class
Namespace: DevExpress.XtraCharts
Assembly: DevExpress.XtraCharts.v24.2.dll
Declaration
public class StripCollection :
ChartElementNamedCollection,
IEnumerable<IStrip>,
IEnumerableRelated API Members
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;