getitems(1F) — AMIX 1.1



getitems(1F)      MISC. REFERENCE MANUAL PAGES       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.

EXAMPLE
     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

     Note that because lininfo is defined  for  the  second  menu
     item,  its  value  is  displayed instead of the value of the
     name descriptor.















    Last change: Form and Menu Language Interpreter Utilities   1
Museum
