TOOLBAR

PLBCMP GUI Only

The TOOLBAR defines a menu of buttons for user selection. To define a TOOLBAR, use one of the following statement formats:

Where:

label

Optional. A Data Label.

%

Optional. Denotes the item as being GLOBAL.

arraysize

Required. An integer decimal constant, CONST variable, or EQUATEd value indicating the number of array items.

^

Optional. Denotes the item as being a POINTER.

target

Required. The name of a previously defined data item of the same type.

Flags Affected: NONE

Note the following:

1. The TOOLBAR object is composed of multiple TOOLBUTTON objects that can be added and removed using methods. Each tool button can be accessed directly via a BUTTONS collection or retrieved into a TOOLBUTTON.

2. The BUTTONS collection allows direct access to the TOOLBUTTON objects by the GETPROP or SETPROP statements. The collection uses the following format:

[label] GetProp {object}.Buttons({key}),{property}

Where:

label

Optional. A Program Execution Label.

object

Required. A TOOLBAR object that is accessed.

key

Required. A Character String Variable or Numeric Variable that specifies the run-time name (RUNNAME property) or zero-based position of the button.

property

Required. The remaining line of the GETPROP statement.

3. A default set of standard, disabled, and hot images are automatically associated with a TOOLBAR.

4. Multi-dimension arrays are supported up to a maximum of fourteen dimensions.

5. The ^ denotes Pointer Variable.

6. Although a TOOLBAR may be defined as Global, it is DESTROYed during a CHAIN instruction.

7. The tooltips for a TOOLBAR can be enabled to execute as an old style tooltip or to execute as a new style tooltip (9.4C). The new style tooltips allow a tooltip to appear over a TOOLBUTTON when a window containing the TOOLBAR is inactive. The old style tooltips do not allow this behavior for an inactive window.

8. The end-user application can cause the default tooltip behavior for any TOOLBAR to be set when the TOOLBAR is created by executing a SETMODE *TBTOOLTIPMODE keyword before a TOOLBAR is created.

9. After a TOOLBAR has been created, the tooltip behavior can only be changed by executing the TOOLBAR method named SetTBFlags. This method changes the current tooltip behavior to be a new or old style.

10. The PWS server has been modified to support a PWS TOOLBAR. The PWS toolbar is implemented using the jQuery Toolbar implementation. It his not possible to simulate all of the Windows TOOLBAR control behaviors for the PWS TOOLBAR. Therefore, the PWS TOOLBAR has the following limitations:

 

    There are no right click actions.

    The Button property PARTIALPUSH and the TBSTATE_INDETERMINATE are not supported.

    No support for hot or disabled image lists.

    No keypress events for Designer.

    The APPEARANCE is always flat style.

    The properties APPEARANCE, AUTOSIZE, BDRSTYLE, HWND, IMAGELISTD, IMAGELISTH, SHOWTIPS, TEXTALIGN, and WRAPPABLE are ignored.

    WRAPPABLE is always on.

    Tooltips are always shown.

    No support in .PLM because of JQuery Mobile requirements.

    The PWS TOOLBAR ignores the 'WriteImageListBmp' method.

See Also: Example Code, Object Output Instructions