[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 MSHOW()
 Display the mouse pointer
------------------------------------------------------------------------------
 Syntax

     MSHOW([<nCol>, <nRow>, <nStyle>])
         --> nOldCursorShape

     MSHOW([<nCursorShape>]) --> nOldCursorShape

     MSHOW([<nCursorShape>] | [<nCol>, <nRow>, <nMode>])
         --> nOldCursorShape

 Arguments

     <nCol> and <nRow> define mouse pointer coordinates.

     <nStyle> defines the style of mouse pointer using one of the
     constants listed in the table below:

     Text and Graph Constants
     ------------------------------------------------------------------------
     Constant       Description
     ------------------------------------------------------------------------
     LLM_COOR_TEXT  Specifies that the coordinates are passed in rows and
                    columns of text
     LLM_COOR_GRAPH Specifies that the coordinates are passed in pixels
     ------------------------------------------------------------------------

     <nCursorShape> is a numeric value representing the mouse cursor
     shape.  The following are the possible values predefined for this
     parameter:

     Cursor Shape Constants
     ------------------------------------------------------------------------
     Constant                 Description
     ------------------------------------------------------------------------
     LLM_CURSOR_ARROW         Standard pointer
     LLM_CURSOR_SIZE_NS       North South arrow
     LLM_CURSOR_SIZE_WE       West East arrow
     LLM_CURSOR_SIZE_NW_SE    North-West South-East arrow
     LLM_CURSOR_SIZE_NE_SW    North-East South-West arrow
     LLM_CURSOR_HAND          Hand
     LLM_CURSOR_FINGER        Hand with one pointing finger
     LLM_CURSOR_CROSS         Cross
     LLM_CURSOR_WAIT          Hourglass
     ------------------------------------------------------------------------

 Returns

     MSHOW() returns the previously used cursor shape.  See <nCurorShape>
     above for further information.

 Description

     MSHOW() displays the mouse pointer.  It is generally used without
     parameters to simply redisplay the mouse pointer at the position where
     MHIDE() hid it (assuming the user has not moved the mouse).

     It is possible to use two sets of parameters with this function.

     .  Specify the coordinates where the pointer should appear.  In
        this case, three parameters must be passed:  the mode and its
        coordinates.  In text mode, coordinates are passed as row and column.
        In graphic mode, you can pass either text or graphic coordinates.
        Conversion is done automatically based on the font size of the
        current characters.

     .  You can also specify the mouse cursor shape to be displayed
        when the mouse is visible.  This feature is available in graphic mode
        only.

     It is important to hide the mouse pointer before any new screen display,
     and then show it again.  See MHIDE() for further information on how to
     do this.

     Note:  The MSETCURSOR() function should be used in place of MSHOW()
     and MHIDE().  It is kept here for compatibility.

 Examples

     .  The following example hides the mouse pointer before using an
        @...SAY command and then redisplays it.  Next, the mouse pointer is
        repositioned, hidden, changed to an hour-glass, and then restored to
        its previous shape:

        LOCAL nOldShape := 0
        MHIDE()
           @ 10, 20 say "Hello world!!!"
        MSHOW()
        // Position the pointer at the center of the screen
        MSHOW(MAXCOL() / 2, MAXROW() / 2, LLM_COOR_TEXT)
        MHIDE()
           @ 10, 20 say "Please wait ..."
        // Display an hour glass cursor
        nOldShape := MSHOW(LLM_CURSOR_WAIT)
        // Your code
        // Restore previously used cursor
        MSHOW(nOldShape)

 Files   Library is LLIBG.LIB, header file is Llibg.ch.


See Also: MHIDE() MSETCLIP() MSHOW()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson