Set ProgressBars statement - MapBasic - 2023

Purpose

Disables or enables the display of progress-bar dialog boxes. You can issue this statement from the MapBasic window in MapInfo Pro.

Syntax

Set ProgressBars { On | Off }

Description

Some MapBasic statements, such as the Create Object statementCreate Object As Buffer statement, automatically display a progress-bar dialog box (a "percent complete" dialog box showing a horizontal bar and a Cancel button). To suppress progress-bar dialog boxes, use the Set ProgressBars Off statement. By suppressing these dialog boxes, you guarantee that the user will not interrupt the operation by clicking the Cancel button. To resume displaying progress-bar dialog boxes, use the Set ProgressBars On statement.

If you issue a Set ProgressBars Off statement from within a compiled MapBasic application (MBX file), the statement only disables progress-bar dialog boxes caused by the MBX file. Actions taken by the user can still cause progress bars to display. Also, Run Menu Command statements can still cause progress bars to display, because the Run Menu Command statement simulates the user selecting a menu command.

To disable progress-bar dialog boxes that are caused by user actions or Run Menu Command statements, type a Set ProgressBars Off statement into the MapBasic window (or send the command to MapInfo Pro through OLE Automation or DDE).

If your application minimizes MapInfo Pro (using the Set Window MapInfo Min), you should suppress progress bars. When a progress bar displays while MapInfo Pro is minimized, the progress bar is frozen for as long as MapInfo Pro is minimized. If you suppress the display of progress bars, the operation can proceed, even if MapInfo Pro is minimized.

See Also:

ProgressBar statement, Run Menu Command statement