Scale Sections

In This Topic

Scale sections allow you to alter the appearance of different scale elements if they fall in a specified range. This allows you to visually highlight important ranges of data that the user has to pay special attention to.

The following picture shows four scale sections – two defined for the primary Y axis and two defined on the primary X axis:

You create a scale section by creating an instance of the NScaleSectionStyle class. The following code will create the red axis section displayed on the above picture:

C#	Copy Code
NCartesianChart chart = (NCartesianChart)nChartControl1.Charts[0]; // create the scale section NScaleSectionStyle scaleSection = new NScaleSectionStyle(); scaleSection.Range = new NRange1DD(2, 8); // display the range on the back wall scaleSection.SetShowAtWall(ChartWallType.Back, true); scaleSection.RangeFillStyle = new NColorFillStyle(Color.FromArgb(125, Color.Red)); // alter the major and minor grid stroke style if lines fall in the range [2, 8] scaleSection.MajorGridStrokeStyle = new NStrokeStyle(Color.Red); scaleSection.MajorTickStrokeStyle = new NStrokeStyle(Color.DarkRed); scaleSection.MinorTickStrokeStyle = new NStrokeStyle(1, Color.Red, (int)LinePattern.Dot, 2); // alter the text style of the automatic labels NTextStyle labelStyle = new NTextStyle(); labelStyle.FillStyle = new NGradientFillStyle(Color.Red, Color.DarkRed); labelStyle.FontStyle.Style = FontStyle.Bold; scaleSection.LabelTextStyle = labelStyle; // add the scale section to the primary X axis NAxis primaryX = chart.Axis(StandardAxis.PrimaryX); NStandardScaleConfigurator scaleConfigurator = (NStandardScaleConfigurator)primaryX.ScaleConfigurator; scaleConfigurator.Sections.Add(scaleSection); nChartControl1.Refresh();

Copy Code

NCartesianChart chart = (NCartesianChart)nChartControl1.Charts[0];

// create the scale section
NScaleSectionStyle scaleSection = new NScaleSectionStyle();

scaleSection.Range = new NRange1DD(2, 8);

// display the range on the back wall
scaleSection.SetShowAtWall(ChartWallType.Back, true);
scaleSection.RangeFillStyle = new NColorFillStyle(Color.FromArgb(125, Color.Red));

// alter the major and minor grid stroke style if lines fall in the range [2, 8]
scaleSection.MajorGridStrokeStyle = new NStrokeStyle(Color.Red);
scaleSection.MajorTickStrokeStyle = new NStrokeStyle(Color.DarkRed);
scaleSection.MinorTickStrokeStyle = new NStrokeStyle(1, Color.Red, (int)LinePattern.Dot, 2);

// alter the text style of the automatic labels
NTextStyle labelStyle = new NTextStyle();
labelStyle.FillStyle = new NGradientFillStyle(Color.Red, Color.DarkRed);
labelStyle.FontStyle.Style = FontStyle.Bold;
scaleSection.LabelTextStyle = labelStyle;

// add the scale section to the primary X axis
NAxis primaryX = chart.Axis(StandardAxis.PrimaryX);
NStandardScaleConfigurator scaleConfigurator = (NStandardScaleConfigurator)primaryX.ScaleConfigurator;
scaleConfigurator.Sections.Add(scaleSection);

nChartControl1.Refresh();

Visual Basic	Copy Code
Dim chart As NCartesianChart = NChartControl1.Charts(0) ' create the scale section Dim scaleSection As New NScaleSectionStyle scaleSection.Range = New NRange1DD(2, 8) ' display the range on the back wall scaleSection.SetShowAtWall(ChartWallType.Back, True) scaleSection.RangeFillStyle = New NColorFillStyle(Color.FromArgb(125, Color.Red)) ' alter the major and minor grid stroke style if lines fall in the range [2, 8] scaleSection.MajorGridStrokeStyle = New NStrokeStyle(Color.Red) scaleSection.MajorTickStrokeStyle = New NStrokeStyle(Color.DarkRed) scaleSection.MinorTickStrokeStyle = New NStrokeStyle(1, Color.Red, LinePattern.Dot, 2) ' alter the text style of the automatic labels Dim labelStyle As New NTextStyle labelStyle.FillStyle = New NGradientFillStyle(Color.Red, Color.DarkRed) labelStyle.FontStyle.Style = FontStyle.Bold scaleSection.LabelTextStyle = labelStyle ' add the scale section to the primary X axis Dim primaryX As NAxis = chart.Axis(StandardAxis.PrimaryX) Dim scaleConfigurator As NStandardScaleConfigurator = CType(primaryX.ScaleConfigurator, NStandardScaleConfigurator) scaleConfigurator.Sections.Add(scaleSection) NChartControl1.Refresh()

Visual Basic

Copy Code

Dim chart As NCartesianChart = NChartControl1.Charts(0)

' create the scale section
Dim scaleSection As New NScaleSectionStyle
scaleSection.Range = New NRange1DD(2, 8)

' display the range on the back wall
scaleSection.SetShowAtWall(ChartWallType.Back, True)
scaleSection.RangeFillStyle = New NColorFillStyle(Color.FromArgb(125, Color.Red))

' alter the major and minor grid stroke style if lines fall in the range [2, 8]
scaleSection.MajorGridStrokeStyle = New NStrokeStyle(Color.Red)
scaleSection.MajorTickStrokeStyle = New NStrokeStyle(Color.DarkRed)
scaleSection.MinorTickStrokeStyle = New NStrokeStyle(1, Color.Red, LinePattern.Dot, 2)

' alter the text style of the automatic labels
Dim labelStyle As New NTextStyle
labelStyle.FillStyle = New NGradientFillStyle(Color.Red, Color.DarkRed)
labelStyle.FontStyle.Style = FontStyle.Bold
scaleSection.LabelTextStyle = labelStyle

' add the scale section to the primary X axis
Dim primaryX As NAxis = chart.Axis(StandardAxis.PrimaryX)
Dim scaleConfigurator As NStandardScaleConfigurator = CType(primaryX.ScaleConfigurator, NStandardScaleConfigurator)
scaleConfigurator.Sections.Add(scaleSection)

NChartControl1.Refresh()

Related Examples

Windows Forms: Axes \ General \ Sections