SetExtendedStyle Method (LISTVIEW)

PLBCMP GUI Only

The SetExtendedStyle method activates an extended style within a LISTVIEW object. The method uses the following format:

Where:

label

Optional. A Program Execution Label.

object

Required. A LISTVIEW object that is modified.

return

Optional. A Numeric Variable that returns the previous extended LISTVIEW control style value.

index

Required. A decimal number or Numeric Variable that specifies the zero-based column to modify.

mask

Required. A decimal number or Numeric Variable that indicates that styles in {style} are affected.

style

Required. A decimal number or Numeric Variable that specifies the extended LISTVIEW control style.

Flags Affected: EOS, OVER, ZERO

Note the following:

1. {mask} can be a combination of the extended styles. Only the extended styles in {mask} is changed. All other styles is maintained as they are. If this parameter is zero, all of the styles in {style} is affected.

2. {style} can be a combination of extended styles. The {mask} value allows you to modify one or more extended styles without having to retrieve the existing styles first. For example, if you pass LVS_EX_FULLROWSELECT for {mask} and 0 for {style}, the LVS_EX_FULLROWSELECT style is cleared but all other styles will remain the same.

3. The valid extended styles are:

 

Value	Keyword	Enables
0x1	LVS_EX_GRIDLINES	gridlines around items and sub items. This style is available only in conjunction with the LVS_REPORT style.
0x4	LVS_CHECKBOXES	check boxes for items in a LISTVIEW object. Check boxes are visible and functional with all LISTVIEW modes.
0x8	LVS_EX_TRACKSELECT	hover selection in a LISTVIEW control. Hover selection (also called track selection) means that an item is automatically selected when the cursor remains over the item for a certain period. The delay can be changed from the default system setting with the LVM_SETHOVERTIME message. This style applies to all styles of LISTVIEW control.
0x10	LVS_EX_HEADERDRAGDROP	drag-and-drop reordering of columns in a LISTVIEW control. This style is only available to LISTVIEW controls that use the LVS_REPORT style.
0x20	LVS_EX_FULLROWSELECT	highlighting of all sub items when an item is selected. This style is available only in conjunction with the LVS_REPORT style.
0x40	LVS_EX_ONECLICKACTIVATE	hot tracking in the LISTVIEW control. Hot tracking means that when the cursor moves over an item, it is highlighted but not selected.
0x800	LVS_EX_UNDERLINEHOT	display of hot items with underlined text. This style is ignored if LVS_EX_ONECLICKACTIVATE or is not set.
0x1000	LVS_EX_UNDERLINECOLD	display of non-hot items with underlined text. This style is ignored if LVS_EX_ONECLICKACTIVATE is not set.

4. If the value returned is zero, the ZERO Condition Flag is set.

5. The OVER and EOS Condition Flags are always cleared.

6. Extended styles are not available under the Windows 3.x operating system.

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

See Also: Method Syntax, LISTVIEW Methods