Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 18 - QuickDraw 3D Pointing Device Manager / QuickDraw 3D Pointing Device Manager Reference

QuickDraw 3D Pointing Device Manager Routines / Creating and Managing Trackers

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.

Note

The controllerRef parameter is used only by the tracker's notify function.