InsertAttrColor Method (LISTVIEW)

9.0, PLBCMP GUI Only

The InsertAttrColor method initializes the color index table for the LISTVIEW object with COLOR objects. The method uses the following format:

Where:

label

Optional. A Program Execution Label.

object

Required. A LISTVIEW object that is accessed.

return

Optional. A Numeric Variable that indicates the first table position modified.

colorobj

Optional. A COLOR object that is assigned to the color table position. The table positions are assigned by keyword names or are assigned by relative color object positions in the USING list.

Flags Affected: OVER, ZERO

Note the following:

1. The LISTVIEW color table allows definition of twenty (20) colors.

2. The table positions are assigned by keyword names or by relative color object positions in the USING list.

3. If a COLOR object is stored into the color table, the returned value is the first color table position that was set. If no color table positions were set, a value of zero is returned.

4. The ZERO condition flag is set if the returned value is zero.

5. The OVER flag is set if the {return} variable is too small to hold the returned value.

6. For improved performance in the Application Server environment, do not specify the optional return value unless needed.

See Also: Example Code, Method Syntax, LISTVIEW Methods