[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    getitems(1F) manual page Table of Contents

Name

getitems - returns a list of currently marked menu items

Synopsis

getitems [ delimiter_string ]

Availability

SUNWcsu

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

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=gagetitems ":" | messagega

name="Item 1"
action=gamessage "You selected item 1"ga

name="Item 2"
lininfo="This is item 2"
action=gamessage "You selected item 2"ga

name="Item 3"
action=gamessage "You selected item 3"ga

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 descriptor.

Table of Contents