函数

Gtkaccelerator_parse_with_keycode

声明 [源代码]

gboolean
gtk_accelerator_parse_with_keycode (
  const char* accelerator,
  GdkDisplay* display,
  guint* accelerator_key,
  guint** accelerator_codes,
  GdkModifierType* accelerator_mods
)

说明 [源代码]

解析表示加速器的字符串。

这类似于 gtk_accelerator_parse() 但也能处理键码。这仅对系统级组件有用,应用程序应使用 gtk_accelerator_parse() 代替。

如果给定了 accelerator_codes,并且其中存储的结果非 NULL,则必须使用 g_free() 释放结果。

如果加速器中存在键码,并且没有给出 accelerator_codes,则解析将失败。

如果解析失败,则将把 accelerator_keyaccelerator_modsaccelerator_codes 设置为 0(零)。

参数

accelerator

类型: const char*

表示加速器的字符串。

数据归函数的调用方所有。
该值是一个以 NUL 结尾的 UTF-8 字符串。
display

类型: GdkDisplay

要在其中查找 accelerator_codesGdkDisplay

该参数可以是 NULL
数据归函数的调用方所有。
accelerator_key

类型: guint*

加速器 keyval 的返回位置。

该参数将由函数设置。
该参数可以是 NULL
accelerator_codes

类型: guint* 数组

加速器 keycode 的返回位置。

该参数将由函数设置。
该参数可以是 NULL
该数组必须以 NULL 结尾。
函数的调用方拥有所返回数据的权限,并负责释放它。
accelerator_mods

类型: GdkModifierType

加速器修饰符遮罩的返回位置。

该参数将由函数设置。
该参数可以是 NULL
函数的调用方拥有所返回数据的权限,并负责释放它。

返回值

类型: gboolean

如果解析成功,则为 TRUE