方法

GtkActionableset_action_target_value

声明 [src]

void
gtk_actionable_set_action_target_value (
  GtkActionable* actionable,
  GVariant* target_value
)

描述 [src]

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

如果 target_valueNULL 则目标值将被清除。

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

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

参数

target_value

类型: GVariant

用于设置目标值的 GVariant

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