Reference Guide > W Routines > WoButtonBarSetSensitivity Procedure
  

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:
(UNIX) <wavedir>/lib/vdatools
(WIN) <wavedir>\lib\vdatools
Where <wavedir> is the main PV‑WAVE directory.
Example
For an example that uses WoButtonBarSetSensitivity, see WoAddButtons Procedure.

Version 2017.1
Copyright © 2019, Rogue Wave Software, Inc. All Rights Reserved.