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