[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
VS_Alert()           Question box with multiple buttons

Description:

  VS_Alert() allows you to ask the user a question and have multiple
  buttons for the reply.

Syntax:     

  n_Button = VS_ALERT( ac_TextLines, ac_Buttons, [n_Palette], [n_Row],
  [n_Column] )

Pass:       

  ac_TextLines is an array of character values containing each line
  to be displayed to the user.  Each element of this array is a line of
  text in the VS_ALERT() box.

  ac_Buttons is an array of character values containing the buttons
  that will be available to the user.  Each element of this array is a
  button in the VS_ALERT() box.

  [n_Palette] is an optional palette number to be used for the
  VS_ALERT() box.  If none is specified, the current palette is used.

  [n_Row] is an optional row number to place the top left corner of
  the VS_ALERT() box on.

  [n_Column] is an optional column number to place the top left
  corner of the VS_ALERT() box on.

Return:     

  n_Button is a numeric value representing which button the user
  "pressed".

Notes:      

  VS_ALERT() is non-screen-destructive.

Example:    

  n_Button = VS_ALERT( {"An Error Has Occurred.", ;
             "What Do You Want To Do?"}, {" Abort ", ;
             " Retry ", " Quit "}, 3 )

  DO CASE
     CASE n_Button = 1
        AbortFunc()
     CASE n_Button = 2
        RetryFunc()
     OTHERWISE
        QUIT
  ENDCASE

Usage:      

  VS_ALERT() is useful for asking the user such things as "What shall I
  do now?", "Where do you want this output to go?", etc.

See Also: VS_MSG()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson