Legacy Document

Inside Macintosh: More Macintosh Toolbox /

Chapter 4 - List Manager / List Manager Reference

List Manager Routines / Modifying a List's Appearance

LSetDrawingMode

You can use the LSetDrawingMode procedure to change the automatic drawing mode specified when creating a list. The LSetDrawingMode procedure is also available as the LDoDraw procedure.

PROCEDURE LSetDrawingMode (drawIt: Boolean; lHandle: ListHandle);

drawIt

A Boolean value that indicates whether the List Manager should enable the automatic drawing mode. Specify TRUE to enable the automatic drawing mode. Specify FALSE to disable the automatic drawing mode.

lHandle

The list whose drawing mode is being changed.

DESCRIPTION

The LSetDrawingMode procedure sets the List Manager's drawing mode for the list specified by the lHandle parameter to the state specified by the drawIt parameter.

While the automatic drawing mode is turned off, all cell drawing and highlighting
are disabled, and the scroll bar does not function properly. Thus, your application should disable the automatic drawing mode only for short periods of time. After enabling it, your application should ensure that the list is redrawn.

SPECIAL CONSIDERATIONS

You should not call the LSetDrawingMode procedure from within an interrupt, such as in a completion routine or VBL task.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the LSetDrawingMode procedure are

Trap macro	Selector
_Pack0	$002C

SEE ALSO

For an example that disables and then reenables the automatic drawing mode, see "Adding Rows and Columns to a List" beginning on page 4-21.