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