虚函数

GioActionGroupget_action_state_hint

since: 2.28

声明 [来源]

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

描述 [来源]

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

如果返回NULL，这意味着动作无状态，或没有关于动作状态的有效值范围的提示。

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

在任何情况下，信息仅是提示。可能存在提示范围之外的状态值，并且在该范围内设置值可能会失败。

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

Available since: 2.28

参数

action_name

类型： const gchar*

要查询的动作名称。

数据由方法调用者拥有。
值是空终止的UTF-8字符串。

返回值

类型： GVariant

状态范围提示。

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