Struct gdk4::Cursor

#[repr(transparent)]
pub struct Cursor { /* private fields */ }

Cursor is used to create and destroy cursors.

Cursors are immutable objects, so once you created them, there is no way to modify them later. You should create a new cursor when you want to change something about it.

Cursors by themselves are not very interesting: they must be bound to a window for users to see them. This is done with SurfaceExt::set_cursor() or SurfaceExt::set_device_cursor(). Applications will typically use higher-level GTK functions such as Gtk::Widget::set_cursor() instead.

Cursors are not bound to a given Display, so they can be shared. However, the appearance of cursors may vary when used on different platforms.

Named and texture cursors

There are multiple ways to create cursors. The platform’s own cursors can be created with from_name(). That function lists the commonly available names that are shared with the CSS specification. Other names may be available, depending on the platform in use. On some platforms, what images are used for named cursors may be influenced by the cursor theme.

Another option to create a cursor is to use from_texture() and provide an image to use for the cursor.

To ease work with unsupported cursors, a fallback cursor can be provided. If a Surface cannot use a cursor because of the reasons mentioned above, it will try the fallback cursor. Fallback cursors can themselves have fallback cursors again, so it is possible to provide a chain of progressively easier to support cursors. If none of the provided cursors can be supported, the default cursor will be the ultimate fallback.

Implementations

impl Cursor

pub fn from_name(name: &str, fallback: Option<&Cursor>) -> Option<Cursor>

Creates a new cursor by looking up @name in the current cursor theme.

A recommended set of cursor names that will work across different platforms can be found in the CSS specification:

“none”	“default”	“help”	“pointer”
“context-menu”	“progress”	“wait”	“cell”
“crosshair”	“text”	“vertical-text”	“alias”
“copy”	“no-drop”	“move”	“not-allowed”
“grab”	“grabbing”	“all-scroll”	“col-resize”
“row-resize”	“n-resize”	“e-resize”	“s-resize”
“w-resize”	“ne-resize”	“nw-resize”	“sw-resize”
“se-resize”	“ew-resize”	“ns-resize”	“nesw-resize”
“nwse-resize”	“zoom-in”	“zoom-out”

name

the name of the cursor

fallback

None or the Cursor to fall back to when this one cannot be supported

Returns

a new Cursor, or None if there is no cursor with the given name

pub fn from_texture(
    texture: &impl IsA<Texture>,
    hotspot_x: i32,
    hotspot_y: i32,
    fallback: Option<&Cursor>
) -> Cursor

Creates a new cursor from a Texture.

texture

the texture providing the pixel data

hotspot_x

the horizontal offset of the “hotspot” of the cursor

hotspot_y

the vertical offset of the “hotspot” of the cursor

fallback

the Cursor to fall back to when this one cannot be supported

Returns

a new Cursor

pub fn builder() -> CursorBuilder

Creates a new builder-pattern struct instance to construct Cursor objects.

This method returns an instance of CursorBuilder which can be used to create Cursor objects.

pub fn fallback(&self) -> Option<Cursor>

Returns the fallback for this @self.

The fallback will be used if this cursor is not available on a given Display. For named cursors, this can happen when using nonstandard names or when using an incomplete cursor theme. For textured cursors, this can happen when the texture is too large or when the Display it is used on does not support textured cursors.

Returns

the fallback of the cursor or None to use the default cursor as fallback

pub fn hotspot_x(&self) -> i32

Returns the horizontal offset of the hotspot.

The hotspot indicates the pixel that will be directly above the cursor.

Note that named cursors may have a nonzero hotspot, but this function will only return the hotspot position for cursors created with from_texture().

Returns

the horizontal offset of the hotspot or 0 for named cursors

pub fn hotspot_y(&self) -> i32

Returns the vertical offset of the hotspot.

The hotspot indicates the pixel that will be directly above the cursor.

Note that named cursors may have a nonzero hotspot, but this function will only return the hotspot position for cursors created with from_texture().

Returns

the vertical offset of the hotspot or 0 for named cursors

pub fn name(&self) -> Option<GString>

Returns the name of the cursor.

If the cursor is not a named cursor, None will be returned.

Returns

the name of the cursor or None if it is not a named cursor

pub fn texture(&self) -> Option<Texture>

Returns the texture for the cursor.

If the cursor is a named cursor, None will be returned.

Returns

the texture for cursor or None if it is a named cursor

Trait Implementations

impl Clone for Cursor

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Cursor

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Cursor

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for Cursor

fn hash<H>(&self, state: &mut H)where
    H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where
    H: Hasher,
    Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Cursor

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere
    Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere
    Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere
    Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl ParentClassIs for Cursor

type Parent = Object

impl<OT: ObjectType> PartialEq<OT> for Cursor

fn eq(&self, other: &OT) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for Cursor

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for Cursor

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for Cursor