方法

GioActionGroupget_action_state_hint

版本：2.28

声明 [源代码]

GVariant*
g_action_group_get_action_state_hint (
  GActionGroup* action_group,
  const gchar* action_name
)

描述 [源代码]

请求关于命名动作在 action_group 中状态有效值范围的提示。

如果返回 NULL，则表示该动作不是状态性的，或者没有关于动作状态有效值范围的提示。

如果返回的是一个 GVariant 数组，则数组中的每个项都是状态的可能值。如果一个 GVariant 对（即：二元组）被返回，那么这个对指定了状态的有效值的上下限。

无论如何，这个信息只是一个提示。可能存在状态值在提示范围内，设置一个值在范围内可能会失败。

当不再需要时，应该使用 g_variant_unref() 释放返回值（如果非 NULL）。

自版本：2.28

参数

action_name

类型： const gchar*

要查询的动作的名称。

数据由方法调用者拥有。
值是一个以 NUL 结尾的 UTF-8 字符串。

返回值

类型： GVariant

状态范围提示。

方法调用者拥有返回数据，并负责释放它。
返回值可以是 NULL。