SetLVFlags Method (LISTVIEW)

PLBCMP GUI Only

The SetLVFlags method sets and clears state flags that control specialized behaviors for a LISTVIEW object. 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 whose value is the current LISTVIEW state value after the SetLVFlags operation.

flags

Required. A Numeric Variable or decimal value that is a bitmask value from 0x00 to 0xFF.

mode

Required. A Numeric Variable or decimal value the specifies the mode of operation for the SetLVFlags method.

Flags Affected: EOS, OVER, ZERO

Note the following:

1. Each bit in the bitmask value defines a specialized behavior for a LISTVIEW object.

2. If the {mode} value is zero, the state flags defined by the {flags} value are cleared for the LISTVIEW object. If the {mode} value is non-zero, the state flags defined by the {flags} value are set to take affect for the LISTVIEW object.

3. {flags} is a value from the table below:

 

Value	Meaning
0x00	When the {flags} value is zero, the {return} value is user state flags that are currently being used for the LISTVIEW object.
0x1	Enable behavior that allows a MouseWheel event for a LISTVIEW to be posted to its container when the LISTVIEW does not have any scrollbars present.
0x2	If this behavioral bit is set, a CLICK or double CLICK event is always generated when a mouse click is executed within the bounds of a LISTVIEW. If this behavioral bit is cleared, a CLICK or double CLICK event is only generated when a LISTVIEW item (i.e., row) is currently selected or has the focus.
0x4	Reserved for Sunbelt use.
0x8	This bit value is ONLY used by the PWS runtimes to invoke a behavior for the PWS LISTVIEW to match Windows column sizing which prevents HTML table column auto sizing.

 

4. {mode} is a value from the table below:

 

Value	Meaning
0	Clear the LISTVIEW object behavior flags specified.
1	Set the LISTVIEW object behavior flags specified

 

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

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

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

See Also: Method Syntax, LISTVIEW Methods