head 1.1; branch 1.1.1; access ; symbols MW_0_8_9PRE7:1.1.1.1 MM:1.1.1; locks ; strict; comment @# @; 1.1 date 2002.02.15.09.17.30; author markom; state Exp; branches 1.1.1.1; next ; 1.1.1.1 date 2002.02.15.09.17.30; author markom; state Exp; branches ; next ; desc @@ 1.1 log @Initial revision @ text @pointer
Nano-X API Reference Manual
<<< Previous PageHomeUpNext Page >>>

pointer

Name

pointer —

Synopsis



void        GrSetCursor                     (GR_WINDOW_ID wid,
                                             GR_SIZE width,
                                             GR_SIZE height,
                                             GR_COORD hotx,
                                             GR_COORD hoty,
                                             GR_COLOR foreground,
                                             GR_COLOR background,
                                             GR_BITMAP *fbbitmap,
                                             GR_BITMAP *bgbitmap);
void        GrMoveCursor                    (GR_COORD x,
                                             GR_COORD y);
void        GrInjectPointerEvent            (MWCOORD x,
                                             MWCOORD y,
                                             int button,
                                             int visible);

Description

Details

GrSetCursor ()

void        GrSetCursor                     (GR_WINDOW_ID wid,
                                             GR_SIZE width,
                                             GR_SIZE height,
                                             GR_COORD hotx,
                                             GR_COORD hoty,
                                             GR_COLOR foreground,
                                             GR_COLOR background,
                                             GR_BITMAP *fbbitmap,
                                             GR_BITMAP *bgbitmap);

Specifies a cursor (mouse pointer graphic) to display when the mouse pointer is over the specified window and subsequently created children. Points in the bitmap which have neither the foreground or background bits set are not painted.

wid : the ID of the window to set the cursor of
width : the width of the pointer bitmap
height : the height of the pointer bitmap
hotx : the X coordinate within the bitmap used as the target of the pointer
hoty : the Y coordinate within the bitmap used as the target of the pointer
foreground : the colour to use for the foreground of the pointer
background : the colour to use for the background of the pointer
fbbitmap : 
bgbitmap : pointer to bitmap data specifying the background of the pointer

GrMoveCursor ()

void        GrMoveCursor                    (GR_COORD x,
                                             GR_COORD y);

Moves the cursor (mouse pointer) to the specified coordinates. The coordinates are relative to the root window, where (0,0) is the upper left hand corner of the screen. The reference point used for the pointer is that of the "hot spot". After moving the pointer, the graphic used for the pointer will change to the graphic defined for use in the window which it is over.

x : the X coordinate to move the pointer to
y : the Y coordinate to move the pointer to

GrInjectPointerEvent ()

void        GrInjectPointerEvent            (MWCOORD x,
                                             MWCOORD y,
                                             int button,
                                             int visible);

Sets the pointer invisible if the visible parameter is GR_FALSE, or visible if it is GR_TRUE, then moves the pointer to the specified position and generates a mouse event with the specified button status. Also performs a GrFlush() so that the event takes effect immediately.

x : the X coordinate of the pointer event relevant to the root window
y : the Y coordinate of the pointer event relevant to the root window
button : the pointer button status
visible : whether to display the pointer after the event



<<< Previous PageHomeUpNext Page >>>
fontscolours
@ 1.1.1.1 log @modified offitial version of microwindows 0.89-pre7 @ text @@