# 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:

(top_left_corner)

  used when initially placing windows

(top_left_arrow)

  used in a window title-bar

(top_left_arrow)

  used in windows that do not set their cursor

(hand2)

  used in one of the title-bar buttons

(fleur)

  used when moving or resizing windows

(sizing)

  used when moving or resizing windows

(watch)

  used during certain fvwm commands (see for details)

(top_left_arrow)

  used in menus

(crosshair)

  used when the user is required to select a window

(pirate)

  used for , , and commands

(top_side)

  used in the top side-bar of a window

(right_side)

  used in the right side-bar of a window

(bottom_side)

  used in the bottom side-bar of a window

(left_side)

  used in the left side-bar of a window

(top_left_corner)

  used in the top left corner of a window

(top_right_corner)

  used in the top right corner of a window

(bottom_left_corner)

  used in the bottom left corner of a window

(bottom_right_corner)

  used in the bottom right corner of a window

(top_side)

  used at the top edge of the screen

(right_side)

  used at the right edge of the screen

(bottom_side)

  used at the bottom edge of the screen

(left_side)

  used at the left edge of the screen

(left_ptr)

  used as the root cursor

(plus)

  used during a 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 (no cursor) or (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