ViewEventArgs Class

.NET Framework (current version)
 

Provides event data that is used as a parameter object in the AxisViewChanged and AxisViewChanging events of the root Chart object.

Namespace:   System.Windows.Forms.DataVisualization.Charting
Assembly:  System.Windows.Forms.DataVisualization (in System.Windows.Forms.DataVisualization.dll)

System.Object
  System.EventArgs
    System.Windows.Forms.DataVisualization.Charting.ViewEventArgs

Public Class ViewEventArgs
	Inherits EventArgs

NameDescription
System_CAPS_pubmethodViewEventArgs(Axis, Double)

Initializes a new instance of the T:System.Windows.Forms.DataVisualization.ViewEventArgs class with the specified axis and newPosition parameters.

System_CAPS_pubmethodViewEventArgs(Axis, Double, Double, DateTimeIntervalType)

Initializes a new instance of the T:System.Windows.Forms.DataVisualization.ViewEventArgs class with the specified axis, newPosition, newSize and newSizeType parameters.

NameDescription
System_CAPS_pubpropertyAxis

Gets the Axis object that a view belongs to.

System_CAPS_pubpropertyChartArea

Gets the ChartArea object that a view belongs to.

System_CAPS_pubpropertyNewPosition

Gets the new position of a view along an axis.

System_CAPS_pubpropertyNewSize

Gets or sets the size of a view along an axis.

System_CAPS_pubpropertyNewSizeType

Gets the unit of measurement for the new size of a view.

NameDescription
System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

This class is exposed as the e parameter in the AxisViewChanged and AxisViewChanging events. The AxisViewChanging event is raised just before a new view is displayed, as a result of the end-user clicking and dragging in a chart area. The AxisViewChanged event is raised just after the new view is created.

It is important to note that the position and size of a view cannot be set in the AxisViewChanged event because in this case the view is already created.

The ViewEventArgs class contains the following properties:

  • The ChartArea property, which is used to get the ChartArea object in which the view is being displayed. The Name property gets the name of the chart area. Other chart area properties can also be set.

  • The Axis property, which is used to get the Axis object with which the view is associated. To determine the type of axis, which can be X, Y, X2 or Y2, use the AxisName property. Other axis properties can also be set.

  • The NewPosition property, which represents the new position of a view.

  • The NewSize property, which represents the new size of a view.

  • The NewSizeType property, which represents the unit of measurement for the size of a view.

.NET Framework
Available since 4.0

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: