Keywords: Cmenu

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: Internal Functions Up: Function Reference Previous: menu_popup Contents