Reference Guide > W Routines > WoStatus Function
  

WoStatus Function
Create a status bar for a VDA Tool.
Usage
widget = WoStatus(parent, toolname)
Input Parameters
parent — Specifies the parent widget ID of the status bar (long).
toolname — (string) Specifies the unique name of the VDA Tool to which the status bar is attached.
Returned Value
widget — The ID of the status bar widget.
Keyword
Frame — If present and nonzero, a frame widget is placed around the status bar.
Attachment Keywords
Bottom — If a widget ID is specified (for example, Bottom=wid), then the bottom of the status bar is attached to the top of the specified widget. If no widget ID is specified (for example, /Bottom), then the bottom of the status bar is attached to the bottom of the parent widget.
Left — If a widget ID is specified (for example, Left=wid), then the left side of the status bar is attached to the right side of the specified widget. If no widget ID is specified (for example, /Left), then the left side of the status bar is attached to the left side of the parent widget.
Right — If a widget ID is specified (for example, Right=wid), then the right side of the status bar is attached to the left side of the specified widget. If no widget ID is specified (for example, /Right), then the right side of the status bar is attached to the right side of the parent widget.
Top — If a widget ID is specified (for example, Top=wid), then the top of the status bar is attached to the bottom of the specified widget. If no widget ID is specified (for example, /Top), then the top of the status bar is attached to the top of the parent widget.
Examples
The following examples show two ways in which WoAddStatus can be used in a VDA Tool. Messages are defined in a resource file, and WoStatus is used to create the status area in the VDA Tool.
This is part of a resource file defined for a VDA Tool.
mytool.ads
MyTool_Initialize:  Initializing...
MyTool_FileRead:    Read file: 
...
; Create the status area.
...
sa = WoStatus(layout, tool_name, Top=bar, /Left)
...
Example 1
Set the status string.
WoAddStatus, tool_name, 'MyTool_Initialize' 
Example 2
Status messages can be tailored with dynamic information and then displayed.
msg = TmGetMessage('mytool.ads', 'MyTool_FileRead') 
msg = msg + file_name 
WoAddStatus, tool_name, Status=msg 
See Also
WoAddStatus, WoMessage

Version 2017.0
Copyright © 2017, Rogue Wave Software, Inc. All Rights Reserved.