PAUSE (Short Name: PAU)
Top  Previous  Next

Use the PAUSE command to suspend the running of the command file.

pause

Options

0
Pauses without a message.

1
Displays "Press any key to continue" or any message using the USING option in a Windows dialog box. In R:BASE for DOS, the screen clears with the next keystroke.

2
Same as the 1 option, except in R:BASE for DOS, the screen does not clear with the next keystroke.

3
Does not pause and therefore does not wait for the next keystroke.

4
If a PAUSE 3 dialog already exists only the message will be repainted to avoid flickering. Otherwise, this is exactly like the PAUSE 3 option.

FOR n
Sets the pause duration in seconds; n must be a positive integer. Any keystroke interrupts the pause, regardless of duration. In the absence of a USING clause, no message is displayed. With a USING clause, the message is displayed in an Windows dialog box

USING   'message'
Displays the specified message in a Windows dialog box. The maximum width of message text in a Windows dialog box is 77 characters and is limited to one line.

=width
Specifies the wrap width for the dialog box message.

CAPTION 'message'
Specifies the text of the message to display in the dialog box caption.

ICON name
 
·APPS  
·ATTENTION  
·CONFIRM  
·ERROR  
·HELP  
·INFO  
·QUESTION  
·SERIOUS  
·STOP  
·WARNING  
·WINDOWS  

OPTION parameters
 
ICON_FILE
\path\filename.bmp  
(file size must be 16x16 pixels)  
 
BACK_COLOR Changes color of WINDOW BACKGROUND area. User can specify the integer value or type one of the predefined name:
Values:   AQUA  
      BLACK
      BLUE  
      CREAM                    
      DARK GRAY  
      FUCHSIA  
      GRAY  
      GREEN  
      LIME  
      LIGHT GRAY  
      MAROON  
      MEDIUM GRAY  
      MINT GREEN  
      NAVY  
      OLIVE  
      PURPLE  
      REDSILVER  
      SKY BLUE  
      TEAL  
      WHITE  
      YELLOW  
 
MESSAGE_COLOR Changes background color of actual message.
Values:   AQUA  
      BLACK
      BLUE  
      CREAM                    
      DARK GRAY  
      FUCHSIA  
      GRAY  
      GREEN  
      LIME  
      LIGHT GRAY  
      MAROON  
      MEDIUM GRAY  
      MINT GREEN  
      NAVY  
      OLIVE  
      PURPLE  
      REDSILVER  
      SKY BLUE  
      TEAL  
      WHITE  
      YELLOW

MESSAGE_FONT_COLOR Changes color of message font.
Values:   AQUA  
      BLACK
      BLUE  
      CREAM                    
      DARK GRAY  
      FUCHSIA  
      GRAY  
      GREEN  
      LIME  
      LIGHT GRAY  
      MAROON  
      MEDIUM GRAY  
      MINT GREEN  
      NAVY  
      OLIVE  
      PURPLE  
      REDSILVER  
      SKY BLUE  
      TEAL  
      WHITE  
      YELLOW

MESSAGE_FONT_NAME Specifies a font name for the message

MESSAGE_FONT_SIZE Specifies the font size

MESSAGE_FONT_BOLD Specifies if the message font is bold type
Values:   ON  
   OFF  

MESSAGE_FONT_ITALIC Specifies if the message font is italic type
Values:   ON  
   OFF  

MESSAGE_FONT_UNDERLINE Specifies if the message font is underline type
Values:   ON  
   OFF  

MESSAGE_FONT_STRIKEOUT Specifies if the message font is strikeout type
Values:   ON  
   OFF  
 
BUTTON_COLOR Changes background color of button.
Values:   AQUA  
      BLACK
      BLUE  
      CREAM                    
      DARK GRAY  
      FUCHSIA  
      GRAY  
      GREEN  
      LIME  
      LIGHT GRAY  
      MAROON  
      MEDIUM GRAY  
      MINT GREEN  
      NAVY  
      OLIVE  
      PURPLE  
      REDSILVER  
      SKY BLUE  
      TEAL  
      WHITE  
      YELLOW

