WoButtonBarSet Procedure

Changes the setting of a button in a button bar.

Usage

WoButtonBarSet, toolname, descriptor, setting

Input Parameters

toolname — (string) Specifies the unique name of the VDA Tool to which the button bar is attached.

descriptor — Specifies a scalar string or string array containing the descriptor of the button or buttons to set.

setting — Specifies a scalar or array with the new setting or settings. A value of 0 unsets the button; 1 sets the button.

Keywords

None.

Discussion

If the setting parameter is a scalar, then all buttons are set to the value of setting. If the setting parameter is an array, each button is set to its corresponding element in setting. In other words, the first button is set to the first value in the array, the second button to the second value, and so on. If setting is an array with fewer elements than buttons, the extra buttons are set to 1.

A descriptor is a string used to identify a button. This string is also used as the button’s widget name. The descriptor is set in the standard button bar structure. The standard graphics button bar is defined in the file wographicsbuttons.pro in:

<wavedir>/lib/vdatools
<wavedir>\lib\vdatools

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

Example

For an example that uses WoButtonBarSet, see WoAddButtons Procedure.

See Also

WoAddButtons, WoButtonBar, WoButtonBarSetSensitivity