[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]

     <oListBox>:hitTest(<nMouseRow>, <nMouseCol>)
         --> nhitStatus

        <nMouseRow> is a numeric value that indicates the current screen
        row position of the mouse cursor.

        <nMouseCol> is a numeric value that indicates the current screen
        column position of the mouse cursor.

        Returns a numeric value that indicates the relationship of the mouse
        cursor with the list box.

        Applicable Hit Test Return Values
        ---------------------------------------------------------------------
        Value   Constant       Description
        ---------------------------------------------------------------------
        > 0     Not Applicable The position in the list of the item whose
                               region the mouse is within
        0       HTNOWHERE      The mouse cursor is not within the region of
                               the screen that the list box occupies
        -1      HTTOPLEFT      The mouse cursor is on the top left corner of
                               the list box's border
        -2      HTTOP          The mouse cursor is on the list box's top
                               border
        -3      HTTOPRIGHT     The mouse cursor is on the top right corner of
                               the list box's border
        -4      HTRIGHT        The mouse cursor is on the list box's right
                               border
        -5      HTBOTTOMRIGHT  The mouse cursor is on the bottom right corner
                               of the list box's border
        -6      HTBOTTOM       The mouse cursor is on the list box's bottom
                               border
        -7      HTBOTTOMLEFT   The mouse cursor is on the bottom left corner
                               of the list box's border
        -8      HTLEFT         The mouse cursor is on the list box's left
                               border
        -1025   HTCAPTION      The mouse cursor is on the list box's caption
        -4097   HTDROPBUTTON   The mouse cursor is on the list box's drop
                               down button
        ---------------------------------------------------------------------

        Button.ch contains manifest constants for the ListBox:hitTest()
        return value.

        hitTest() is a method of the ListBox class that is used for
        determining if the mouse cursor is within the region of the screen
        that the list box occupies.

        Note:  When a scroll bar is present, its hitTest() method is
        automatically called to determine if the mouse cursor is within its
        region.  If ScrollBar:hitTest() succeeds in determining that a "hit"
        has been achieved, ListBox:hitTest() returns the appropriate scroll
        bar hit test return code.

This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson