虚函数

GtkAccessibleTextget_attributes

自 4.14

声明 [源]

gboolean
get_attributes (
  GtkAccessibleText* self,
  unsigned int offset,
  gsize* n_ranges,
  GtkAccessibleTextRange** ranges,
  char*** attribute_names,
  char*** attribute_values
)

描述 [源]

检索可访问对象内的文本属性。

每个属性由以下组成：

  • 一个范围
  • 一个名称
  • 一个值

将值字符串化的序列化格式由实现者决定。

GTK 为各种文本属性名称和值提供支持，但实现本接口的可以自行添加属性。

如果此函数返回 true，则 n_ranges 将设置为大于或等于 1 的值，ranges 将设置为新分配的 struct#Gtk.AccessibleTextRange 数组。

自 4.14 以来可用

参数

offset

类型： unsigned int

以字符为单位的偏移量。

n_ranges

类型： gsize*

属性的个数。

该参数将由函数设置。
ranges

类型：数组，元素为 GtkAccessibleTextRange*

可访问对象内属性的范围。

该参数将由函数设置。
该参数可以是 NULL。
数组长度由 n_ranges 参数指定。
方法调用者拥有返回数据容器但其内部数据。
attribute_names

类型：数组，元素为 char**

可访问对象内属性的名称。

该参数将由函数设置。
该参数可以是 NULL。
该数组必须是 NULL 终止的。
方法调用者拥有返回数据，并负责释放它。
每个元素都是 NUL 终止的 UTF-8 字符串。
attribute_values

类型：数组，元素为 char**

可访问对象内属性的值。

该参数将由函数设置。
该参数可以是 NULL。
该数组必须是 NULL 终止的。
方法调用者拥有返回数据，并负责释放它。
每个元素都是 NUL 终止的 UTF-8 字符串。

返回值

类型： gboolean

如果可访问对象至少有一个属性则返回 true，否则返回 false。