getitems(1F)

NAME

     getitems - returns a list of currently marked menu items

SYNOPSIS

     getitems [delimiter_string]

DESCRIPTION

     The getitems  function  returns  the  value  of  lininfo  if
     defined,  else  it returns the value of the name descriptor,
     for all currently marked menu items. Each value in the  list
     is  delimited  by  delimiter_string.  The  default  value of
     delimiter_string is newline.

EXAMPLES

     Example 1: A sample output of getitems command.

     The done descriptor in the following  menu  definition  file
     executes  getitems  when  the user presses  ENTER (note that
     the menu is multiselect):

     Menu="Example"
     multiselect=TRUE
     done=`getitems ":" | message`
     name="Item 1"
     action=`message "You selected item 1"`
     name="Item 2"
     lininfo="This is item 2"
     action=`message "You selected item 2"`
     name="Item 3"
     action=`message "You selected item 3"`

     If a user marked all three  items  in  this  menu,  pressing
     ENTER  would  cause  the following string to be displayed on
     the message line:

     Item 1:This is item 2:Item 3

NOTES

     Because lininfo is defined for the  second  menu  item,  its
     value is displayed instead of the value of the name descrip-
     tor.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|

SEE ALSO

     attributes(5)