GSAK (Geocaching Swiss Army Knife)
Contents - Index

ShowStatus (command)

SHOWSTATUS <Msg="Status message"> [<Height=152|nnn>] [<Width=252|nnn>] [<Left=nnn>] [<Top=nnn>] [<Display=On|Off>] [<Title=xxxx>] [Mtype=Single|Multi]

One of the problems with having GSAK run in SpeedMode is that there is no feedback to the user when iterating through the database or running a large number of macro commands. The SHOWSTATUS command can address this problem. If you use this command it brings up the same dialog as the SHOWSTOP command (you can still use SHOWSTOP but it is no longer needed if you now use SHOWSTATUS) which now has a status bar added to the bottom. Any text you place in the MSG parameter is displayed in this status bar. 

Height, Width, Left and Top are all optional and allow you to change the size and position of this dialog. All measurements (nnn) are in screen pixels. If Left is not specified then the default value of 348 is used. If Top is not specified, then the default value of 201 is used. If width is not specified (or set to 0) then the default of 252 is used. If height is not specified (or set to 0) then the default of 152 is used. 

Title is also optional, and used to set the caption (blue heading bar) of the dialog.

Display - On (the default) will show the status box, Off will remove it from the display.
Mtype - Single - each message is shown as a single line entry at the bottom of this showstatus display (The latest entry overrides the previous message). Multi - removes the single line status at the bottom and replaces with a multi line "memo" box. Each message is added to this box so you can see a history of past messages. This box will also grow/shrink as you change the height and width values.The default height for the ShowStatus command is set up for the "Single" options so you probably will want to at least change the height if you use "Multi"

Sample code and corresponding screenshot when the height is set to 250

$x = 0
while $x < 10
  ShowStatus Msg="Testing iteration $x of 10" height=250 mtype=multi
  delay ms=1000
  $x = $x + 1


Alpha List         Category List

Copyright 2004-2016 CWE Computer Services  
Privacy Policy Contact