Graph3D Events

3D Graph

previous page next page

Graph3D Events

Function Group

Declared in:
NiGraph3DEvents.h

Overview

The Measurement Studio 3D graph control generates a variety of events in response to user input or changes in properties that are bound to a DataSocket source.

Complete the following steps to add an event handler for a particular event generated by the 3D graph control.

1. Edit a dialog resource and add a Measurement Studio 3D graph control to the dialog.

2. Right-click on the 3D graph control and select Events.

3. Select the appropriate event to handle and select Add and Edit. By default, this creates a new member function for which the name has the form shown below.

On[eventName][objectIdSuffix]

To help you find the appropriate online help, the components of the member function name are described below.

eventName is the event name.
objectIdSuffix is the last part of the ID assigned to the control.

For example, if you have a 3D graph control for which the ID is IDC_CWGRAPH3D1 and you want to add a handler for the Click event. The default member function name created by the ClassWizard is OnClickCwgraph3d1.

4. Click OK to add and edit the new event handler. Notice that the prototype of the member function matches the corresponding event listed below. You can select this link to get additional information regarding the event.

Note: Various 3D graph events pass COM VARIANT data types as parameters to the event handler. Measurement Studio includes the CNiVariant class, which provides a convenient interface for managing these VARIANT data types. Refer to the documentation for each event for further information.

Functions void OnClick() Generated when you click the mouse on the control. void OnCursorChange( long FAR* CursorIndex, double FAR* XPosition, double FAR* YPosition, double FAR* ZPosition, BOOL FAR* Tracking ) Generated when you reposition a cursor with the mouse. void OnDblClick() Generated when you double-click the mouse on the control. void OnKeyDown( short FAR* KeyCode, short Shift ) Generated when you press a key while the control has the input focus. void OnKeyPress( short FAR* KeyAscii ) Generated when a KeyDown message generates a key while a control is active. void OnKeyUp( short FAR* KeyCode, short Shift ) Generated when you release a key while the control has the input focus. void OnMouseDown( short Button, short Shift, long X, long Y ) Generated when you click the mouse on the control. void OnMouseMove( short Button, short Shift, long X, long Y ) Generated when you move the mouse over the control. void OnMouseUp( short Button, short Shift, long X, long Y ) Generated when you release the mouse on the control. void OnPan( VARIANT FAR* NewXCenter, VARIANT FAR* NewYCenter, VARIANT FAR* NewZCenter ) Generated when you pan the graph up and down or left and right. void OnPlotAreaMouseDown( short FAR* Button, short FAR* Shift, VARIANT FAR* XNear, VARIANT FAR* YNear, VARIANT FAR* ZNear, VARIANT FAR* XFar, VARIANT FAR* YFar, VARIANT FAR* ZFar ) Generated when you click the mouse on the plot area. void OnPlotAreaMouseMove( short FAR* Button, short FAR* Shift, VARIANT FAR* XNear, VARIANT FAR* YNear, VARIANT FAR* ZNear, VARIANT FAR* XFar, VARIANT FAR* YFar, VARIANT FAR* ZFar ) Generated when you move the mouse over the plot area. void OnPlotAreaMouseUp( short FAR* Button, short FAR* Shift, VARIANT FAR* XNear, VARIANT FAR* YNear, VARIANT FAR* ZNear, VARIANT FAR* XFar, VARIANT FAR* YFar, VARIANT FAR* ZFar ) Generated when you release the mouse over the plot area. void OnPlotMouseDown( short FAR* Button, short FAR* Shift, VARIANT FAR* XData, VARIANT FAR* YData, VARIANT FAR* ZData, short FAR* PlotIndex, long FAR* PointI, long FAR* PointJ ) Generated when you click the mouse on a plot. void OnPlotMouseMove( short FAR* Button, short FAR* Shift, VARIANT FAR* XData, VARIANT FAR* YData, VARIANT FAR* ZData, short FAR* PlotIndex, long FAR* PointI, long FAR* PointJ ) Generated when you move the mouse over a plot. void OnPlotMouseUp( short FAR* Button, short FAR* Shift, VARIANT FAR* XData, VARIANT FAR* YData, VARIANT FAR* ZData, short FAR* PlotIndex, long FAR* PointI, long FAR* PointJ ) Generated when you release the mouse over a plot. void OnReadyStateChange() Generated when the ready state changes. void OnRotate( VARIANT FAR* NewLatitude, VARIANT FAR* NewLongitude ) Generated when you rotate the graph. void OnZoom( VARIANT FAR* NewDistance ) Generated when you zoom in or out on the plot.

