Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

PATHDocumentation > Mac OS 8 and 9 > Human Interface Toolbox > Control Manager >

Mac OS 8 Control Manager Reference

Settings Values for Standard Controls

This section lists the initial, minimum, and maximum settings for all standard controls. You can use these values in the control resource when creating a new control from a resource or with the function NewControl . Note that some controls specify other information besides their range in their minimum and maximum settings. For example, bevel buttons use the high byte of their minimum value to indicate their behavior.


Control Values

Push button (pre-Appearance)
Initial: 0
Minimum: 0
Maximum: 1
Push button (Appearance-compliant)
Initial: 0
Minimum: 0
Maximum: 1
Checkbox (pre-Appearance)
Initial: kControlCheckboxUncheckedValue
Minimum: kControlCheckboxUncheckedValue
Maximum: kControlCheckboxCheckedValue
Checkbox (Appearance-compliant)
Initial: kControlCheckboxUncheckedValue
Minimum: kControlCheckboxUncheckedValue
Maximum: kControlCheckboxCheckedValue or kControlCheckboxMixedValue
Radio button (pre-Appearance)
Initial: kControlRadioButtonUncheckedValue
Minimum: kControlRadioButtonUncheckedValue
Maximum: kControlRadioButtonCheckedValue
Radio button (Appearance-compliant)
Initial: kControlRadioButtonUncheckedValue
Minimum: kControlRadioButtonUncheckedValue
Maximum: kControlRadioButtonCheckedValue or kControlRadioButtonMixedValue
Scroll bar (pre-Appearance and Appearance-compliant versions)
Initial: Appropriate value between -32768 and 32768.
Minimum: -32768 to 32768
Maximum: -32768 to 32768; when the maximum setting is equal to the minimum setting, the scroll bar is inactive.
Bevel button
Initial: If you wish to attach a resource-based menu, the menu's resource ID. If you wish to attach a non-resource-based menu, you must pass in a non-zero initial value, then call the SetControlData function with the kControlBevelButtonMenuHandleTag control data tag constant and the return value from a call to the NewMenu function. If no menu is to be attached, 0.
Minimum: High byte specifies behavior; see Bevel Button Behavior Constants and Bevel Button Menu Constants . Low byte specifies content type; see Bevel Button and Image Well Content Type Constants .
Maximum: Resource ID of bevel button's content if resource-based; see Bevel Button and Image Well Content Type Constants .
Slider
Initial: Appropriate value between -32768 and 32768; for tick mark variant, the number of ticks. The control definition function resets this value to the minimum setting once the slider is created.
Minimum: -32768 to 32768
Maximum: -32768 to 32768; when the maximum setting is equal to the minimum setting, the slider is inactive.
Disclosure triangle
Initial: 0 (collapsed) or 1 (expanded)
Minimum: 0 (collapsed)
Maximum: 1 (expanded)
Progress indicator
Initial: Appropriate value between -32768 and 32768.
Minimum: -32768 to 32768
Maximum: -32768 to 32768
Little arrows
Initial: Appropriate value between -32768 and 32768.
Minimum: -32768 to 32768
Maximum: -32768 to 32768
Asynchronous arrows
Initial: Reserved. Set to 0.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.
Tab control
Initial: Resource ID of the 'tab#' resource you are using to hold tab information. The control definition function resets this value to the minimum setting once the tab control is created. Under Appearance 1.0.1 and later, a value of 0 indicates not to read a 'tab#' resource; see ControlTabInfoRec .
Minimum: Ignored. The control definition function resets this value to 1 once the tab control is created.
Maximum: Under Appearance 1.0, the maximum value is ignored. Under Appearance 1.0.1, the maximum value specifies the number of tabs in the tab control.
Separator line
Initial: Reserved. Set to 0.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.
Primary group box and secondary group box
Initial: Ignored if group box has text title. If the group box has a checkbox or pop-up button title, same value as the checkbox or pop-up button.
Minimum: Ignored if group box has text title. If the group box has a checkbox or pop-up button title, same minimum setting as the checkbox or pop-up button.
Maximum: Ignored if group box has text title. If the group box has a checkbox or pop-up button title, same maximum setting as the checkbox or pop-up button.
Image well
Initial: Resource ID of the image well's content, if the content type specified in the minimum value is resource-based. The control definition function resets this value to 0 once the image well is created.
Minimum: Low byte specifies content type; see Bevel Button and Image Well Content Type Constants . The control definition function resets this value to 0 once the image well is created.
Maximum: Ignored. The control definition function resets this value to 2 once the image well is created.
Pop-up arrow
Initial: Reserved. Set to 0.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.
Placard
Initial: Reserved. Set to 0.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.
Clock
Initial: One or more of the clock value flags; see Clock Value Flag Constants . The control definition function resets this value to 0 once the clock is created.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.
User pane
Initial: One or more of the control feature constants; see Specifying Which Appearance-Compliant Messages Are Supported . The control definition function resets this value to 0 once the user pane is created.
Minimum: Ignored. The control definition function resets this value to a setting between -32768 to 32768 once the user pane is created.
Maximum: Ignored. The control definition function resets this value to a setting between -32768 to 32768 once the user pane is created.
Editable text field
Initial: Reserved. Set to 0.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.
Static text field
Initial: Reserved. Set to 0.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.
Picture
Initial: Resource ID of the 'pict' resource you wish to display. The control definition function resets this value to 0 once the picture control is created.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.
Icon
Initial: Resource ID of the 'cicn' , 'ICON' , or icon suite resource you wish to display. For icon suite variant, it only looks for an icon suite. If not, it looks for a 'cicn' or 'ICON' resource. The control definition function resets this value to 0 once the icon control is created.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.
Window header
Initial: Reserved. Set to 0.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.
List box
Initial: Resource ID of the 'ldes' resource you are using to hold list box information. The control definition function resets this value to 0 once the list box is created. An initial value of 0 indicates not to read an 'ldes' resource under Appearance 1.0.1 and later.
Minimum: Reserved. Set to 0.
Maximum: Reserved. Set to 0.
Pop-up menu (pre-Appearance and Appearance-compliant versions)
Initial: One or more of the pop-up menu title constants.
Minimum: Resource ID of the 'MENU' resource.
Maximum: Width (in pixels) of the pop-up menu title.
Radio group
Initial: Set to 0 on creation. The control definition function resets this value to the index of the currently selected embedded radio button control once the radio group is created. If currently selected control does not support radio behavior, value will be set to 0 and the control will be deselected. To deselect all controls, set to 0.
Minimum: Set to 0.
Maximum: Set to 0 on creation. The control definition function resets this value to the number of embedded controls as controls are added.
\xA9 1998 Apple Computer, Inc. – (Last Updated 19 Nov 98)