2 Handling Viewer Events

2 Q3ViewerEvent

You can use the Q3ViewerEvent function to give the 3D Viewer an opportunity to handle events involving a viewer object.

Boolean Q3ViewerEvent (
TQ3ViewerObject theViewer, 
EventRecord *evt);
theViewer A viewer object.
evt An event record.

DESCRIPTION


The Q3ViewerEvent function returns, as its function result, a Boolean value that indicates whether the event specified by the evt parameter relates to the viewer object specified by the theViewer parameter and was successfully handled (TRUE) or whether that event either does not relate to that viewer object or could not be handled by the 3D Viewer (FALSE). The evt parameter is a pointer to an event record, which you usually obtain by calling the Event Manager function WaitNextEvent.

Q3ViewerEvent can handle most of the events relating to a viewer object. For example, it handles all user events relating to the controller strip displayed with a viewer object. For information on how to handle editing commands in a viewer pane, see "Handling Edit Commands," beginning on page 2-31.

SPECIAL CONSIDERATIONS


You should call Q3ViewerEvent in your main event loop to give the 3D Viewer an opportunity to handle events in a window that relate to a viewer object.

DESCRIPTION
SPECIAL CONSIDERATIONS

3D Graphics Programming with QuickDraw 3D - 16 OCT 1995

© Apple Computer, Inc.

Let us know what you think of these prototype pages.

Generated with Harlequin WebMaker