SetItemData Method (COMBOBOX / DATALIST)
PLBCMP GUI Only
The SetItemData method assigns a user-defined value to a specified item within a DATALIST or COMBOBOX. The method uses the following format:
|
|
|
|
|
|
|
|
Where:
label
Optional. A Program Execution Label.
object
Required. A DATALIST or COMBOBOX object that is accessed.
return
Optional. A Numeric Variable that indicates the success or failure of the method.
value
Required. A decimal number or Numeric Variable that specifies a user-defined value associated with the item.
index
Required. A decimal number or Numeric Variable that indicates the zero-based item to modify.
Flags Affected: EOS, OVER, ZERO
Note the following:
Upon completion, {return} will contain the status of the method as follows. $TRUE and $FALSE are defined in PLBEQU.INC.
|
Value |
Constant |
The modification ... |
|
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, COMBOBOX Methods
|
|