虚函数

GtkActionableset_action_target_value

声明 [源代码]

void
set_action_target_value (
  GtkActionable* actionable,
  GVariant* target_value
)

描述 [源代码]

设置可操作小部件的目标值。

如果 target_valueNULL,则取消设置目标值。

目标值有两个用途。首先,它用作与 GtkActionable 小部件相关联的动作的激活参数。其次,它用于确定小部件是否应渲染为“活动状态”——小部件处于活动状态如果状态等于所给的目标。

考虑将一组按钮与具有字符串状态的典型“单选按钮”情况中的 GAction 关联的例子。每个按钮都将关联到同一动作,但该动作具有不同的目标值。点击特定的按钮将激活具有该按钮目标的动作,这将通常导致将动作的状态更改为该值。由于动作的状态现在等于按钮的目标值,该按钮现在将渲染为活动状态(而其他具有不同目标的按钮将渲染为非活动状态)。

参数

target_value

类型: GVariant

要将目标值设置的 GVariant

该参数可以是 NULL
数据由方法的调用者拥有。