BUTTON_FONT_COLOR Changes font color of button.
Values:   AQUA  
      BLACK
      BLUE  
      CREAM                    
      DARK GRAY  
      FUCHSIA  
      GRAY  
      GREEN  
      LIME  
      LIGHT GRAY  
      MAROON  
      MEDIUM GRAY  
      MINT GREEN  
      NAVY  
      OLIVE  
      PURPLE  
      REDSILVER  
      SKY BLUE  
      TEAL  
      WHITE  
      YELLOW

METER_VISIBLE Displays a meter to show progress in percentage values
Values:   ON  
      OFF  

METER_TYPE Three meter options are available
Values:   NORMAL  
      BAR3D  
      LED  

METER_VALUE Specifies the percentage to display the meter progress
Values: 0 to 100     
 
METER_BAR_COLOR Specifies the color of the meter bar
Values:   AQUA  
      BLACK
      BLUE  
      CREAM                    
      DARK GRAY  
      FUCHSIA  
      GRAY  
      GREEN  
      LIME  
      LIGHT GRAY  
      MAROON  
      MEDIUM GRAY  
      MINT GREEN  
      NAVY  
      OLIVE  
      PURPLE  
      REDSILVER  
      SKY BLUE  
      TEAL  
      WHITE  
      YELLOW

METER_BACK_COLOR Specifies the meter background color
Values:   AQUA  
      BLACK
      BLUE  
      CREAM                    
      DARK GRAY  
      FUCHSIA  
      GRAY  
      GREEN  
      LIME  
      LIGHT GRAY  
      MAROON  
      MEDIUM GRAY  
      MINT GREEN  
      NAVY  
      OLIVE  
      PURPLE  
      REDSILVER  
      SKY BLUE  
      TEAL  
      WHITE  
      YELLOW

METER_FONT_COLOR Specifies the color of the meter font
Values:   AQUA  
      BLACK
      BLUE  
      CREAM                    
      DARK GRAY  
      FUCHSIA  
      GRAY  
      GREEN  
      LIME  
      LIGHT GRAY  
      MAROON  
      MEDIUM GRAY  
      MINT GREEN  
      NAVY  
      OLIVE  
      PURPLE  
      REDSILVER  
      SKY BLUE  
      TEAL  
      WHITE  
      YELLOW

METER_MAX_VALUE Specifies the maximum percentage to display the meter progress
Values: 0 to 100     

METER_COLOR1 Specifies the color of the meter when using three color segments (green, yellow, red)
Values:   AQUA  
      BLACK
      BLUE  
      CREAM                    
      DARK GRAY  
      FUCHSIA  
      GRAY  
      GREEN  
      LIME  
      LIGHT GRAY  
      MAROON  
      MEDIUM GRAY  
      MINT GREEN  
      NAVY  
      OLIVE  
      PURPLE  
      REDSILVER  
      SKY BLUE  
      TEAL  
      WHITE  
      YELLOW

METER_COLOR2 Specifies the color of the meter when using three color segments (green, yellow, red)
Values:   AQUA  
      BLACK
      BLUE  
      CREAM                    
      DARK GRAY  
      FUCHSIA  
      GRAY  
      GREEN  
      LIME  
      LIGHT GRAY  
      MAROON  
      MEDIUM GRAY  
      MINT GREEN  
      NAVY  
      OLIVE  
      PURPLE  
      REDSILVER  
      SKY BLUE  
      TEAL  
      WHITE  
      YELLOW

METER_COLOR3 Specifies the color of the meter when using three color segments (green, yellow, red)
Values:   AQUA  
      BLACK
      BLUE  
      CREAM                    
      DARK GRAY  
      FUCHSIA  
      GRAY  
      GREEN  
      LIME  
      LIGHT GRAY  
      MAROON  
      MEDIUM GRAY  
      MINT GREEN  
      NAVY  
      OLIVE  
      PURPLE  
      REDSILVER  
      SKY BLUE  
      TEAL  
      WHITE  
      YELLOW

