Nano-X API Reference Manual
<<< Previous Page | Home | Up | Next 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 Page | Home | Up | Next Page >>>
fonts | colours