CNiAxes3D

3D Graph

previous page next page
Class CNiAxes3D Base ClassesData ItemsConstructorsDestructorsFunctionsGo to hierarchy chart    Prev page: operator =Next page: Count    
Class Declared in:
 NiAxes3d.h

'Overview' icon -- Shortcut to top of page. Overview

A CNiAxes3D object is a collection of axes on a 3D graph control. This collection always contains one x axis, one y axis, and one z axis.

  • Use CNiGraph3D::Axes to obtain an axis collection for the graph.
  • Use the Item function to access existing axes in the collection. This function can access axes by either name or index.

The default axis names are shown below.

  • XAxis
  • YAxis
  • ZAxis

The associated indices are shown below.

  • 1 - X Axis
  • 2 - Y Axis
  • 3 - Z Axis

Hierarchy Chart Hierarchy Chart

'Base Classes' icon -- Shortcut to top of page. Base Classes

Public base class CNiInterface

'Data Items' icon -- Shortcut to top of page. Data Items

Public data short Count The number of axes in the collection.

'Constructors' icon -- Shortcut to top of page. Constructors

Public constructor

CNiAxes3D()

 Default constructor.
Public constructor

CNiAxes3D( CWAxes3D_CI* pCustom, CNiInterface::ThreadAccess option )

 Constructor that attaches to the specified CWAxes3D_CI pointer.
Public constructor

CNiAxes3D( const CNiAxes3D& source )

 Copy constructor.

'Destructors' icon -- Shortcut to top of page. Destructors

Public destructor

~CNiAxes3D()

 Destructor.

'Functions' icon -- Shortcut to top of page. Functions

Public function static const IID &

GetIid()

 Returns the globally unique identifier (GUID) of the ActiveX interface to which this class connects.
Public function CNiAxis3D

Item( long axisIndex )

 Returns the specified axis from the collection.
Public function CNiAxis3D

Item( const CString& axisName )

 Returns the specified axis from the collection.
Public function const CNiAxes3D &

operator =( const CNiAxes3D& source )

 Assignment operator.

Shortcut to top of page. Examples

1. Set the caption to "Temperature" and the visibility to true on the z axis.

    CNiGraph3D myGraph;
    CNiAxis xAxis = myGraph.Axes.Item("ZAxis");
    zAxis.Caption = "Temperature";
    zAxis.Visible = true;

2. Set the range of the y axis on the graph from 0 to 100.

    CNiGraph3D myGraph;
    myGraph.Axes.Item(2).SetMinMax(0, 100);

3. Change the name of the x axis to "Time".

    CNiGraph3D myGraph;
    myGraph.Axes.Item("XAxis").Name = "Time";

Subsequent accesses to X Axis must now use "Time" as the item name. For example,

    myGraph.Axes.Item("Time").Visible = true;
previous page start next page