METER_COLOR_OFF Sets the color off when using three color segments

GAUGE_VISIBLE Displays an oscillating progress gauge
Values:   ON  
      OFF  

GAUGE_COLOR Specifies the color of the progress gauge
Values:   AQUA  
      BLACK
      BLUE  
      CREAM                    
      DARK GRAY  
      FUCHSIA  
      GRAY  
      GREEN  
      LIME  
      LIGHT GRAY  
      MAROON  
      MEDIUM GRAY  
      MINT GREEN  
      NAVY  
      OLIVE  
      PURPLE  
      REDSILVER  
      SKY BLUE  
      TEAL  
      WHITE  
      YELLOW

GAUGE_INTERVAL Specifies the speed interval of the oscillating progress gauge
Values: 10-100  

TRANSPARENCY value
Sets the transparency value for how transparent the form will be to the background.
Note: Transparency option does not work on all systems. The application must be running under Windows 2000 or Windows XP and the machine must be a Pentium 90 or better.

TOP - will move the pause box location in pixels from the top of the screen down

LEFT - will move the pause box location in pixels from the left of the screen down

THEMENAME Will dynamically provide over thirty pre-defined themes
 
Values:  
 
·Deep Cyan  
·Deep Green  
·Deep Orange  
·Diamond Blue  
·Diamond Green  
·Funny Theme  
·Gnome  
·Green Glass  
·Longhorn  
·Mac OS  
·Matrix  
·Media  
·One Blue  
·One Clear Blue  
·One Cyan  
·One Green  
·One Orange  
·Orange Glass  
·R:BASE Rocks!  
·Razzmatazz  
·Real One  
·Sports Black  
·Sports Blue  
·Sports Cyan  
·Sports Green  
·Sports Orange  
·Steel Black  
·Steel Blue  
·Win Native  
·XP Blue  
·XP Egypt  
·XP Green  
·XP Grey Scale  
·XP Orange  
·XP Silver  

All previously defined PAUSE commands which are redefined to use Themes should be thoroughly checked prior to putting into production as objects and text may look substantially different.

 
Examples:

CLS
PAUSE 2 USING 'PAUSE with APPS Icon' CAPTION 'New PAUSE Command' ICON APPS

PAUSE_APP

CLS
PAUSE 2 USING 'PAUSE with ATTENTION Icon' CAPTION 'New PAUSE Command' ICON ATTENTION

PAUSE_ATTN

CLS
PAUSE 2 USING 'PAUSE with CONFIRM Icon' CAPTION 'New PAUSE Command' ICON CONFIRM

PAUSE_CNFRM

CLS
PAUSE 2 USING 'PAUSE with ERROR Icon' CAPTION 'New PAUSE Command' ICON ERROR

PAUSE_ERR

CLS
PAUSE 2 USING 'PAUSE with HELP Icon' CAPTION 'New PAUSE Command' ICON HELP

PAUSE_hlp

CLS
PAUSE 2 USING 'PAUSE with INFO Icon' CAPTION 'New PAUSE Command' ICON INFO

PAUSE_INFO

CLS
PAUSE 2 USING 'PAUSE with QUESTION Icon' CAPTION 'New PAUSE Command' ICON QUESTION

PAUSE_QUES

CLS
PAUSE 2 USING 'PAUSE with SERIOUS Icon' CAPTION 'New PAUSE Command' ICON SERIOUS

PAUSE_SERIS

CLS
PAUSE 2 USING 'PAUSE with STOP Icon' CAPTION 'New PAUSE Command' ICON STOP

PAUSE_STP

CLS
PAUSE 2 USING 'PAUSE with WARNING Icon' CAPTION 'New PAUSE Command' ICON WARNING

PAUSE_WARN

CLS
PAUSE 2 USING 'PAUSE with WINDOWS Icon' CAPTION 'New PAUSE Command' ICON WINDOWS

PAUSE_WIN

