接口

GtkAccessible

描述 [src]

interface Gtk.Accessible : GObject.Object

一个用于描述辅助技术 UI 元素的接口。

每个可访问的实现都有

一个“角色”，用GtkAccessibleRole 枚举值的表示
一个“属性”，用一个GtkAccessibleState、GtkAccessibleProperty和GtkAccessibleRelation值的集合表示

在实例化一个GtkAccessible实现之后，不可更改角色。

属性在 UI 元素的任何变更应反映辅助技术的更改时更新。例如，如果GtkWidget的可视性发生变化，则GTK_ACCESSIBLE_STATE_HIDDEN 状态也会更改，以反映GtkWidget:visible 属性。

每个可访问实现都是可访问对象的树的一部分。通常，此树对应于小部件树，但可以通过重写Gtk.AccessibleInterface.getAccessibleParent、Gtk.AccessibleInterface.getFirstAccessibleChild和Gtk.AccessibleInterface.getNextAccessibleSibling虚拟函数进行自定义。请注意，目前不能创建顶层可访问对象，这意味着您必须始终拥有父级可访问对象。另外，请注意，当一个可访问对象不对应于小部件时，并且它具有不由您控制实现的子项，则通过调用gtk_accessible_set_accessible_parent()和通过调用gtk_accessible_update_next_accessible_sibling()更新同辈关系来确保 a11y 树的正确形状是必要的。

先决条件

要实现 Accessible，您的类型必须从GObject继承。

实现

实例方法

gtk_accessible_announce

请求用户的屏幕阅读器广播指定消息。

自：4.14

gtk_accessible_get_accessible_parent

检索可访问对象的父级。

自：4.10

gtk_accessible_get_accessible_role

检索可访问对象的访问角色。

gtk_accessible_get_at_context

检索给定可访问对象的实现。

自：4.10

gtk_accessible_get_bounds

查询此可访问对象的坐标和尺寸。

自：4.10

gtk_accessible_get_first_accessible_child

检索可访问对象的第一可访问子对象。

自：4.10

gtk_accessible_get_nextAccessible_sibling

检索可访问对象的下一个可访问兄弟节点。

自：4.10

gtk_accessible_get_platform_state

查询平台状态，如焦点。

自：4.10

gtk_accessible_reset_property

将可访问属性重置为其默认值。

gtk_accessible_reset_relation

将可访问关系重置为其默认值。

gtk_accessible_reset_state

将可访问状态重置为其默认值。

gtk_accessible_set_accessible_parent

设置可访问对象的父级和兄弟节点。

自：4.10

gtk_accessible_update_nextAccessible_sibling

更新下一个可访问兄弟节点。

自：4.10

gtk_accessible_update_property

更新一系列可访问属性。

gtk_accessible_updatePropertyValue

更新一系列可访问属性。

gtk_accessible_update_relation

更新一系列可访问关系。

gtk_accessible_update_relation_value

更新一系列可访问关系。

gtk_accessible_update_state

更新一系列可访问状态。

gtk_accessible_update_state_value

更新一系列可访问状态。

属性

Gtk.Accessible:可访问角色

指定 GtkAccessible 实现的可访问角色。

接口结构

struct GtkAccessibleInterface {
  GTypeInterface g_iface;
  GtkATContext* (* get_at_context) (
    GtkAccessible* self
  );
  gboolean (* get_platform_state) (
    GtkAccessible* self,
    GtkAccessiblePlatformState state
  );
  GtkAccessible* (* get_accessible_parent) (
    GtkAccessible* self
  );
  GtkAccessible* (* get_first_accessible_child) (
    GtkAccessible* self
  );
  GtkAccessible* (* get_next_accessible_sibling) (
    GtkAccessible* self
  );
  gboolean (* get_bounds) (
    GtkAccessible* self,
    int* x,
    int* y,
    int* width,
    int* height
  );
  
}

可访问对象的通用接口。

接口成员

`g_iface`	`GTypeInterface`
	无描述信息。
`get_at_context`	`GtkATContext* (* get_at_context) ( GtkAccessible* self )`
	检索可访问实现的平台特定可访问上下文。
`get_platform_state`	`gboolean (* get_platform_state) ( GtkAccessible* self, GtkAccessiblePlatformState state )`
	检索可访问状态。
`get_accessible_parent`	`GtkAccessible* (* get_accessible_parent) ( GtkAccessible* self )`
	无描述信息。
`get_first_accessible_child`	`GtkAccessible* (* get_first_accessible_child) ( GtkAccessible* self )`
	无描述信息。
`get_next_accessible_sibling`	`GtkAccessible* (* get_next_accessible_sibling) ( GtkAccessible* self )`
	无描述信息。
`get_bounds`	`gboolean (* get_bounds) ( GtkAccessible* self, int* x, int* y, int* width, int* height )`
	无描述信息。