previous page start next page

void	OnClick()	Generated when you click the mouse on the control.
void	OnCursorChange( long FAR* CursorIndex, double FAR* XPosition, double FAR* YPosition, double FAR* ZPosition, BOOL FAR* Tracking )	Generated when you reposition a cursor with the mouse.
void	OnDblClick()	Generated when you double-click the mouse on the control.
void	OnKeyDown( short FAR* KeyCode, short Shift )	Generated when you press a key while the control has the input focus.
void	OnKeyPress( short FAR* KeyAscii )	Generated when a `KeyDown` message generates a key while a control is active.
void	OnKeyUp( short FAR* KeyCode, short Shift )	Generated when you release a key while the control has the input focus.
void	OnMouseDown( short Button, short Shift, long X, long Y )	Generated when you click the mouse on the control.
void	OnMouseMove( short Button, short Shift, long X, long Y )	Generated when you move the mouse over the control.
void	OnMouseUp( short Button, short Shift, long X, long Y )	Generated when you release the mouse on the control.
void	*OnPan( VARIANT FAR NewXCenter, VARIANT FAR* NewYCenter, VARIANT FAR* NewZCenter )**	Generated when you pan the graph up and down or left and right.
void	OnPlotAreaMouseDown( short FAR* Button, short FAR* Shift, VARIANT FAR* XNear, VARIANT FAR* YNear, VARIANT FAR* ZNear, VARIANT FAR* XFar, VARIANT FAR* YFar, VARIANT FAR* ZFar )	Generated when you click the mouse on the plot area.
void	OnPlotAreaMouseMove( short FAR* Button, short FAR* Shift, VARIANT FAR* XNear, VARIANT FAR* YNear, VARIANT FAR* ZNear, VARIANT FAR* XFar, VARIANT FAR* YFar, VARIANT FAR* ZFar )	Generated when you move the mouse over the plot area.
void	OnPlotAreaMouseUp( short FAR* Button, short FAR* Shift, VARIANT FAR* XNear, VARIANT FAR* YNear, VARIANT FAR* ZNear, VARIANT FAR* XFar, VARIANT FAR* YFar, VARIANT FAR* ZFar )	Generated when you release the mouse over the plot area.
void	OnPlotMouseDown( short FAR* Button, short FAR* Shift, VARIANT FAR* XData, VARIANT FAR* YData, VARIANT FAR* ZData, short FAR* PlotIndex, long FAR* PointI, long FAR* PointJ )	Generated when you click the mouse on a plot.
void	OnPlotMouseMove( short FAR* Button, short FAR* Shift, VARIANT FAR* XData, VARIANT FAR* YData, VARIANT FAR* ZData, short FAR* PlotIndex, long FAR* PointI, long FAR* PointJ )	Generated when you move the mouse over a plot.
void	OnPlotMouseUp( short FAR* Button, short FAR* Shift, VARIANT FAR* XData, VARIANT FAR* YData, VARIANT FAR* ZData, short FAR* PlotIndex, long FAR* PointI, long FAR* PointJ )	Generated when you release the mouse over a plot.
void	OnReadyStateChange()	Generated when the ready state changes.
void	*OnRotate( VARIANT FAR NewLatitude, VARIANT FAR* NewLongitude )**	Generated when you rotate the graph.
void	*OnZoom( VARIANT FAR NewDistance )**	Generated when you zoom in or out on the plot.