ChartElement.Tag Property

Gets or sets the object that contains data related to the chart element.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v20.2.dll

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

Declaration

C#

[XtraChartsLocalizableCategory(XtraChartsCategory.Misc)]
public object Tag { get; set; }

VB.NET

<XtraChartsLocalizableCategory(XtraChartsCategory.Misc)>
Public Property Tag As Object

Property Value

Type	Description
Object	A Object that contains data about the chart element.

Property Paths

You can access this nested property as listed below:

Show 158 property paths

Library	Object Type	Path to Tag
Cross-Platform Class Library	AreaSeriesView	.RangeControlOptions .Tag
	AreaSeriesViewBase	.RangeControlOptions .Tag
	AverageTrueRange	.CrosshairTextOptions .Tag
	Axis	.CrosshairAxisLabelOptions .Tag
	Axis	.DateTimeScaleOptions .Tag
	Axis	.WorkdaysOptions .Tag
	Axis	.ScaleBreakOptions .Tag
	Axis2D	.CrosshairAxisLabelOptions .Tag
	Axis2D	.DateTimeScaleOptions .Tag
	Axis2D	.WorkdaysOptions .Tag
	Axis3D	.DateTimeScaleOptions .Tag
	Axis3D	.WorkdaysOptions .Tag
	AxisBase	.DateTimeScaleOptions .Tag
	AxisBase	.WorkdaysOptions .Tag
	AxisLabel	.ResolveOverlappingOptions .Tag
	AxisLabel2D	.ResolveOverlappingOptions .Tag
	AxisLabel3D	.ResolveOverlappingOptions .Tag
	AxisX	.CrosshairAxisLabelOptions .Tag
	AxisX	.DateTimeScaleOptions .Tag
	AxisX	.WorkdaysOptions .Tag
	AxisX	.QualitativeScaleOptions .Tag
	AxisX	.ScaleBreakOptions .Tag
	AxisX3D	.DateTimeScaleOptions .Tag
	AxisX3D	.WorkdaysOptions .Tag
	AxisX3D	.QualitativeScaleOptions .Tag
	AxisXBase	.CrosshairAxisLabelOptions .Tag
	AxisXBase	.DateTimeScaleOptions .Tag
	AxisXBase	.WorkdaysOptions .Tag
	AxisXBase	.QualitativeScaleOptions .Tag
	AxisXBase	.ScaleBreakOptions .Tag
	AxisY	.CrosshairAxisLabelOptions .Tag
	AxisY	.DateTimeScaleOptions .Tag
	AxisY	.WorkdaysOptions .Tag
	AxisY	.ScaleBreakOptions .Tag
	AxisY3D	.DateTimeScaleOptions .Tag
	AxisY3D	.WorkdaysOptions .Tag
	AxisYBase	.CrosshairAxisLabelOptions .Tag
	AxisYBase	.DateTimeScaleOptions .Tag
	AxisYBase	.WorkdaysOptions .Tag
	AxisYBase	.ScaleBreakOptions .Tag
	BarSeriesView	.RangeControlOptions .Tag
	BollingerBands	.CrosshairTextOptions .Tag
	BoxPlotSeriesView	.RangeControlOptions .Tag
	BubbleSeriesView	.RangeControlOptions .Tag
	CandleStickDrawOptions	.ReductionOptions .Tag
	CandleStickSeriesView	.RangeControlOptions .Tag
	CandleStickSeriesView	.ReductionOptions .Tag
	ChaikinsVolatility	.CrosshairTextOptions .Tag
	ChartRangeControlClientDateTimeOptions	.RangeControlDateTimeGridOptions .Tag
	ChartRangeControlClientNumericOptions	.RangeControlNumericGridOptions .Tag
	CommodityChannelIndex	.CrosshairTextOptions .Tag
	CrosshairOptions	.CrosshairLabelTextOptions .Tag
	DataSourceBasedErrorBars	.CrosshairTextOptions .Tag
	DateTimeScaleOptions	.WorkdaysOptions .Tag
	DetrendedPriceOscillator	.CrosshairTextOptions .Tag
	Diagram3D	.RotationOptions .Tag
	ErrorBars	.CrosshairTextOptions .Tag
	ExponentialMovingAverage	.CrosshairTextOptions .Tag
	FibonacciIndicator	.CrosshairTextOptions .Tag
	FillStyle2D	.Options .Tag
	FillStyle3D	.Options .Tag
	FillStyleBase	.Options .Tag
	FinancialDrawOptions	.ReductionOptions .Tag
	FinancialIndicator	.CrosshairTextOptions .Tag
