---
name: "cursor"
section: "3tk"
platform: "linux"
package: "tklib"
version: "0.9-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/cursor/3tk"
---

# cursor(3tk)

Procedures to handle CURSOR data

```

```

## NAME

cursor - Procedures to handle CURSOR data

## SYNOPSIS

package require **Tk**

package require **cursor ?0.3.1?**

**::cursor::propagate** *widget* *cursor*

**::cursor::restore** *widget* ?*cursor*?

**::cursor::display** ?*parent*?

```

```

## DESCRIPTION

The **cursor** package provides commands to handle Tk cursors.

## COMMANDS

The following commands are available:

- **::cursor::propagate** *widget* *cursor*

  Sets the cursor for the specified *widget* and all its descendants to *cursor*.

- **::cursor::restore** *widget* ?*cursor*?

  Restore the original or previously set cursor for the specified *widget* and all its descendants.  If *cursor* is specified, that will be used if on any widget that did not have a preset cursor (set by a previous call to **::cursor::propagate**).

- **::cursor::display** ?*parent*?

  Pops up a dialog with a listbox containing all the cursor names. Selecting a cursor name will display it in that dialog.  This is simply for viewing any available cursors on the platform.

## BUGS, IDEAS, FEEDBACK

This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such in the category *cursor* of the *Tklib Trackers* \[http://core.tcl.tk/tklib/reportlist\]. Please also report any ideas for enhancements you may have for either package and/or documentation.

## SEE ALSO

[Tk\_GetCursor(3tk)](/Tk_GetCursor/3tk.md), [cursors(3tk)](/cursors/3tk.md), [options(3tk)](/options/3tk.md)

## KEYWORDS

cursor

## COPYRIGHT

```
Copyright (c) Jeffrey Hobbs <jeff@hobbs.org>
```