Legacy Document

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

Version History

This document has had the following releases:

Table A-1 Mac OS 8 Control Manager Reference Revision History

Version

Notes

Nov. 19, 1998 Removed "Control Manager Reference" chapter from the Mac OS 8 Toolbox Reference document. Inside Macintosh: Control Manager Reference is now available as an independent document.
The following corrections were made: MyControlKeyFilterProc . Corrected description of NewControlKeyFilterProc macro--changed NewControlKeyFilterUPP to ControlKeyFilterUPP .

MyUserPaneBackgroundProc . Corrected the function discussion in various ways, including noting the requirements for it to be called.

ControlFontStyleRec . Noted that the bit mask relevant to the style field is kControlUseFaceMask , not kControlUseStyleMask . Specified the actual values that can be used in the just field.

ControlButtonContentInfo . Added description of the iconRef field.

ControlTabInfoRec . Noted that no icon is displayed for the tab label if the specified resource ID is not found.

Control Definition Function Resource. Recategorized from "changed with the Appearance Manager" to "unchanged" and, therefore, removed from this delta document.

Settings Values for Standard Controls . Noted that the control definition function is responsible for resetting values for some controls after the controls are created. Discussed tab control maximum value behavior under Appearance Manager 1.0.1. Clarified mechanism for attaching a non-resource-based menu to a bevel button.

Control Data Tag Constants . Discussed use of the kControlBevelButtonMenuHandleTag constant with the SetControlData function to attach a non-resource-based menu to a bevel button. Noted that the kControlBevelButtonGraphicOffsetTag constant should not be used to set offsets for bevel buttons with IconRef based content.
Bevel Button Menu Constants . Noted that these values must be passed in the minimumValue parameter of the NewControl function, not the initialValue parameter.

Bevel Button and Image Well Content Type Constants . Added description for kControlContentIconRef constant.

Control Part Code Constants . Added discussion of part code scope. Noted allowable ranges for application-defined part codes for custom control definition functions. Also noted that the kControlRadioGroupPart constant is available with Appearance Manager 1.0.2 and later, not Appearance Manager 1.0.1 and later.

Control Variant Constants . Added this section to document the ControlVariant type.

Jan. 15, 1998 The following corrections were made: Noted Appearance 1.0.2 where applicable.
HiliteControl . Recategorized from "not recommended with the Appearance Manager" to "unchanged" and, therefore, removed from this delta document.

Dec. 2, 1997 PDF formatting improved.

Nov. 3, 1997 First document release.

Version	Notes
Nov. 19, 1998	Removed "Control Manager Reference" chapter from the Mac OS 8 Toolbox Reference document. Inside Macintosh: Control Manager Reference is now available as an independent document. The following corrections were made: `MyControlKeyFilterProc` . Corrected description of `NewControlKeyFilterProc` macro--changed `NewControlKeyFilterUPP` to `ControlKeyFilterUPP` . `MyUserPaneBackgroundProc` . Corrected the function discussion in various ways, including noting the requirements for it to be called. `ControlFontStyleRec` . Noted that the bit mask relevant to the `style` field is `kControlUseFaceMask` , not `kControlUseStyleMask` . Specified the actual values that can be used in the `just` field. `ControlButtonContentInfo` . Added description of the `iconRef` field. `ControlTabInfoRec` . Noted that no icon is displayed for the tab label if the specified resource ID is not found. Control Definition Function Resource. Recategorized from "changed with the Appearance Manager" to "unchanged" and, therefore, removed from this delta document. Settings Values for Standard Controls . Noted that the control definition function is responsible for resetting values for some controls after the controls are created. Discussed tab control maximum value behavior under Appearance Manager 1.0.1. Clarified mechanism for attaching a non-resource-based menu to a bevel button.
	Control Data Tag Constants . Discussed use of the `kControlBevelButtonMenuHandleTag` constant with the `SetControlData` function to attach a non-resource-based menu to a bevel button. Noted that the `kControlBevelButtonGraphicOffsetTag` constant should not be used to set offsets for bevel buttons with `IconRef` based content. Bevel Button Menu Constants . Noted that these values must be passed in the `minimumValue` parameter of the `NewControl` function, not the `initialValue` parameter. Bevel Button and Image Well Content Type Constants . Added description for `kControlContentIconRef` constant. Control Part Code Constants . Added discussion of part code scope. Noted allowable ranges for application-defined part codes for custom control definition functions. Also noted that the `kControlRadioGroupPart` constant is available with Appearance Manager 1.0.2 and later, not Appearance Manager 1.0.1 and later. Control Variant Constants . Added this section to document the `ControlVariant` type.
Jan. 15, 1998	The following corrections were made: Noted Appearance 1.0.2 where applicable. `HiliteControl` . Recategorized from "not recommended with the Appearance Manager" to "unchanged" and, therefore, removed from this delta document.
Dec. 2, 1997	PDF formatting improved.
Nov. 3, 1997	First document release.