FinancialSeriesViewBase	.ReductionOptions .Tag
FinancialSeriesViewBase	.RangeControlOptions .Tag
FixedValueErrorBars	.CrosshairTextOptions .Tag
FullStackedAreaPointOptions	.ValueNumericOptions .Tag
FullStackedAreaPointOptions	.PercentOptions .Tag
FullStackedAreaSeriesView	.RangeControlOptions .Tag
FullStackedBarPointOptions	.ValueNumericOptions .Tag
FullStackedBarPointOptions	.PercentOptions .Tag
FullStackedBarSeriesView	.RangeControlOptions .Tag
FullStackedLinePointOptions	.ValueNumericOptions .Tag
FullStackedLinePointOptions	.PercentOptions .Tag
FullStackedLineSeriesView	.RangeControlOptions .Tag
FullStackedPointOptions	.ValueNumericOptions .Tag
FullStackedPointOptions	.PercentOptions .Tag
FullStackedSplineAreaSeriesView	.RangeControlOptions .Tag
FullStackedStepAreaSeriesView	.RangeControlOptions .Tag
FunnelDiagram3D	.RotationOptions .Tag
FunnelPointOptions	.ValueNumericOptions .Tag
FunnelPointOptions	.PercentOptions .Tag
GanttAxisX	.CrosshairAxisLabelOptions .Tag
GanttAxisX	.DateTimeScaleOptions .Tag
GanttAxisX	.WorkdaysOptions .Tag
GanttAxisX	.QualitativeScaleOptions .Tag
GanttAxisX	.ScaleBreakOptions .Tag
GanttDiagram	.RangeControlDateTimeGridOptions .Tag
GanttDiagram	.DrillDownOptions .Tag
GanttDrawOptions	.LinkOptions .Tag
GanttSeriesView	.RangeControlOptions .Tag
GanttSeriesView	.LinkOptions .Tag
Indicator	.CrosshairTextOptions .Tag
LineSeriesView	.RangeControlOptions .Tag
MassIndex	.CrosshairTextOptions .Tag
MedianPrice	.CrosshairTextOptions .Tag
MovingAverage	.CrosshairTextOptions .Tag
MovingAverageConvergenceDivergence	.CrosshairTextOptions .Tag
NumericScaleOptions	.IntervalOptions .Tag
OverlappedGanttSeriesView	.RangeControlOptions .Tag
OverlappedGanttSeriesView	.LinkOptions .Tag
OverlappedRangeBarSeriesView	.RangeControlOptions .Tag
PercentageErrorBars	.CrosshairTextOptions .Tag
PiePointOptions	.ValueNumericOptions .Tag
PiePointOptions	.PercentOptions .Tag
PointOptions	.ValueNumericOptions .Tag
PointSeriesView	.RangeControlOptions .Tag
PointSeriesViewBase	.RangeControlOptions .Tag
PolarAxisX	.DateTimeScaleOptions .Tag
PolarAxisX	.WorkdaysOptions .Tag
PolarAxisX	.QualitativeScaleOptions .Tag
PolarDiagram	.SelectionOptions .Tag
PolygonFillStyle	.Options .Tag
PolygonFillStyle3D	.Options .Tag
RadarAxis	.DateTimeScaleOptions .Tag
RadarAxis	.WorkdaysOptions .Tag
RadarAxisX	.DateTimeScaleOptions .Tag
RadarAxisX	.WorkdaysOptions .Tag
RadarAxisX	.QualitativeScaleOptions .Tag
RadarAxisXLabel	.ResolveOverlappingOptions .Tag
RadarAxisY	.DateTimeScaleOptions .Tag
RadarAxisY	.WorkdaysOptions .Tag
RadarAxisYLabel	.ResolveOverlappingOptions .Tag
RadarDiagram	.SelectionOptions .Tag
RangeAreaPointOptions	.ValueNumericOptions .Tag
RangeAreaSeriesView	.RangeControlOptions .Tag
RangeBarPointOptions	.ValueNumericOptions .Tag
RangeBarSeriesView	.RangeControlOptions .Tag
RangePointOptions	.ValueNumericOptions .Tag
RateOfChange	.CrosshairTextOptions .Tag
RectangleFillStyle	.Options .Tag
RectangleFillStyle3D	.Options .Tag
RegressionLine	.CrosshairTextOptions .Tag
RelativeStrengthIndex	.CrosshairTextOptions .Tag
ScatterLineSeriesView	.RangeControlOptions .Tag
ScrollBarOptions	.YAxisAnnotationOptions .Tag
SecondaryAxisX	.CrosshairAxisLabelOptions .Tag
SecondaryAxisX	.DateTimeScaleOptions .Tag
SecondaryAxisX	.WorkdaysOptions .Tag
SecondaryAxisX	.QualitativeScaleOptions .Tag
SecondaryAxisX	.ScaleBreakOptions .Tag
SecondaryAxisY	.CrosshairAxisLabelOptions .Tag
SecondaryAxisY	.DateTimeScaleOptions .Tag
SecondaryAxisY	.WorkdaysOptions .Tag
SecondaryAxisY	.ScaleBreakOptions .Tag
SeparatePaneIndicator	.CrosshairTextOptions .Tag
Series	.TimeSpanSummaryOptions .Tag
SeriesBase	.TimeSpanSummaryOptions .Tag
SeriesTemplate	.TimeSpanSummaryOptions .Tag
SeriesViewColorEachSupportBase	.RangeControlOptions .Tag
SideBySideBarSeriesView	.RangeControlOptions .Tag
SideBySideFullStackedBarSeriesView	.RangeControlOptions .Tag
SideBySideGanttSeriesView	.RangeControlOptions .Tag
SideBySideGanttSeriesView	.LinkOptions .Tag
SideBySideRangeBarSeriesView	.RangeControlOptions .Tag
SideBySideStackedBarSeriesView	.RangeControlOptions .Tag
SimpleDiagram	.SelectionOptions .Tag
SimpleDiagram3D	.RotationOptions .Tag
SimpleMovingAverage	.CrosshairTextOptions .Tag
SimplePointOptions	.ValueNumericOptions .Tag
SimplePointOptions	.PercentOptions .Tag
SingleLevelIndicator	.CrosshairTextOptions .Tag
SplineAreaSeriesView	.RangeControlOptions .Tag
SplineSeriesView	.RangeControlOptions .Tag
StackedAreaSeriesView	.RangeControlOptions .Tag
StackedBarSeriesView	.RangeControlOptions .Tag
StackedLineSeriesView	.RangeControlOptions .Tag
StackedSplineAreaSeriesView	.RangeControlOptions .Tag
StackedStepAreaSeriesView	.RangeControlOptions .Tag
StandardDeviation	.CrosshairTextOptions .Tag
StandardDeviationErrorBars	.CrosshairTextOptions .Tag
StandardErrorBars	.CrosshairTextOptions .Tag
StepAreaSeriesView	.RangeControlOptions .Tag
StepLineSeriesView	.RangeControlOptions .Tag
StockDrawOptions	.ReductionOptions .Tag
StockPointOptions	.ValueNumericOptions .Tag
StockSeriesView	.ReductionOptions .Tag
StockSeriesView	.RangeControlOptions .Tag
SubsetBasedIndicator	.CrosshairTextOptions .Tag
SwiftPlotDiagram	.RangeControlDateTimeGridOptions .Tag
SwiftPlotDiagramAxis	.CrosshairAxisLabelOptions .Tag
SwiftPlotDiagramAxis	.DateTimeScaleOptions .Tag
SwiftPlotDiagramAxis	.WorkdaysOptions .Tag
SwiftPlotDiagramAxisX	.CrosshairAxisLabelOptions .Tag
SwiftPlotDiagramAxisX	.DateTimeScaleOptions .Tag
SwiftPlotDiagramAxisX	.WorkdaysOptions .Tag
SwiftPlotDiagramAxisXBase	.CrosshairAxisLabelOptions .Tag
SwiftPlotDiagramAxisXBase	.DateTimeScaleOptions .Tag
SwiftPlotDiagramAxisXBase	.WorkdaysOptions .Tag
SwiftPlotDiagramAxisY	.CrosshairAxisLabelOptions .Tag
SwiftPlotDiagramAxisY	.DateTimeScaleOptions .Tag
SwiftPlotDiagramAxisY	.WorkdaysOptions .Tag
SwiftPlotDiagramAxisYBase	.CrosshairAxisLabelOptions .Tag
SwiftPlotDiagramAxisYBase	.DateTimeScaleOptions .Tag
SwiftPlotDiagramAxisYBase	.WorkdaysOptions .Tag
SwiftPlotDiagramSecondaryAxisX	.CrosshairAxisLabelOptions .Tag
SwiftPlotDiagramSecondaryAxisX	.DateTimeScaleOptions .Tag
SwiftPlotDiagramSecondaryAxisX	.WorkdaysOptions .Tag
SwiftPlotDiagramSecondaryAxisY	.CrosshairAxisLabelOptions .Tag
SwiftPlotDiagramSecondaryAxisY	.DateTimeScaleOptions .Tag
SwiftPlotDiagramSecondaryAxisY	.WorkdaysOptions .Tag
SwiftPlotSeriesView	.RangeControlOptions .Tag
SwiftPlotSeriesViewBase	.RangeControlOptions .Tag
TimeSpanScaleOptions	.IntervalOptions .Tag
TrendLine	.CrosshairTextOptions .Tag
TriangularMovingAverage	.CrosshairTextOptions .Tag
TripleExponentialMovingAverageTema	.CrosshairTextOptions .Tag
TripleExponentialMovingAverageTrix	.CrosshairTextOptions .Tag
TypicalPrice	.CrosshairTextOptions .Tag
WaterfallSeriesView	.RangeControlOptions .Tag
WaterfallSeriesView	.ValueOptions .Tag
WeightedClose	.CrosshairTextOptions .Tag
WeightedMovingAverage	.CrosshairTextOptions .Tag
WilliamsR	.CrosshairTextOptions .Tag
XYDiagram	.RangeControlDateTimeGridOptions .Tag
XYDiagram	.DrillDownOptions .Tag
XYDiagram2D	.RangeControlDateTimeGridOptions .Tag
XYDiagram2DSeriesViewBase	.RangeControlOptions .Tag
XYDiagram3D	.RotationOptions .Tag
XYDiagramDefaultPane	.LayoutOptions .Tag
XYDiagramPane	.LayoutOptions .Tag
XYDiagramPaneBase	.LayoutOptions .Tag
XYDiagramSeriesViewBase	.RangeControlOptions .Tag
WinForms Controls	ChartControl	.CrosshairOptions .Tag
Reporting	XRChart	.PivotGridDataSourceOptions .Tag
ASP.NET MVC Extensions	ChartControlSettings	.CrosshairOptions .Tag
	MVCxChartControl	.CrosshairOptions .Tag
