| Home ⋅ All Commands ⋅ Grouped Commands ⋅ List of all modules ⋅ FAQ (on line) |

## CursorStyle

`CursorStyle` `context` [ `num` | `name` | None | Tiny | `file` [ `x` `y` ] [ `fg` `bg` ]]

Defines a new cursor for the specified context. Note that this command can not control the shapes an applications uses, for example, to indicate that it is busy. The various contexts are:

POSITION (top_left_corner)

  used when initially placing windows

TITLE (top_left_arrow)

  used in a window title-bar

DEFAULT (top_left_arrow)

  used in windows that do not set their cursor

SYS (hand2)

  used in one of the title-bar buttons

MOVE (fleur)

  used when moving or resizing windows

RESIZE (sizing)

  used when moving or resizing windows

WAIT (watch)

  used during certain fvwm commands (see BusyCursor for details)

MENU (top_left_arrow)

  used in menus

SELECT (crosshair)

  used when the user is required to select a window

DESTROY (pirate)

  used for Destroy, Close, and Delete commands

TOP (top_side)

  used in the top side-bar of a window

RIGHT (right_side)

  used in the right side-bar of a window

BOTTOM (bottom_side)

  used in the bottom side-bar of a window

LEFT (left_side)

  used in the left side-bar of a window

TOP_LEFT (top_left_corner)

  used in the top left corner of a window

TOP_RIGHT (top_right_corner)

  used in the top right corner of a window

BOTTOM_LEFT (bottom_left_corner)

  used in the bottom left corner of a window

BOTTOM_RIGHT (bottom_right_corner)

  used in the bottom right corner of a window

TOP_EDGE (top_side)

  used at the top edge of the screen

RIGHT_EDGE (right_side)

  used at the right edge of the screen

BOTTOM_EDGE (bottom_side)

  used at the bottom edge of the screen

LEFT_EDGE (left_side)

  used at the left edge of the screen

ROOT (left_ptr)

  used as the root cursor

STROKE (plus)

  used during a StrokeFunc command.

The defaults are shown in parentheses above. If you ever want to restore the default cursor for a specific context you can omit the second argument.

The second argument is either the numeric value of the cursor as defined in the include file `X11/cursorfont.h` or its name (without the XC_ prefix). Alternatively, the xpm file name may be specified. The name can also be None (no cursor) or Tiny (a single pixel as the cursor).

    # make the kill cursor be XC_gumby (both forms work):
    CursorStyle DESTROY 56
    CursorStyle DESTROY gumby

Alternatively, the cursor can be loaded from an (XPM, PNG or SVG) image `file`. If fvwm is compiled with Xcursor support, full ARGB is used, and (possibly animated) cursor files made with the xcursorgen program can be loaded. Otherwise the cursor is converted to monochrome.

The optional `x` and `y` arguments (following a `file` argument) specifies the hot-spot coordinate with 0 0 as the top left corner of the image. Coordinates within the image boundary are valid and overrides any hot-spot defined in the (XPM/Xcursor) image file. An invalid or undefined hot-spot is placed in the center of the image.

    CursorStyle ROOT cursor_image.png 0 0

The optional `fg` and `bg` arguments specify the foreground and background colors for the cursor, defaulting to black and white (reverse video compared to the actual bitmap). These colors are only used with monochrome cursors. Otherwise they are silently ignored.

    CursorStyle ROOT nice_arrow.xpm yellow black

fvwm 2.6.8