18 Creating and Managing Trackers

18 Q3Tracker_ChangeButtons

You can use the Q3Tracker_ChangeButtons function to change the button state of a tracker.

TQ3Status Q3Tracker_ChangeButtons (
TQ3TrackerObject trackerObject, 
TQ3ControllerRef controllerRef, 
unsigned long buttons, 
unsigned long buttonMask);
trackerObject
A tracker object.
controllerRef
A reference to a controller.
buttons The desired button state value of the specified tracker.
buttonMask A button mask.

DESCRIPTION


The Q3Tracker_ChangeButtons function sets the button state of the tracker specified by the trackerObject parameter to the value specified in the buttons parameter. The buttonMask parameter specifies a button mask for the tracker. A bit in the mask should be set if the corresponding button has changed since the last call to Q3Tracker_ChangeButtons.

The notify function of the specified tracker object may be called when the Q3Tracker_ChangeButtons function is executed. If, however, the tracker is inactive when Q3Tracker_ChangeButtons is called, the tracker's activation count for the buttons is updated but the notify function is not called.

The controllerRef parameter is used only by the tracker's notify function.<8bat>u

DESCRIPTION

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

© Apple Computer, Inc.

Let us know what you think of these prototype pages.

Generated with Harlequin WebMaker