Dundas Chart for Windows Forms
AllowOutsidePlotArea Property
See Also  Example Send comments on this topic.
DundasWinChart Assembly > Dundas.Charting.WinControl Namespace > SmartLabelsStyle Class : AllowOutsidePlotArea Property


Enterprise Edition Only Feature. Gets or sets a LabelOutsidePlotAreaStyle value that specifies the extent of how the datapoint labels should be drawn with respect to the plotting area.
Defines if SmartLabels are allowed to be drawn outside of the plotting area.

Syntax

Visual Basic (Declaration)  
Public Overridable Property AllowOutsidePlotArea As LabelOutsidePlotAreaStyle
Visual Basic (Usage) Copy Code
Dim instance As SmartLabelsStyle
Dim value As LabelOutsidePlotAreaStyle
 
instance.AllowOutsidePlotArea = value
 
value = instance.AllowOutsidePlotArea
C#  
public virtual LabelOutsidePlotAreaStyle AllowOutsidePlotArea {get; set;}

Return Value

Specifies the extent of how the datapoint labels should be drawn with respect to the plotting area. The default value is LabelOutsidePlotAreaStyle.Partial.

Example

This example demonstrates how to use the LabelOutsidePlotAreaStyle enumeration to set the AllowOutsidePlotArea property.
C# Copy Code
using Dundas.Charting.WinControl
...

   
// Enable SmartLabels
   
chart1.Series["Default"].SmartLabels.Enabled = true;
   
   
// Allow SmartLabels to be partially outside the plot area
   
chart1.Series["Default"].SmartLabels.AllowOutsidePlotArea = LabelOutsidePlotAreaStyle.Partial;

...
Visual Basic Copy Code
Imports Dundas.Charting.WinControl
...

    ' Enable SmartLabels
    chart1.Series["Default"].SmartLabels.Enabled = True

    ' Allow SmartLabels To be partially outside the plot area
    chart1.Series["Default"].SmartLabels.AllowOutsidePlotArea = LabelOutsidePlotAreaStyle.Partial

...

Remarks

This property determines how the datapoint labels should be drawn outside the plotting area. When applying smart data labels the drawing outside of labels is only used to provide an option as the chart will only draw outside if the labels cannot be drawn elsewhere without overlapping.

Figure 1: AllowOutsidePlotArea set to Yes (shown left); AllowOutsidePlotArea set to No (shown right).

The possible values are:

Member Name

Description

Yes

Labels are allowed to leave the plotting area if necessary.

No

Labels are NOT allowed to leave the plotting area.

Partial

Labels are allowed to leave the plotting area if necessary but no more than 50% of the label cannot be drawn outside the plotting area.


NOTE: SmartLabels only work when the Label angle property is set to zero.

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2009 All Rights Reserved.