WzVariable Procedure

PV-WAVE Foundation > Reference Guide > Procedure and Function Reference: W > WzVariable Procedure

Starts a VDA Tool used for viewing and exporting variables.

Usage

WzVariable

Input Parameters

None.

Keywords

Associated_With — A string containing the name of a VDA Tool. The WzVariable window will only show variables from this specified VDA Tool. Note that the string you specify is case-sensitive.

NoBlock — If specified, the event loop (WwLoop) that is started by the VDA Tool will use the given value. By default a value of 1 (non-blocking loop) will be used. However, it may be necessary in certain circumstances to force a non-blocking loop by specifying NoBlock = 2. (See WwLoop in the PV‑WAVE Application Developer’s Guide for more information.)

Parent — The widget ID of the parent widget.

Position — Specifies, in pixels, the x and y (horizontal and vertical) coordinates for the starting location of the upper-left corner of the VDA Tool window.

Restore — A data structure previously saved in the Tools Manager with the TmSaveTools function. This keyword is reserved for internal use; it is not to be used at the command line (see Discussion).

Type — An integer, or array of integers, that specify the data types to display. These integers and their corresponding data types are (PV‑WAVE designation listed in parentheses):

0 — Undefined

1 — Byte (BYTE)

2 — Integer (INT)

3 — Longword integer (LONG)

4 — Floating point (FLOAT)

5 — Double precision floating (DOUBLE)

6 — Complex single-precision floating (COMPLEX)

7 — String (STRING)

8 — Structure

9 — (not used)

10 — List (LIST)

11 — Associative array (ASARR)

12 — Complex double-precision floating (DCOMPLEX)

13 — 32-bit integer (INT32)

Discussion

The Parent keyword is used to connect WzVariable to another application, such as the Navigator.

The Restore keyword is used specifically by the TM_RESTORE method. For information on the TM_RESTORE method, refer to the source code for WzVariable in:

(UNIX) <wavedir>/lib/vdatools/wzvariable.pro

(WIN) <wavedir>\lib\vdatools\wzvariable.pro

Where <wavedir> is the main PV‑WAVE directory.

note	For information on how to use this VDA Tool, use online Help. Select the On Window command from the VDA Tool Help menu to bring up Help on this VDA Tool.

Example

data = DIST(30)

WzPlot, data

WzVariable, Associated_With='WzPlot_0'