SetStatus()
Summary
Sets the contents of a section of the status bar.
Syntax
SetStatus(integer section, string contents, string disabled)
| Argument | Contents |
|---|---|
| section | The section of the status bar to change |
| contents | The text for the section of the status bar |
| disabled | If "True" the contents are grayed out; default is "False" |
Notes
-
If the contents string is "@System0" the specified section of the status bar is automatically updated with information about the state of the current window (Map scale, number of records in a Dataview, etc.).
-
If the contents string is "@System1" the specified section of the status bar is automatically updated with information about the current activity (number of records selected, layer being drawn, etc.).
-
Item 1, the bar to the left, defaults to: "@system0."
-
Item 2, the center bar, defaults to: "@system1."
-
Item 3, the right bar, defaults to Network status display.
-
The most common way to indicate progress is to call SetStatus(2, i2s(records_found) + " Found.", ) as often as necessary. When done, always reset the status item, e.g. call SetStatus(2,"@system1",)
-
When you supply your own string with a variable, you must call SetStatus() to update the string each time the variable changes.
Example
SetStatus(2, "Working on my macro", )
RunMacro("My Own Macro")
SetStatus(2, "@System1", )
See Also
| Function | Summary |
|---|---|
| SetStatusBar() | Sets the number and size of sections in the status bar |