MouseWheelMode Method (WINDOW)

PLBCMP GUI Only, 9.6

The MouseWheelMode method allows modification of the mouse wheel behavior. The method uses the following format:

Where:

label

Optional. A Program Execution Label.

object

Required. A WINDOW object that is accessed.

return

Optional. A Numeric Variable that indicates the current mousewheel mode after this method has been set.

mode

Required. A Numeric Variable or decimal number that specifies the mousewheel mode to be set.

Flags Affected: OVER, ZERO

Note the following:

1. The ZERO flag is set when the method return value is zero.

2. The OVER flag is set if the returned value is too large for {return} variable.

3. When the {mode} value is zero (0), the mousewheel mode is set to a Sunbelt behavior where a GUI object can be scrolled without having the focus. This Sunbelt mode is the default behavior and occurs when a mousewheel action occurs while the mouse is located over one of the following GUI objects:

 

LISTVIEW

EDITTEXT that has scroll bars.

RICHEDITTEXT has scroll bars.

COMBOBOX

SLIDER

TREEVIEW

DATALIST

4. When the {mode} value is one (1), the mousewheel mode is set to a Windows behavior where the GUI object with the focus is scrolled as mousewheel actions occur and the mouse is located over GUI objects other than the focused object.

5. The WINDOW and PANEL objects always execute using the Sunbelt mousewheel behavior when the AUTOSCROLL property is enabled for these objects.

6. This method is not available when using the PL/B Web Server.

See Also: Method Syntax, WINDOW Methods