Method

GioMenuItemset_action_and_target

Declaration

void
g_menu_item_set_action_and_target (
  GMenuItem* menu_item,
  const gchar* action,
  const gchar* format_string,
  ...
)

Description

Sets or unsets the “action” and “target” attributes of menu_item.

If action is NULL then both the “action” and “target” attributes are unset (and format_string is ignored along with the positional parameters).

If action is non-NULL then the “action” attribute is set. format_string is then inspected. If it is non-NULL then the proper position parameters are collected to create a GVariant instance to use as the target value. If it is NULL then the positional parameters are ignored and the “target” attribute is unset.

See also g_menu_item_set_action_and_target_value() for an equivalent call that directly accepts a GVariant. See g_menu_item_set_detailed_action() for a more convenient version that works with string-typed targets.

See also g_menu_item_set_action_and_target_value() for a description of the semantics of the action and target attributes.

Available since:2.32
This method is not directly available to language bindings.

Parameters

action const gchar*
 

The name of the action for this item.

 The argument can be NULL.
 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
format_string const gchar*
 

A GVariant format string.

 The argument can be NULL.
 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
...
 

Positional parameters, as per format_string.