BUTTONTYPE Property

PLBCMP GUI Only, 9.6

The BUTTONTYPE property defines the style of a BUTTON object. The property uses the following format:

BUTTONTYPE={value}

Note the following:

BUTTONTYPE may be used in CREATE or GETPROP statements of a BUTTON object.
{value} is a decimal number, a Numeric Variable, an Expression, or a keyword as defined in PLBEQU.INC. The supported values and keywords are:

Value	Keyword	The button style is ...
0	$NONE	a standard button (default).
1	$SPLITBUTTON	a split button with a drop down menu. A menu for the button text can be set using the FLOATMENU property.
2	$COMMANDLINK	a command link button that has a green arrow on the left pointing to the button text. A caption for the button text can be set using the CMDNOTE property.
3	$FILEINPUT	one that automatically invokes a client browser 'File Upload' selection dialog. This selection dialog allows an end user to select file(s) that can subsequently be retrieved or copied from the client browser environment to the PWS server using a PL/B COPYFILE instruction. See the BUTTON 'SetFileOptions' method to allow multiple files to be selected in the client browser dialog. (PWS Only) ( 9.7A)

This property requres the use of ComCtrl32 version 6 or later and an operating system of Windows Vista or later.
When using the PL/B Web Server, only the $FILEINPUT or $NONE modes are available.
A CHANGE event is generated when a 'BUTTONTYPE=$FILEINPUT' is being used and an end-user has made a selection from the client browser 'File Upload' selection dialog. Note that:

A. The CHANGE event for a BUTTON object is only generated when executing under a PL/B Web Server and a file has been selected by an end-user using the client browser 'File Upload' selection dialog. For this event; the event character is always 0x20; the event result and the event modifier are always zero.

B. When this CHANGE event for a BUTTON object is processed, the PL/B logic can use the BUTTON GetFileCount and GetFileItem methods to retrieve the end-user file selection information.

C. To select multiple files, use the BUTTON SetFileOptions method.

D. When selecting multiple files, a CHANGE event is generated as each selection is made.

E. The client browser controls all behaviors associated with the generation of the CHANGE event related to the operations of the 'File Upload' selection dialog. The PWS JavaScript and runtime operations cannot change the behaviors of the client browser as described below:

FireFox: The FF browser generates a JavaScript change event when the same file is selected mutliple times back to back.
Chrome: The Chrome browser generates a Javascript change event when a file is first selected. However, if the same file name is selected a second time in back to back select actions, the Chrome browser does not generate a JavaScript change action on the selection. In this scenario, the browser does not determine that a change has occurred when the same file name(s) is selected in back to back file selection operations.
IE: The IE browser generates a Javascript change event when a file is first selected. However, if the same file name is selected a second time in back to back select actions, the IE browser does not generate a JavaScript change action on the selection. In this scenario, the browser does not determine that a change has occurred when the same file name(s) is selected in back to back file selection operations.