HbListBox() > Methods

oHbListBox:hitTest()

Tests if a list box is hit by the mouse cursor.

Syntax

:hitTest( <nMouseRow>, <nMouseCol> ) --> nHitCode

Arguments

<nMouseRow>

This is the numeric row position of the mouse cursor. It can be queried using function MRow().

<nMouseCol>

This is the numeric column position of the mouse cursor. It can be queried using function MCol().

Description

Method :hitTest() accepts the numeric row and column position of the mouse cursor and returns a numeric value indicating whether or not the mouse cursor is located within the HbListBox object. #define constants are available in the BUTTON.CH file identifying the return value of :hitTest().

Return values of oHbListBox:hitTest()

Constant	Value	Description
	> 0	Ordinal position of list box item hit by the mouse cursor
HTNOWHERE	0	Mouse cursor is outside the list box
HTTOPLEFT	-1	Mouse cursor is on the top left corner of the list box
HTTOP	-2	Mouse cursor is on the top border of the list box
HTTOPRIGHT	-3	Mouse cursor is on the top right corner of the list box
HTRIGHT	-4	Mouse cursor is on the right border of the list box
HTBOTTOMRIGHT	-5	Mouse cursor is on the bottom right corner of the list box
HTBOTTOM	-6	Mouse cursor is on the bottom border of the list box
HTBOTTOMLEFT	-7	Mouse cursor is on the bottom left corner of the list box
HTLEFT	-8	Mouse cursor is on left border of the list box
HTCAPTION	-1025	Mouse cursor is on the list box's caption
HTDROPBUTTON	-4097	Mouse cursor is on the list box's drop-down button