2.1.15 cursor%

► |  | GUI: Racket Graphics Toolkit

1 | Overview
2 | Reference
3 | Configuration
4 | Dynamic Loading
| Bibliography
| Index

► | 2 | Reference

2.1 | Windowing Classes
2.2 | Windowing Functions
2.3 | Drawing Classes
2.4 | Drawing Functions
2.5 | Editor Classes
2.6 | Editor Functions
2.7 | WXME Decoding

▼ | 2.1 | Windowing Classes

2.1.1 | area<%>
2.1.2 | area-container<%>
2.1.3 | area-container-window<%>
2.1.4 | button%
2.1.5 | canvas<%>
2.1.6 | canvas%
2.1.7 | check-box%
2.1.8 | checkable-menu-item%
2.1.9 | choice%
2.1.10 | clipboard-client%
2.1.11 | clipboard<%>
2.1.12 | combo-field%
2.1.13 | control<%>
2.1.14 | control-event%
2.1.15 | cursor%
2.1.16 | dialog%
2.1.17 | event%
2.1.18 | frame%
2.1.19 | gauge%
2.1.20 | group-box-panel%
2.1.21 | grow-box-spacer-pane%
2.1.22 | horizontal-pane%
2.1.23 | horizontal-panel%
2.1.24 | key-event%
2.1.25 | labelled-menu-item<%>
2.1.26 | list-box%
2.1.27 | list-control<%>
2.1.28 | menu%
2.1.29 | menu-bar%
2.1.30 | menu-item<%>
2.1.31 | menu-item%
2.1.32 | menu-item-container<%>
2.1.33 | message%
2.1.34 | mouse-event%
2.1.35 | pane%
2.1.36 | panel%
2.1.37 | popup-menu%
2.1.38 | radio-box%
2.1.39 | selectable-menu-item<%>
2.1.40 | separator-menu-item%
2.1.41 | scroll-event%
2.1.42 | slider%
2.1.43 | subarea<%>
2.1.44 | subwindow<%>
2.1.45 | tab-panel%
2.1.46 | text-field%
2.1.47 | timer%
2.1.48 | top-level-window<%>
2.1.49 | vertical-pane%
2.1.50 | vertical-panel%
2.1.51 | window<%>

On this page:

ok?

top← prev up next →

cursor% : class?
superclass: object%

A cursor is a small icon that indicates the location of the mouse pointer. The bitmap image typically indicates the current mode or meaning of a mouse click at its current location.

A cursor is assigned to each window (or the window may use its parent’s cursor; see set-cursor for more information), and the pointer image is changed to match the window’s cursor when the pointer is moved over the window. Each cursor object may be assigned to many windows.

( make-object cursor% |  | image |  |  |  |
|  | mask |  |  |  |
| [ | hot-spot-x |  |  |  |
|  | hot-spot-y]) |  | → |  | ( is-a?/c cursor%)

image : ( is-a?/c bitmap%)
mask : ( is-a?/c bitmap%)
hot-spot-x : ( integer-in 0 15) = 0
hot-spot-y : ( integer-in 0 15) = 0
( make-object cursor% id) → ( is-a?/c cursor%)

id

:

( one-of/c 'arrow 'bullseye 'cross 'hand 'ibeam 'watch 'blank
'size-n/s 'size-e/w 'size-ne/sw 'size-nw/se)

The first case creates a cursor using an image bitmap and a mask bitmap. Both bitmaps must have depth 1 and size 16 by 16 pixels. The hot-spot-x and hot-spot-y arguments determine the focus point of the cursor within the cursor image, relative to its top-left corner.

The second case creates a cursor using a stock cursor, specified as one of the following:

- 'arrow – the default cursor

- 'bullseye – concentric circles

- 'cross – a crosshair

- 'hand – an open hand

- 'ibeam – a vertical line, indicating that clicks control a text-selection caret

- 'watch – a watch or hourglass, indicating that the user must wait for a computation to complete

- 'arrow+watch – the default cursor with a watch or hourglass, indicating that some computation is in progress, but the cursor can still be used

- 'blank – invisible

- 'size-e/w – arrows left and right

- 'size-n/s – arrows up and down

- 'size-ne/sw – arrows up-right and down-left

- 'size-nw/se – arrows up-left and down-right

If the cursor is created successfully, ok? returns #t, otherwise the cursor object cannot be assigned to a window.

( send a-cursor ok?) → boolean?

Returns #t if the cursor is can be assigned to a window, #f otherwise.
top← prev up next →