cl_up()

Displays a choice list

Call  
#include <vv_clist.h>
int cl_up(clistp)

CLISTPTR clistp

Choice list to display

Returns  
1 The choice list was successfully displayed
0 Error. VV_ERR is set to one of the following:
  KWDNOTFOUND

ERRREAD

FILETOOBIG

The keyword marking the choice list was not found in the memory file.

An error occurred while trying to read the memory file.

The keyworded section used by the choice list is too large to fit in the memory file.

Description

If the choice list is already on the screen, cl_up() returns immediately. Otherwise mf_kwdset() is called to set the memory file to operate within the appropriate keyworded section, the choice list window is set, and the choice list displayed with mf_disp()

If a keyword was set prior to calling this function, the memory file is restored so that it operates on the keyworded section that was active when cl_up() was called.

Related Functions

cl_dn(), cl_proc()


Home Contents Previous Next