Legacy Document
Important: The information in this document is obsolete and should not be used for new development.
Important: The information in this document is obsolete and should not be used for new development.
PATH Documentation > Mac OS 8 and 9
> Human Interface Toolbox
> Control Manager
>
|
Mac OS 8 Control Manager Reference
|
You can use the control data tag constants to set or obtain data that is associated with a control. The control data tag constants are passed in the inTagName
parameters of SetControlData
and GetControlData
to specify the piece of data in a control that you wish to set or get. You can also pass these constants in the inTagName
parameter of GetControlDataSize
if you wish to determine the size of variable-length control data (e.g., text in an editable text control). These constants can also be used by custom control definition functions that return the feature bit kControlSupportsDataAccess
in response to a kControlMsgGetFeatures
message. The control data tag constants are available with Appearance Manager 1.0 and later.
The data that your application sets or obtains can be of various types, dependent upon the control. Therefore, the descriptions of the control data tag constants list the data types for the information that you can set in the inData
parameter to the SetControlData
function and that you can get in the inBuffer
parameter to the GetControlData
function.
enum {
kControlPushButtonDefaultTag = ('dflt'),
kControlBevelButtonContentTag = ('cont'),
kControlBevelButtonTransformTag = ('tran'),
kControlBevelButtonTextAlignTag = ('tali'),
kControlBevelButtonTextOffsetTag = ('toff'),
kControlBevelButtonGraphicAlignTag = ('gali'),
kControlBevelButtonGraphicOffsetTag = ('goff'),
kControlBevelButtonTextPlaceTag = ('tplc'),
kControlBevelButtonMenuValueTag = ('mval'),
kControlBevelButtonMenuHandleTag = ('mhnd'),
kControlBevelButtonCenterPopupGlyphTag = ('pglc'),
kControlTriangleLastValueTag = ('last'),
kControlProgressBarIndeterminateTag = ('inde'),
kControlTabContentRectTag = ('rect'),
kControlTabEnabledFlagTag = ('enab'),
kControlTabInfoTag = ('tabi'),
kControlGroupBoxMenuHandleTag = ('mhan'),
kControlImageWellContentTag = ('cont'),
kControlImageWellTransformTag = ('tran'),
kControlClockLongDateTag = ('date'),
kControlUserItemDrawProcTag = ('uidp'),
kControlUserPaneDrawProcTag = ('draw'),
kControlUserPaneHitTestProcTag = ('hitt'),
kControlUserPaneTrackingProcTag = ('trak'),
kControlUserPaneIdleProcTag = ('idle'),
kControlUserPaneKeyDownProcTag = ('keyd'),
kControlUserPaneActivateProcTag = ('acti'),
kControlUserPaneFocusProcTag = ('foci'),
kControlUserPaneBackgroundProcTag = ('back'),
kControlEditTextTextTag = ('text'),
kControlEditTextTEHandleTag = ('than'),
kControlEditTextSelectionTag = ('sele'),
kControlEditTextPasswordTag = ('pass'),
kControlStaticTextTextTag = ('text'),
kControlStaticTextTextHeightTag = ('thei'),
kControlIconTransformTag = ('trfm'),
kControlIconAlignmentTag = ('algn'),
kControlListBoxListHandleTag = ('lhan'),
kControlFontStyleTag = ('font'),
kControlKeyFilterTag = ('fltr'),
kControlBevelButtonLastMenuTag = ('lmnu'),
kControlBevelButtonMenuDelayTag = ('mdly'),
kControlPopupButtonMenuHandleTag = ('mhan'),
kControlPopupButtonMenuIDTag = ('mnid'),
kControlListBoxDoubleClickTag = ('dblc'),
kControlListBoxLDEFTag = ('ldef')
};
kControlPushButtonDefaultTag
Boolean
kControlBevelButtonContentTag
ControlButtonContentInfo
structurekControlBevelButtonTransformTag
IconTransformType
kControlBevelButtonTextAlignTag
ControlButtonTextAlignment
kControlBevelButtonTextOffsetTag
SInt16
kControlBevelButtonGraphicAlignTag
ControlButtonGraphicAlignment
kControlBevelButtonGraphicOffsetTag
kControlContentIconRef
, because IconRef
based icons may change with a theme switch; see Bevel Button and Image Well Content Type Constants
.point
kControlBevelButtonTextPlaceTag
ControlButtonTextPlacement
kControlBevelButtonMenuValueTag
SInt16
kControlBevelButtonMenuHandleTag
initialValue
parameter of the NewControl
function, then call the SetControlData
function with the kControlBevelButtonMenuHandleTag
constant and the return value from a call to the NewMenu
function.MenuHandle
kControlBevelButtonCenterPopUpGlyphTag
Boolean
; if true
, glyph is vertically centered on the right; if false
, glyph is on the bottom right.kControlTriangleLastValueTag
SInt16
kControlProgressBarIndeterminateTag
Boolean
; if true
, switches to an indeterminate progress indicator; if false
, switches to an determinate progress indicator.kControlTabContentRectTag
Rect
kControlTabEnabledFlagTag
Boolean
; if true
, enabled; if false
, disabled.kControlTabInfoTag
ControlTabInfoRec
.kControlGroupBoxMenuHandleTag
MenuHandle
kControlImageWellContentTag
ControlButtonContentInfo
structurekControlImageWellTransformTag
IconTransformType
kControlClockLongDateTag
LongDateRec
structurekControlUserItemDrawProcTag
UserItemUPP
kControlUserPaneDrawProcTag
ControlUserPaneDrawingUPP
kControlUserPaneHitTestProcTag
ControlUserPaneHitTestUPP
kControlUserPaneTrackingProcTag
kControlHandlesTracking
feature bit in response to a kControlMsgGetFeatures
message. Indicates that a user pane handles its own tracking; see MyUserPaneTrackingProc
.ControlUserPaneTrackingUPP
kControlUserPaneIdleProcTag
kControlWantsIdle
feature bit in response to a kControlMsgGetFeatures
message. Indicates that a user pane performs idle processing; see MyUserPaneIdleProc
.ControlUserPaneIdleUPP
kControlUserPaneKeyDownProcTag
kControlSupportsFocus
feature bit in response to a kControlMsgGetFeatures
message. Indicates that a user pane performs keyboard event processing; see MyUserPaneKeyDownProc
.ControlUserPaneKeyDownUPP
kControlUserPaneActivateProcTag
kControlWantsActivate
feature bit in response to a kControlMsgGetFeatures
message. Indicates that a user pane wants to be informed of activate and deactivate events; see MyUserPaneActivateProc
.ControlUserPaneActivateUPP
kControlUserPaneFocusProcTag
kControlSupportsFocus
feature bit in response to a kControlMsgGetFeatures
message. Indicates that a user pane handles keyboard focus; see MyUserPaneFocusProc
.ControlUserPaneFocusUPP
kControlUserPaneBackgroundProcTag
kControlHasSpecialBackground
and kControlSupportsEmbedding
feature bits in response to a kControlMsgGetFeatures
message. Indicates that a user pane can set its background color or pattern; see MyUserPaneBackgroundProc
.ControlUserPaneBackgroundUPP
kControlEditTextTextTag
kControlEditTextTEHandleTag
TEHandle
kControlEditTextSelectionTag
ControlEditTextSelectionRec
structurekControlEditTextPasswordTag
kControlStaticTextTextTag
character bufferkControlStaticTextTextHeightTag
SInt16
kControlIconTransformTag
IconTransformType
kControlIconAlignmentTag
IconAlignmentType
kControlListBoxListHandleTag
ListHandle
kControlFontStyleTag
Gets or sets the font style for controls that support text (includes list box, tab, clock, static and editable text).kControlFontStyleTag
kControlKeyFilterTag
ControlKeyFilterUPP
kControlBevelButtonLastMenuTag
SInt16
kControlBevelButtonMenuDelayTag
SInt32
kControlPopupButtonMenuHandleTag
MenuHandle
kControlPopupButtonMenuIDTag
SInt16
kControlListBoxDoubleClickTag
Boolean
; if true
, the last click was a double click; if false
, not.kControlListBoxLDEFTag
'LDEF'
resource to be used to draw a list box's contents; this is useful for creating a list box without an 'ldes'
resource. Available with Appearance 1.0.1 and later.
SInt16