Museum

   getitems(1F)  (Form and Menu Language Interpreter Utilities)   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.


















   7/91                                                                 Page 1