SetTBFlags Method (TOOLBAR)
PLBCMP GUI Only
The SetTBFlags method sets and clears state flags that control specialized behaviors for a TOOLBAR object. The method uses the following format:
|
|
|
|
|
|
|
|
|
|
|
|
Where:
label
Optional. A Program Execution Label.
object
Required. A TOOLBAR object that is modified.
return
Optional. A Numeric Variable that indicates the success or failure of the method.
flags
Required. A Numeric Variable or decimal value that is a bitmask value from 0x00 to 0xFF.
mode
Required. A Numeric Variable or decimal value the specifies the mode of operation for the SetTBFlags method.
Flags Affected: EOS, OVER, ZERO
Note the following:
If the {mode} value is zero, the state flags defined by the {flags} value are cleared for the TOOLBAR object. If the {mode} value is non-zero, the state flags defined by the {flags} value are set to take affect for the TOOLBAR object.
Each bit it the bitmask value defines a specialized behavior for a TOOLBAR object as defined below:
|
Value |
Meaning |
|
0x0 |
the {return} value is user state flags that are currently being used for the TOOLBAR object. |
|
0x1 |
When this bit is set to 1, the old style tooltips are enabled. When this bit is set to 0, a new style tooltips is enabled. When a TOOLBAR is created, the tooltip style defaults to the new style. The end-user behavior for old style versus new style tooltips of a TOOLBAR is that the new style allows tooltips to be presented over TOOLBUTTONs when the application window is inactive. |
|
0x2 |
This bit mask value only takes affect for the tooltip support implemented in version 9.4C. When this bit mask value is set on, any tooltips specified for visible TOOLBUTTON objects are visible. When this bit mask value is cleared, all tooltips for the TOOLBUTTON objects are not visible. Note that the SHOWTIPS property for a TOOLBAR is a CREATE/GETMODE only property and can not be used to change the display state of the TOOLTIPS after the CREATE instruction has been executed. (9.5B) |
{mode} is a value from the table below:
|
Value |
Meaning |
|
0 |
Clear the TOOLBAR object behavior flags specified. |
|
1 |
Set the TOOLBAR object behavior flags specified |
If the value returned is zero, the ZERO Condition Flag is set.
The OVER and EOS Condition Flags are always cleared.
For improved performance in the Application Server environment, do not specify the optional return value unless needed.
See Also: Method Syntax, TOOLBAR Methods
|
|