![]() |
LSize |
||||
Header: | Lists.h | Carbon status: | Supported | |
Changes the size of a list.
void LSize ( SInt16 listWidth, SInt16 listHeight, ListHandle lHandle );
The new width (in pixels) of the lists visible rectangle.
The new height (in pixels) of the lists visible rectangle.
The list whose size is being changed.
This function adjusts the lower-right side of the list so that the lists visible rectangle is the width and height specified by the listWidth and listHeight parameters.
Because the lists visible rectangle does not include room for the scroll bars, your application should make listWidth 15 pixels less than the desired width of the list if it contains a vertical scroll bar, and it should make listHeight 15 pixels less than the desired height of the list if it contains a horizontal scroll bar.
The contents of the list and the scroll bars are adjusted and redrawn as necessary. However, this function does not draw a border around the lists rectangle. Also, it does not erase any portions of the old list that may still be visible. This approach should not be a problem if your application only calls LSize after the user resizes a window containing a list in its lower-right corner.
Usually, you need to call this function only after calling the Window Manager function SizeWindow.
This function is contained in a resource of resource type 'PACK'. Calling it could result in the loading of the package resource and the allocation of memory. Thus, your application should not call this function from within an interrupt, such as in a completion function or VBL task.
Supported in Carbon. Available in CarbonLib 1.0 and later when InterfaceLib 7.1 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.1 and later.