TextOverlapsImage Property

Controls whether or not the text should use the Z position of the base point.

Syntax

Visual Basic
C#

'Declaration
 
<DescriptionAttribute("Controls whether or not the text should use the Z position of the base point.")>
<CategoryAttribute("General")>
<DefaultValueAttribute()>
Public Property TextOverlapsImage As Boolean

'Usage
 
Dim instance As ChartText
Dim value As Boolean
 
instance.TextOverlapsImage = value
 
value = instance.TextOverlapsImage

[Description("Controls whether or not the text should use the Z position of the base point.")]
[Category("General")]
[DefaultValue()]
public bool TextOverlapsImage {get; set;}

Remarks

When Xceed Chart for WinForms renders objects with associated texts like bars, axes etc. it generates a base point with a Z value equal to the object. You can instruct the ChartText object whether to render or not at the same Z value as the base point. When set to true the text will always overlap the chart.

Example

The following example instructs the bar labels to use the Z value of the bar they are attached to. This is why these objects will disappear when overlapped by a chart element closer to the viewer.

Visual Basic

Dim chart As Chart =  ChartControl.Charts.GetAt(0) 
Dim bar As BarSeries = CType(chart.Series.Add(SeriesType.Bar), BarSeries)

bar.Add(10, "Apples")
bar.Add(20, "Oranges")

bar.Appearance.LineMode = AppearanceLineMode.Series
bar.DataLabels.Text.TextOverlapsImage = False

Chart chart = ChartControl.Charts.GetAt(0);
BarSeries bar = (BarSeries)chart.Series.Add(SeriesType.Bar);
      
bar.Add(10, "Apples");
bar.Add(20, "Oranges");

bar.Appearance.LineMode = AppearanceLineMode.Series;
bar.DataLabels.Text.TextOverlapsImage = false;

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

ChartText Class
ChartText Members