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


Gets the new position of a view along an axis.
New data view start position.

Syntax

Visual Basic (Declaration)  
Public Property NewPosition As Double
Visual Basic (Usage) Copy Code
Dim instance As ViewEventArgs
Dim value As Double
 
instance.NewPosition = value
 
value = instance.NewPosition
C#  
public double NewPosition {get; set;}

Return Value

An double that represents the position of a view along an axis (the bottom/left position of vertical/horizontal views, respectively).

Example

In this example we limit the view along the Y axis for a chart area named "Chart Area 1".  We assume that the Y axis values are 1, 2, 3, etc., and the user isn't allowed to view any data that has a Y value that is greater than 15. 

C# Copy Code
using Dundas.Charting.WinControl;
...

// Note that events In C# should be added via the Events button In the Properties window, so
//   that the necessary code Is added To InitializeComponent()
Private void chart1_AxisViewChanging(Object sender, Dundas.Charting.WinControl.CursorEventArgs e){

   If(e.ChartArea.Name ==
"Chart Area 1")
   {

       If(e.Axis.Type == AxisName.Y)
       {

           If(e.NewPosition + e.NewSize > 15)
               e.NewSize = 15 - e.NewPosition;
       }
   }
}
Visual Basic Copy Code
Imports Dundas.Charting.WinControl
...

Private Sub chart1_AxisViewChanging(ByVal sender As Object, _
ByVal e As Dundas.Charting.WinControl.CursorEventArgs) Handles chart1.AxisViewChanging

    If e.ChartArea.Name = "Chart Area 1" Then

        If e.Axis.Type = AxisName.Y Then

            If e.NewPosition + e.NewSize > 15 Then
                e.NewSize = 15 - e.NewPosition
        End If
    End If
End Sub

Remarks

This property is exposed in the AxisViewChanged and AxisViewChanging events of the root Chart object, and represents the new position of a view.

The NewPosition property can be set to a new value in the AxisViewChanging event, but cannot be set to a new value for the AxisViewChanged event since the view is already created.

NewPosition is always measured as an axis value.

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.