PreventKeyClickEvent Method (DATALIST)

PLBCMP GUI Only, 9.7A

The PreventKeyClickEvent method allows the click event as generated by key actions for a Datalist to be enabled or disabled under program control.

Where:

label

Optional. A Program Execution Label.

object

Required. A DATALIST object that is modified.

return

Optional. A Numeric Variable that is always returned as 0.

value

Required. A Numeric Variable or decimal number that identifies whether the key action click event for the DATALIST is to be enabled or disabled.

Flags Affected: EOS, OVER, ZERO

Note the following:

1. The {return} value is always returned as a value of zero.

2. The ZERO flag is always set.

3. The EOS and OVER flags are always cleared.

4. When the input {value} parameter is non-zero, the DATALIST click events caused by end-user key action is disabled. When the input {value} is zero, the DATALIST click events caused by end-user key actions is enabled.

5. This method implements a DATALIST item selection behavior where only mouse actions generates click events by an end-user.

See Also: Method Syntax, DATALIST Methods, COMBOBOX Methods