Carbon


Slider Control Definition IDs

Header: ControlDefinitions.h

enum {
    kControlSliderProc = 48,
    kControlSliderLiveFeedback = 1,
    kControlSliderHasTickMarks = 2,
    kControlSliderReverseDirection = 4,
    kControlSliderNonDirectional = 8
};

Constant descriptions

kControlSliderProc

Resource ID: 3

Slider. Your application calls the function SetControlAction to set the last value for the control. This control definition is new with the Appearance Manager and is not supported unless the Appearance Manager is available.

kControlSliderLiveFeedback

(+ kControlSliderProc)

Resource ID: 3

Slider with live feedback. The value of the control is updated automatically by the Control Manager before your action function is called. If no application-defined action function is supplied, the slider draws an outline of the indicator as the user moves it. This control definition is new with the Appearance Manager and is not supported unless the Appearance Manager is available.

kControlSliderHasTickMarks

(+ kControlSliderProc)

Resource ID: 3

Slider with tick marks. The control rectangle must be large enough to include the tick marks. This control definition is new with the Appearance Manager and is not supported unless the Appearance Manager is available.

kControlSliderReverseDirection

(+ kControlSliderProc)

Resource ID: 3

Slider with a directional indicator. The indicator is positioned perpendicularly to the slider; that is, if the slider is horizontal, the indicator points up, and if the slider is vertical, the indicator points left. This control definition is new with the Appearance Manager and is not supported unless the Appearance Manager is available.

kControlSliderNonDirectional

(+ kControlSliderProc)

Resource ID: 3

Slider with a rectangular, non-directional indicator. This variant overrides the kSliderReverseDirection and kSliderHasTickMarks variants. This control definition is new with the Appearance Manager and is not supported unless the Appearance Manager is available.

When creating a control, your application supplies a control definition ID to one of the Control Manager control-creation functions or to the control resource; see 'CNTL'. The control definition ID indicates the type of control to create. A control definition ID is an integer that contains the resource ID of a control definition function in its upper 12 bits and a variation code in its lower 4 bits. A control definition ID is derived as follows:

control definition ID = 16 * ('CDEF' resource ID) + variation code

A control definition function determines how a control generally looks and behaves. Control definition functions are stored as resources of type 'CDEF'. Various Control Manager functions call a control definition function whenever they need to perform some control-dependent action, such as drawing the control on the screen. For more information on how to create a control definition function, see ControlDefProcPtr.

A control definition function, in turn, can use a variation code to describe variations of the same basic control. For example, all pop-up arrows share the same basic control definition function, which is stored in a resource of type 'CDEF' and has a resource ID of 12. The standard pop-up arrow is large and points to the right; it has a control definition ID of 192. A variation of this is a large, left-pointing arrow, which has a control definition ID of 193. Still another variation, in which the arrow points up, has a control definition ID of 194.

Your application can use the constants listed here in place of control definition IDs.


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