Carbon


Control Features Constants

Header: Controls.h

enum {
    kControlSupportsGhosting = 1,
    kControlSupportsEmbedding = 2,
    kControlSupportsFocus = 4,
    kControlWantsIdle = 8,
    kControlWantsActivate = 16,
    kControlHandlesTracking = 32,
    kControlSupportsDataAccess = 64,
    kControlHasSpecialBackground = 128,
    kControlGetsFocusOnClick = 256,
    kControlSupportsCalcBestRect = 512,
    kControlSupportsLiveFeedback = 1024,
    kControlHasRadioBehavior = 2048,
    kControlSupportsDragAndDrop = 4096,
    kControlAutoToggles = 16384,
    kControlSupportsGetRegion = 131072,
    kControlSupportsFlattening = 524288,
    kControlSupportsSetCursor = 1048576,
    kControlSupportsContextualMenus = 2097152,
    kControlSupportsClickActivation = 4194304
};

Constant descriptions

kControlSupportsGhosting

If this bit (bit 0) is set, the control definition function supports the kControlMsgDrawGhost message.

kControlSupportsEmbedding

If this bit (bit 1) is set, the control definition function supports the kControlMsgSubControlAdded and kControlMsgSubControlRemoved messages.

kControlSupportsFocus

If this bit (bit 2) is set, the control definition function supports the kControlMsgKeyDown message. If this bit and the kControlGetsFocusOnClick bit are set, the control definition function supports the kControlMsgFocus message.

kControlWantsIdle

If this bit (bit 3) is set, the control definition function supports the kControlMsgIdle message.

kControlWantsActivate

If this bit (bit 4) is set, the control definition function supports the kControlMsgActivate message.

kControlHandlesTracking

If this bit (bit 5) is set, the control definition function supports the kControlMsgHandleTracking message.

kControlSupportsDataAccess

If this bit (bit 6) is set, the control definition function supports the kControlMsgGetData and kControlMsgSetData messages.

kControlHasSpecialBackground

If this bit (bit 7) is set, the control definition function supports the kControlMsgSetUpBackground message.

kControlGetsFocusOnClick

If this bit (bit 8) and the kControlSupportsFocus bit are set, the control definition function supports the kControlMsgFocus message.

kControlSupportsCalcBestRect

If this bit (bit 9) is set, the control definition function supports the kControlMsgCalcBestRect message.

kControlSupportsLiveFeedback

If this bit (bit 10) is set, the control definition function supports the kControlMsgCalcValueFromPos message.

kControlHasRadioBehavior

If this bit (bit 11) is set, the control definition function supports radio button behavior and can be embedded in a radio group control. This constant is available with Appearance 1.0.1 and later.

kControlSupportsDragAndDrop
kControlAutoToggles

If the bit specified by this mask is set, the control definition function supports automatically changing among various states (on, off, mixed) in response to user actions.

kControlSupportsGetRegion

If the bit specified by this mask is set, the control definition function supports the kControlMsgGetRegion message, described in “Control Definition Message Constants”.

kControlSupportsFlattening
kControlSupportsSetCursor
kControlSupportsContextualMenus
kControlSupportsClickActivation

If your control definition function supports Appearance-compliant messages, it should return a bit field of the features it supports, composed of one or more of these bits.


© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)