Carbon


ControlGetRegionRec

Header: Controls.h

struct ControlGetRegionRec {
    RgnHandle region; 
    ControlPartCode part;
};
typedef ControlGetRegionRec ControlGetRegionPtr;

Field descriptions

region

A value allocated by the Control Manager. Your control definition function should set this field to the region that contains the control part specified in the part field.

part

The Control Manager passes a constant identifying the control part for which a region is to be obtained. For descriptions of possible values, see “Meta Control Part Code Constants”, “Control Part Code Constants”, and “Control State Part Code Constants”.

If you implement a custom control definition function, when the Control Manager passes the message kControlMsgGetRegion in your control definition function’s message parameter, it also passes a pointer to a structure of type ControlGetRegionRec in the param parameter. Your control definition function is responsible for setting the region field of the ControlGetRegionRec structure to the region that contains the control part which the Control Manager specifies in the part field.

See “Control Definition Message Constants” for more details on the kControlMsgGetRegion message.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)