![]() |
Bevel Button Control Data Tag Constants |
Header: ControlDefinitions.h |
enum { kControlBevelButtonContentTag = ''cont'', kControlBevelButtonTransformTag = ''tran'', kControlBevelButtonTextAlignTag = ''tali'', kControlBevelButtonTextOffsetTag = ''toff'', kControlBevelButtonGraphicAlignTag = ''gali'', kControlBevelButtonGraphicOffsetTag = ''goff'', kControlBevelButtonTextPlaceTag = ''tplc'', kControlBevelButtonMenuValueTag = ''mval'', kControlBevelButtonMenuHandleTag = ''mhnd'', kControlBevelButtonMenuRefTag = ''mhnd'', kControlBevelButtonCenterPopupGlyphTag = ''pglc'' };
Gets or sets a bevel buttons content type for drawing; see
Data type returned or set: ControlButtonContentInfo structure
Gets or sets a transform that is added to the standard transform of a bevel button
Data type returned or set: IconTransformType
Gets or sets the alignment of text in a bevel button; see
Data type returned or set: ControlButtonTextAlignment
Gets or sets the number of pixels that text is offset in a bevel button from the buttons left or right edge; this is used with left, right, or system justification, but it is ignored when the text is center aligned.
Data type returned or set: SInt16
Gets or sets the alignment of graphics in a bevel button in relation to any text the button may contain; see
Data type returned or set: ControlButtonGraphicAlignment
Gets or sets the horizontal and vertical amounts that a graphic element contained in a bevel button is offset from the buttons edges; this value is ignored when the graphic is specified to be center aligned on the button. Note that offset values should not be used for bevel buttons with content of type kControlContentIconRef, because IconRef based icons may change with a theme switch; see
Data type returned or set: point
Gets or sets the placement of a bevel buttons text; see
Data type returned or set: ControlButtonTextPlacement
Gets the menu value for a bevel button with an attached menu; see
Data type returned: SInt16
Gets or sets the menu handle for a bevel button with an attached menu. To set a non-resource-based menu for a bevel button, you must pass in a non-zero value in the 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.
Data type returned: MenuHandle
Gets or sets the position of the pop-up arrow in a bevel button when a pop-up menu is attached.
Data type returned or set: Boolean; if true, glyph is vertically centered on the right; if false, glyph is on the bottom right.
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 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
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.
The control data tag constants are available with Appearance Manager 1.0 and later.
© 2000 Apple Computer, Inc. (Last Updated 5/8/2000)