COLUMN ATTRIBUTES Property

Designer Only

The COLUMN ATTRIBUTES property provides access to the Designer's Listview Column Attribute Editor. Attributes may be added, modified, or removed from the LISTVIEW.

Within the attribute editor, each current attribute is displayed in the left hand list. When an attribute is selected, its properties are shown in the right hand list. The properties are modified just as they are in the properties window. Functions for adding new attributes or removing existing attributes are also available.

The STORE button allows the current listview attributes to be saved with a user specified title. Subsequent forms may then use the LOAD to retrieve the listview attributes. LISTVIEW attribute definitions may be deleted by clicking the LOAD button, selecting the user specified title, and then clicking the DELETE button.

Once the listview modifications are complete, clicking the OK button will save the definitions. The CANCEL button will terminate the attribute editor without saving any changes.

Note the following:

1. This is a Designer only property and is not accessible using the GETPROP or SETPROP instructions.

2. The Designer will add an attribute column if the Attribute Column property is not set to TRUE.

3. The Designer will create the following functions for each LISTVIEW that has defined attributes. Each function's name will be composed of the LISTVIEW name follow by an underscore (_) and a descriptive suffix. Row and column values are zero based.

 

{listview}_GetAttributeNames using {combobox}

Initializes the specified combobox with the defined attribute names.

{listview}_GetAttributeValue giving {value} using {attribute name}

Returns the value string associated with the specified attribute.

{listview}_SetListviewAttributes using {attribute name}

Initializes each row in the listview with the attribute specified. Existing column attributes are preserved.

{listview}_SetRowAttributes using {row},{attribute name}

Initializes a single row with the attribute specified. Existing column attributes are preserved.

{listview}_SetColumnAttributes using {column},{attribute name}

Initializes a single column with the attribute specified. Existing column attributes are lost.

{listview}_SetCellAttribute using {row},{column},{endrow},{endcolumn},{attribute name}

Applies the specified attribute to a range of cells.

{listview}_SetAlternatingRowAttributes using {attribute name}

Applies the specified attribute to the odd numbered rows of the listview. Existing column attributes are preserved.

{listview}_SetAlternatingColumnAttributes using {attribute name}

Applies the specified attribute to the odd numbered columns. Existing column attributes are lost.

 

4. It is the user's responsibility to call the attribute functions at the appropriate point within the program code. No automatic calling is performed.

5. The routines set the OVER flag to indicate an problem with the parameters.

6. User's may create additional functions using the stored attributes as desired but should employ the GetAttributeValue function rather than rely on any current attribute value property. This ensures that code will continue to execute properly if the attibute definitions change.

See Also: Listview Columns, Object Properties, Object IO Instructions, Object Definitions