L_DISABLE

Disable a list

WSupported on Windows
USupported on Unix
VSupported on OpenVMS
NSupported in Synergy .NET
xcall L_DISABLE(list_id)

Arguments

list_id

The ID of the list to disable. (n)

Discussion

L_DISABLE disables a list.

The current rendition for the scroll bars remains in effect whether the list is enabled or disabled.

On Windows, there is no visual difference between enabled and disabled lists. Both use the same Windows Control Panel setting for background and foreground colors. List renditions are not used on Windows except for the header (D_RND_LST_HDR) and footer (D_RND_LST_FTR) on Toolkit (non-ActiveX) lists.

On Unix and OpenVMS, a disabled list is distinguished from an enabled list by a change in renditions. When an enabled list is disabled, its body, border, title, and selected item take on new renditions. The following renditions apply:

D_RND_LST_DSA

Disabled list body, border, and title

D_RND_LST_DSA_S

Selected item in disabled list

D_RND_LST_FTR

Footer

D_RND_LST_HDR

Header

Examples

The following example disables the list whose ID is stored in order_lst.

xcall l_disable(order_lst)