ASP.NET Web Forms Controls	WebChartControl	.CrosshairOptions .Tag

Remarks

Any type derived from the Object class can be assigned to this property. Use it to store data associated with a particular chart element (e.g., an annotaton, an axis, an axis title, a diagram).

Note

If a chart is bound to data, the Tag property is automatically assigned to the underlying object used to create this chart element (e.g. to the corresponding DataRowView object, if a chart is bound to a DataTable).

Important

When the chart is serialized, only string Tag values are saved.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Tag property.

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.

C#

how-to-create-a-side-by-side-full-stacked-bar-chart-e2093/CS/SideBySideFullStackedBarChart/Form1.cs#L53

foreach (Series series in stackedBarChart.Series) {
    if (!(series.Tag is GenderAgeInfo)) return;
    GenderAgeInfo item = (GenderAgeInfo)series.Tag;

how-to-display-the-total-value-above-each-pie-chart/CS/TotalsInChartsExample/Form1.cs#L26

foreach (Series series in chart.Series) {
    var axisPoint = series.Tag as AxisPoint;
    if (axisPoint != null) {

VB.NET

how-to-create-a-side-by-side-full-stacked-bar-chart-e2093/VB/SideBySideFullStackedBarChart/Form1.vb#L55

For Each series As Series In stackedBarChart.Series
    If Not (TypeOf series.Tag Is GenderAgeInfo) Then
        Return

how-to-display-the-total-value-above-each-pie-chart/VB/TotalsInChartsExample/Form1.vb#L26

For Each series As Series In chart.Series
    Dim axisPoint = TryCast(series.Tag, AxisPoint)
    If axisPoint IsNot Nothing Then