SetSel Method (DATALIST)
PLBCMP GUI Only
The SetSel method highlights the specified DATALIST item. The method uses the following format:
|
|
|
|
|
|
|
|
Where:
label
Optional. A Program Execution Label.
object
Required. A DATALIST object that is accessed.
return
Optional. A Numeric Variable that indicates the success or failure of the method.
select
Required. A Numeric Variable or literal that specifies the new item state as described below.
index
Required. A decimal number or Numeric Variable that indicates the item to modify.
Flags Affected: EOS, OVER, ZERO
Note the following:
The DATALIST must have the MULTISELECT property enabled.
If a range of items are modified, use the SelItemRange method.
The {select} value is a constant as defined in PLBEQU.INC or a numeric variable indicating one of the following actions:
|
Value |
Constant |
The item specified is ... |
|
0 |
$FALSE |
displayed as normal text and not selected. |
|
1 |
$TRUE |
selected and highlighted. |
Upon completion, {return} will contain the status of the method as follows. $TRUE and $FALSE are defined in PLBEQU.INC.
|
Value |
Constant |
The selection ... |
|
0 |
$FALSE |
failed. |
|
1 |
$TRUE |
was successful. |
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, DATALIST Methods
|
|