CLS
PAUSE 2 USING 'Now you can customize the message for button!' CAPTION 'New PAUSE Command' ICON INFO BUTTON 'Your customized message here ...'

PAUSE_CSTM


-- Standard PAUSE Command with ICON

PAUSE 2 USING 'Message Text' +
CAPTION 'Caption Text' +
ICON HELP +
BUTTON 'Button Text' +
|BACK_COLOR WHITE +
|MESSAGE_COLOR WHITE +
|MESSAGE_FONT_COLOR GREEN +
|BUTTON_COLOR WHITE +
|BUTTON_FONT_COLOR GREEN +
|TRANSPARENCY 255

-- Standard PAUSE Command with custom ICON

PAUSE 2 USING 'Message Text' +
CAPTION 'Caption Text' +
BUTTON 'Button Text' +
OPTION ICON_FILE path\directory\filename.bmp +
|BACK_COLOR WHITE +
|MESSAGE_COLOR WHITE +
|MESSAGE_FONT_COLOR GREEN +
|BUTTON_COLOR WHITE +
|BUTTON_FONT_COLOR GREEN +
|TRANSPARENCY 255

Note: Custom icon to be used in PAUSE option must be 16x16 pixels BMP file.
                           
-- Multi-Line PAUSE Command

-- (CHAR(009)) = Tab Key (Indent)
-- (CHAR(013)) = Carriage Return
CLS
SET VAR vMsg = +
('Line 1:'+(CHAR(009))+(CHAR(009))&'Contents of Line 1'+(CHAR(009))+(CHAR(013))+ +
 'Line 2:'+(CHAR(009))+(CHAR(009))&'Contents of Line 2'+(CHAR(009))+(CHAR(013))+ +
 'Line 3:'+(CHAR(009))+(CHAR(009))&'Contents of Line 3'+(CHAR(009))+(CHAR(013))+ +
 'Line 4:'+(CHAR(009))+(CHAR(009))&'Contents of Line 4'+(CHAR(009))+(CHAR(013))+ +
 'Line 5:'+(CHAR(009))+(CHAR(009))&'Contents of Line 5'+(CHAR(009))+(CHAR(013))+ +
 'Line 6:'+(CHAR(009))+(CHAR(009))&'Contents of Line 6'+(CHAR(009))+(CHAR(013))+ +
 'Line 7:'+(CHAR(009))+(CHAR(009))&'Contents of Line 7'+(CHAR(009))+(CHAR(013))+ +
 'Line 8:'+(CHAR(009))+(CHAR(009))&'Contents of Line 8'+(CHAR(009))+(CHAR(013))+ +
 'Line 9:'+(CHAR(009))+(CHAR(009))&'Contents of Line 9'+(CHAR(009))+(CHAR(013)))

PAUSE 2 USING .vMsg +
CAPTION 'Caption Text' +
ICON APP +
BUTTON 'Button Text' +
OPTION BACK_COLOR WHITE +
|MESSAGE_COLOR WHITE +
|MESSAGE_FONT_COLOR GREEN +
|BUTTON_COLOR WHITE +
|BUTTON_FONT_COLOR GREEN +
|TRANSPARENCY 255

-- Standard PAUSE Command with custom ICON with Themes

PAUSE 2 USING +
'Now you can add themes to PAUSE windows!' +
CAPTION 'New PAUSE Command' ICON INFO +
OPTION themename Longhorn
pausetheme

-- PAUSE Command with GAUGE Progress Bar

PAUSE 3 USING 'Calculating ... Please Stand By ...'  +
CAPTION '                    Pause 3 with Gauge '  +
ICON WINDOWS  OPTION GAUGE_VISIBLE ON  +
|GAUGE_COLOR RED  +
|GAUGE_INTERVAL 10  +
|MESSAGE_FONT_NAME VERDANA  +
|MESSAGE_FONT_SIZE 10  
|MESSAGE_FONT_COLOR WHITE  +
|THEMENAME Steel Blue

PAUSE3_GAUGE_SteelBlue


List of ICONS used in PAUSE command