next up previous contents
Next: Internal Functions Up: Function Reference Previous: menu_popup   Contents

menu_show($title,$message,$style)

This provides for splash screens to be shown to the user either reporting difficulties, errors, providing help or asking for confirmation of responses. The routine draws a full window covering the normal menu space (not the backdrop). It accepts three parameters;
$title
Gives the window a title included in the border
$message
provides the actual text message. If this can be fitted onto a single line, it will be centred in the screen. If the text exceeds a single line width, it will be passed through Text::Wrap for formating. Text::Wrap breaks lines at word-boundaries (spaces) and also acknowledges n as a forced new-line character. All lines are left-justified and ragged on the right.
$style
using different colours, a different meaning can be associated with splash screens. Also a simple button bar will be drawn for each type so that users can confirm or reject options as required. Responses from menu_show will be either ``YES'' or ``NO''
``HELP''
uses the help colour scheme (brown on grey); also automatically provides a single button.
``WARN''
uses the warning colour scheme as used by the popup screens (defaults to yellow on green). User definable button bar available (see button_set).
``ERROR''
uses the error colour scheme (white on red) with an active button bar.
Splash screen are exited by pressing any normal key. Usually function keys are rejected.


next up previous contents
Next: Internal Functions Up: Function Reference Previous: menu_popup   Contents
Andy Ferguson (AFC) 2001-10-20