![]() |
GetControlDataSize |
||||
Header: | Controls.h | Carbon status: | Supported | |
Obtains the size of a controls tagged data.
OSErr GetControlDataSize ( ControlRef inControl, ControlPartCode inPart, ResType inTagName, Size *outMaxSize );
A handle to the control to be examined.
The part code of the control part with which the data is associated; see
A constant representing the control-specific data whose size is to be obtained; see the data tag constants in the Control Manager Constants section.
On input, a pointer to a Size value. On return, the value is set to the size (in bytes) of the controls tagged data. This value should be passed to SetControlData and GetControlData to allocate a sufficiently large buffer for variable-length data.
A result code. The result code errDataNotSupported indicates that the inTagName parameter is not valid.
Pass the value returned in the outMaxSize parameter of GetControlDataSize in the inBufferSize parameter of SetControlData and GetControlData to allocate an adequate buffer for variable-length data.
This function is available with Appearance Manager 1.0 and later.
Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.
© 2000 Apple Computer, Inc. (Last Updated 5/8/2000)