GdkCursor

描述 [src]

final class Gdk.Cursor : GObject.Object
{
  /* No available fields */
}

GdkCursor 用于创建和销毁光标。

光标是不变的对象,所以一旦你创建了它们,就无法在以后修改它们。当你想要更改它的某些内容时,你应该创建一个新的光标。

光标本身并不太有趣:它们必须绑定到窗口才能让用户看到它们。这是通过 gdk_surface_set_cursor()gdk_surface_set_device_cursor() 完成的。应用程序通常会使用更高级的 GTK 函数,例如 gtk_widget_set_cursor() 。

光标不绑定到给定的 GdkDisplay,所以它们可以共享。但是,光标的外观在不同的平台上使用时可能会有所不同。

命名和纹理光标

创建光标有多种方法。可以用 gdk_cursor_new_from_name() 创建平台自己的光标。该函数列出了与 CSS 规范共享的常用可用名称。根据所使用的平台,可能还有其他名称可用。在某些平台上,命名光标所使用的图像可能会受到光标主题的影响。

创建光标的另一种选择是使用 gdk_cursor_new_from_texture() 并提供要用于光标的图像。

为了方便使用不受支持的光标,可以提供一个后备光标。如果 GdkSurface 由于上述原因而无法使用光标,它将尝试后备光标。后备光标本身还可以再次具有后备光标,因此可以提供一系列逐渐更容易支持的光标。如果无法支持任何提供的光标,则默认光标将成为最终的后备。

层次

hierarchy this GdkCursor ancestor_0 GObject ancestor_0--this

祖先

构造函数

gdk_cursor_new_from_callback

创建一个新的基于回调的光标对象。

自:4.16

gdk_cursor_new_from_name

通过在当前光标主题中查找 name 来创建一个新的光标。

gdk_cursor_new_from_texture

GdkTexture 创建一个新的光标。

实例方法

gdk_cursor_get_fallback

返回此 cursor 的后备。

gdk_cursor_get_hotspot_y

返回热点在 y 轴上的偏移量。

gdk_cursor_get_name

获取光标的名称。

gdk_cursor_get_texture

获取光标的纹理。

GObject (43) 继承的方法

有关方法的完整列表,请参见 GObject

属性

Gdk.Cursor:fallback

无法显示光标时需要回退到的光标。

Gdk.Cursor:hotspot-x

光标热点的 X 轴位置,位于光标图像中。

Gdk.Cursor:hotspot-y

光标热点的 Y 轴位置,位于光标图像中。

Gdk.Cursor:name

此光标的名称。

Gdk.Cursor:texture

此光标显示的纹理。

信号

GObject (1) 继承的信号
GObject::notify

notify 信号在对对象的某个属性通过 g_object_set_property()、g_object_set() 等进行值设置后在该对象上发出。