WoButtonBarSetSensitivity Procedure

Sets the sensitivity of one or more buttons on a button bar.

Usage

WoButtonBarSetSensitivity, toolname, descriptor, sensitivity

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.

sensitivity — Specifies a scalar or array with the sensitivity of the button or buttons. A value of 0 makes the button insensitive; 1 makes the button sensitive.

Keywords

None.

Discussion

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

A descriptor is a string used to identify a button. This string is also used as the button’s widget ID. 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 WoButtonBarSetSensitivity, see WoAddButtons Procedure.