forked from AuroraMiddleware/gtk
bb72b647f6
Rework the way actions and proxies interact, to make the
interaction less ad hoc, more extensible, and better suited
for support in GUI builders like glade.
To be used as a proxy, a widget must now implement the
GtkActivatable interface, and GtkActivatable implementations
are responsible for syncing their appearance with the action
and for activating the action.
All the widgets that are commonly used as proxies implement
GtkActivatable now.
Patch by Tristan van Berkom.
* gtk/gtkactivatable.[hc]: The GtkActivatable interface.
* gtk/gtkbutton.c:
* gtk/gtktogglebutton.c:
* gtk/gtktoolitem.c:
* gtk/gtktoolbutton.c:
* gtk/gtktoggletoolbutton.c:
* gtk/gtkmenuitem.c:
* gtk/gtkcheckmenuitem.c:
* gtk/gtkimagemenuitem.c:
* gtk/gtkradiomenuitem.c:
* gtk/gtkrecentchooserprivate.h:
* gtk/gtkrecentchooser.c:
* gtk/gtkrecentchooserdefault.c:
* gtk/gtkrecentchoosermenu.c: Implement GtkActivatable.
* gtk/gtkaction.[hc]: Move appearance synchronization to
GtkActivatable implementations.
* gtk/gtkradioaction.c:
* gtk/gtkrecentaction.c:
* gtk/gtktoggleaction.c:
* gtk/gtkactiongroup.c: Adapt.
* gtk/gtk.h: Include gtkactivatable.h
* gtk/gtk.symbols: Add new functions
svn path=/trunk/; revision=22195
1834 lines
47 KiB
C
1834 lines
47 KiB
C
/*
|
|
* GTK - The GIMP Toolkit
|
|
* Copyright (C) 1998, 1999 Red Hat, Inc.
|
|
* All rights reserved.
|
|
*
|
|
* This Library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library General Public License as
|
|
* published by the Free Software Foundation; either version 2 of the
|
|
* License, or (at your option) any later version.
|
|
*
|
|
* This Library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Library General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Library General Public
|
|
* License along with the Gnome Library; see the file COPYING.LIB. If not,
|
|
* write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
/*
|
|
* Author: James Henstridge <james@daa.com.au>
|
|
*
|
|
* Modified by the GTK+ Team and others 2003. See the AUTHORS
|
|
* file for a list of people on the GTK+ Team. See the ChangeLog
|
|
* files for a list of changes. These files are distributed with
|
|
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
|
|
*/
|
|
|
|
#include "config.h"
|
|
|
|
#include "gtkaction.h"
|
|
#include "gtkactiongroup.h"
|
|
#include "gtkaccellabel.h"
|
|
#include "gtkbutton.h"
|
|
#include "gtkiconfactory.h"
|
|
#include "gtkimage.h"
|
|
#include "gtkimagemenuitem.h"
|
|
#include "gtkintl.h"
|
|
#include "gtklabel.h"
|
|
#include "gtkmarshalers.h"
|
|
#include "gtkmenuitem.h"
|
|
#include "gtkstock.h"
|
|
#include "gtktearoffmenuitem.h"
|
|
#include "gtktoolbutton.h"
|
|
#include "gtktoolbar.h"
|
|
#include "gtkprivate.h"
|
|
#include "gtkbuildable.h"
|
|
#include "gtkactivatable.h"
|
|
#include "gtkalias.h"
|
|
|
|
|
|
#define GTK_ACTION_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_ACTION, GtkActionPrivate))
|
|
|
|
struct _GtkActionPrivate
|
|
{
|
|
const gchar *name; /* interned */
|
|
gchar *label;
|
|
gchar *short_label;
|
|
gchar *tooltip;
|
|
gchar *stock_id; /* stock icon */
|
|
gchar *icon_name; /* themed icon */
|
|
GIcon *gicon;
|
|
|
|
guint sensitive : 1;
|
|
guint visible : 1;
|
|
guint label_set : 1; /* these two used so we can set label */
|
|
guint short_label_set : 1; /* based on stock id */
|
|
guint visible_horizontal : 1;
|
|
guint visible_vertical : 1;
|
|
guint is_important : 1;
|
|
guint hide_if_empty : 1;
|
|
guint visible_overflown : 1;
|
|
guint recursion_guard : 1;
|
|
guint activate_blocked : 1;
|
|
|
|
/* accelerator */
|
|
guint accel_count;
|
|
GtkAccelGroup *accel_group;
|
|
GClosure *accel_closure;
|
|
GQuark accel_quark;
|
|
|
|
GtkActionGroup *action_group;
|
|
|
|
/* list of proxy widgets */
|
|
GSList *proxies;
|
|
};
|
|
|
|
enum
|
|
{
|
|
ACTIVATE,
|
|
LAST_SIGNAL
|
|
};
|
|
|
|
enum
|
|
{
|
|
PROP_0,
|
|
PROP_NAME,
|
|
PROP_LABEL,
|
|
PROP_SHORT_LABEL,
|
|
PROP_TOOLTIP,
|
|
PROP_STOCK_ID,
|
|
PROP_ICON_NAME,
|
|
PROP_GICON,
|
|
PROP_VISIBLE_HORIZONTAL,
|
|
PROP_VISIBLE_VERTICAL,
|
|
PROP_VISIBLE_OVERFLOWN,
|
|
PROP_IS_IMPORTANT,
|
|
PROP_HIDE_IF_EMPTY,
|
|
PROP_SENSITIVE,
|
|
PROP_VISIBLE,
|
|
PROP_ACTION_GROUP
|
|
};
|
|
|
|
/* GtkBuildable */
|
|
static void gtk_action_buildable_init (GtkBuildableIface *iface);
|
|
static void gtk_action_buildable_set_name (GtkBuildable *buildable,
|
|
const gchar *name);
|
|
static const gchar* gtk_action_buildable_get_name (GtkBuildable *buildable);
|
|
|
|
G_DEFINE_TYPE_WITH_CODE (GtkAction, gtk_action, G_TYPE_OBJECT,
|
|
G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,
|
|
gtk_action_buildable_init))
|
|
|
|
static void gtk_action_finalize (GObject *object);
|
|
static void gtk_action_set_property (GObject *object,
|
|
guint prop_id,
|
|
const GValue *value,
|
|
GParamSpec *pspec);
|
|
static void gtk_action_get_property (GObject *object,
|
|
guint prop_id,
|
|
GValue *value,
|
|
GParamSpec *pspec);
|
|
static void gtk_action_set_action_group (GtkAction *action,
|
|
GtkActionGroup *action_group);
|
|
|
|
static GtkWidget *create_menu_item (GtkAction *action);
|
|
static GtkWidget *create_tool_item (GtkAction *action);
|
|
static void connect_proxy (GtkAction *action,
|
|
GtkWidget *proxy);
|
|
static void disconnect_proxy (GtkAction *action,
|
|
GtkWidget *proxy);
|
|
|
|
static void closure_accel_activate (GClosure *closure,
|
|
GValue *return_value,
|
|
guint n_param_values,
|
|
const GValue *param_values,
|
|
gpointer invocation_hint,
|
|
gpointer marshal_data);
|
|
|
|
static guint action_signals[LAST_SIGNAL] = { 0 };
|
|
|
|
|
|
static void
|
|
gtk_action_class_init (GtkActionClass *klass)
|
|
{
|
|
GObjectClass *gobject_class;
|
|
|
|
gobject_class = G_OBJECT_CLASS (klass);
|
|
|
|
gobject_class->finalize = gtk_action_finalize;
|
|
gobject_class->set_property = gtk_action_set_property;
|
|
gobject_class->get_property = gtk_action_get_property;
|
|
|
|
klass->activate = NULL;
|
|
|
|
klass->create_menu_item = create_menu_item;
|
|
klass->create_tool_item = create_tool_item;
|
|
klass->create_menu = NULL;
|
|
klass->menu_item_type = GTK_TYPE_IMAGE_MENU_ITEM;
|
|
klass->toolbar_item_type = GTK_TYPE_TOOL_BUTTON;
|
|
klass->connect_proxy = connect_proxy;
|
|
klass->disconnect_proxy = disconnect_proxy;
|
|
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_NAME,
|
|
g_param_spec_string ("name",
|
|
P_("Name"),
|
|
P_("A unique name for the action."),
|
|
NULL,
|
|
GTK_PARAM_READWRITE |
|
|
G_PARAM_CONSTRUCT_ONLY));
|
|
|
|
/**
|
|
* GtkAction:label:
|
|
*
|
|
* The label used for menu items and buttons that activate
|
|
* this action. If the label is %NULL, GTK+ uses the stock
|
|
* label specified via the stock-id property.
|
|
*
|
|
* This is an appearance property and thus only applies if
|
|
* #GtkActivatable:use-action-appearance is %TRUE.
|
|
*/
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_LABEL,
|
|
g_param_spec_string ("label",
|
|
P_("Label"),
|
|
P_("The label used for menu items and buttons "
|
|
"that activate this action."),
|
|
NULL,
|
|
GTK_PARAM_READWRITE));
|
|
|
|
/**
|
|
* GtkAction:short-label:
|
|
*
|
|
* A shorter label that may be used on toolbar buttons.
|
|
*
|
|
* This is an appearance property and thus only applies if
|
|
* #GtkActivatable:use-action-appearance is %TRUE.
|
|
*/
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_SHORT_LABEL,
|
|
g_param_spec_string ("short-label",
|
|
P_("Short label"),
|
|
P_("A shorter label that may be used on toolbar buttons."),
|
|
NULL,
|
|
GTK_PARAM_READWRITE));
|
|
|
|
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_TOOLTIP,
|
|
g_param_spec_string ("tooltip",
|
|
P_("Tooltip"),
|
|
P_("A tooltip for this action."),
|
|
NULL,
|
|
GTK_PARAM_READWRITE));
|
|
|
|
/**
|
|
* GtkAction:stock-id:
|
|
*
|
|
* The stock icon displayed in widgets representing this action.
|
|
*
|
|
* This is an appearance property and thus only applies if
|
|
* #GtkActivatable:use-action-appearance is %TRUE.
|
|
*/
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_STOCK_ID,
|
|
g_param_spec_string ("stock-id",
|
|
P_("Stock Icon"),
|
|
P_("The stock icon displayed in widgets representing "
|
|
"this action."),
|
|
NULL,
|
|
GTK_PARAM_READWRITE));
|
|
/**
|
|
* GtkAction:gicon:
|
|
*
|
|
* The #GIcon displayed in the #GtkAction.
|
|
*
|
|
* Note that the stock icon is preferred, if the #GtkAction:stock-id
|
|
* property holds the id of an existing stock icon.
|
|
*
|
|
* This is an appearance property and thus only applies if
|
|
* #GtkActivatable:use-action-appearance is %TRUE.
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_GICON,
|
|
g_param_spec_object ("gicon",
|
|
P_("GIcon"),
|
|
P_("The GIcon being displayed"),
|
|
G_TYPE_ICON,
|
|
GTK_PARAM_READWRITE));
|
|
/**
|
|
* GtkAction:icon-name:
|
|
*
|
|
* The name of the icon from the icon theme.
|
|
*
|
|
* Note that the stock icon is preferred, if the #GtkAction:stock-id
|
|
* property holds the id of an existing stock icon, and the #GIcon is
|
|
* preferred if the #GtkAction:gicon property is set.
|
|
*
|
|
* This is an appearance property and thus only applies if
|
|
* #GtkActivatable:use-action-appearance is %TRUE.
|
|
*
|
|
* Since: 2.10
|
|
*/
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_ICON_NAME,
|
|
g_param_spec_string ("icon-name",
|
|
P_("Icon Name"),
|
|
P_("The name of the icon from the icon theme"),
|
|
NULL,
|
|
GTK_PARAM_READWRITE));
|
|
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_VISIBLE_HORIZONTAL,
|
|
g_param_spec_boolean ("visible-horizontal",
|
|
P_("Visible when horizontal"),
|
|
P_("Whether the toolbar item is visible when the toolbar "
|
|
"is in a horizontal orientation."),
|
|
TRUE,
|
|
GTK_PARAM_READWRITE));
|
|
/**
|
|
* GtkAction:visible-overflown:
|
|
*
|
|
* When %TRUE, toolitem proxies for this action are represented in the
|
|
* toolbar overflow menu.
|
|
*
|
|
* Since: 2.6
|
|
*/
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_VISIBLE_OVERFLOWN,
|
|
g_param_spec_boolean ("visible-overflown",
|
|
P_("Visible when overflown"),
|
|
P_("When TRUE, toolitem proxies for this action "
|
|
"are represented in the toolbar overflow menu."),
|
|
TRUE,
|
|
GTK_PARAM_READWRITE));
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_VISIBLE_VERTICAL,
|
|
g_param_spec_boolean ("visible-vertical",
|
|
P_("Visible when vertical"),
|
|
P_("Whether the toolbar item is visible when the toolbar "
|
|
"is in a vertical orientation."),
|
|
TRUE,
|
|
GTK_PARAM_READWRITE));
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_IS_IMPORTANT,
|
|
g_param_spec_boolean ("is-important",
|
|
P_("Is important"),
|
|
P_("Whether the action is considered important. "
|
|
"When TRUE, toolitem proxies for this action "
|
|
"show text in GTK_TOOLBAR_BOTH_HORIZ mode."),
|
|
FALSE,
|
|
GTK_PARAM_READWRITE));
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_HIDE_IF_EMPTY,
|
|
g_param_spec_boolean ("hide-if-empty",
|
|
P_("Hide if empty"),
|
|
P_("When TRUE, empty menu proxies for this action are hidden."),
|
|
TRUE,
|
|
GTK_PARAM_READWRITE));
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_SENSITIVE,
|
|
g_param_spec_boolean ("sensitive",
|
|
P_("Sensitive"),
|
|
P_("Whether the action is enabled."),
|
|
TRUE,
|
|
GTK_PARAM_READWRITE));
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_VISIBLE,
|
|
g_param_spec_boolean ("visible",
|
|
P_("Visible"),
|
|
P_("Whether the action is visible."),
|
|
TRUE,
|
|
GTK_PARAM_READWRITE));
|
|
g_object_class_install_property (gobject_class,
|
|
PROP_ACTION_GROUP,
|
|
g_param_spec_object ("action-group",
|
|
P_("Action Group"),
|
|
P_("The GtkActionGroup this GtkAction is associated with, or NULL (for internal use)."),
|
|
GTK_TYPE_ACTION_GROUP,
|
|
GTK_PARAM_READWRITE));
|
|
|
|
/**
|
|
* GtkAction::activate:
|
|
* @action: the #GtkAction
|
|
*
|
|
* The "activate" signal is emitted when the action is activated.
|
|
*
|
|
* Since: 2.4
|
|
*/
|
|
action_signals[ACTIVATE] =
|
|
g_signal_new (I_("activate"),
|
|
G_OBJECT_CLASS_TYPE (klass),
|
|
G_SIGNAL_RUN_FIRST | G_SIGNAL_NO_RECURSE,
|
|
G_STRUCT_OFFSET (GtkActionClass, activate), NULL, NULL,
|
|
g_cclosure_marshal_VOID__VOID,
|
|
G_TYPE_NONE, 0);
|
|
|
|
g_type_class_add_private (gobject_class, sizeof (GtkActionPrivate));
|
|
}
|
|
|
|
|
|
static void
|
|
gtk_action_init (GtkAction *action)
|
|
{
|
|
action->private_data = GTK_ACTION_GET_PRIVATE (action);
|
|
|
|
action->private_data->name = NULL;
|
|
action->private_data->label = NULL;
|
|
action->private_data->short_label = NULL;
|
|
action->private_data->tooltip = NULL;
|
|
action->private_data->stock_id = NULL;
|
|
action->private_data->icon_name = NULL;
|
|
action->private_data->visible_horizontal = TRUE;
|
|
action->private_data->visible_vertical = TRUE;
|
|
action->private_data->visible_overflown = TRUE;
|
|
action->private_data->is_important = FALSE;
|
|
action->private_data->hide_if_empty = TRUE;
|
|
action->private_data->activate_blocked = FALSE;
|
|
|
|
action->private_data->sensitive = TRUE;
|
|
action->private_data->visible = TRUE;
|
|
|
|
action->private_data->label_set = FALSE;
|
|
action->private_data->short_label_set = FALSE;
|
|
|
|
action->private_data->accel_count = 0;
|
|
action->private_data->accel_group = NULL;
|
|
action->private_data->accel_quark = 0;
|
|
action->private_data->accel_closure =
|
|
g_closure_new_object (sizeof (GClosure), G_OBJECT (action));
|
|
g_closure_set_marshal (action->private_data->accel_closure,
|
|
closure_accel_activate);
|
|
g_closure_ref (action->private_data->accel_closure);
|
|
g_closure_sink (action->private_data->accel_closure);
|
|
|
|
action->private_data->action_group = NULL;
|
|
|
|
action->private_data->proxies = NULL;
|
|
action->private_data->gicon = NULL;
|
|
}
|
|
|
|
static void
|
|
gtk_action_buildable_init (GtkBuildableIface *iface)
|
|
{
|
|
iface->set_name = gtk_action_buildable_set_name;
|
|
iface->get_name = gtk_action_buildable_get_name;
|
|
}
|
|
|
|
static void
|
|
gtk_action_buildable_set_name (GtkBuildable *buildable,
|
|
const gchar *name)
|
|
{
|
|
GtkAction *action = GTK_ACTION (buildable);
|
|
|
|
action->private_data->name = g_intern_string (name);
|
|
}
|
|
|
|
static const gchar *
|
|
gtk_action_buildable_get_name (GtkBuildable *buildable)
|
|
{
|
|
GtkAction *action = GTK_ACTION (buildable);
|
|
|
|
return action->private_data->name;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_new:
|
|
* @name: A unique name for the action
|
|
* @label: the label displayed in menu items and on buttons, or %NULL
|
|
* @tooltip: a tooltip for the action, or %NULL
|
|
* @stock_id: the stock icon to display in widgets representing the
|
|
* action, or %NULL
|
|
*
|
|
* Creates a new #GtkAction object. To add the action to a
|
|
* #GtkActionGroup and set the accelerator for the action,
|
|
* call gtk_action_group_add_action_with_accel().
|
|
* See <xref linkend="XML-UI"/> for information on allowed action
|
|
* names.
|
|
*
|
|
* Return value: a new #GtkAction
|
|
*
|
|
* Since: 2.4
|
|
*/
|
|
GtkAction *
|
|
gtk_action_new (const gchar *name,
|
|
const gchar *label,
|
|
const gchar *tooltip,
|
|
const gchar *stock_id)
|
|
{
|
|
g_return_val_if_fail (name != NULL, NULL);
|
|
|
|
return g_object_new (GTK_TYPE_ACTION,
|
|
"name", name,
|
|
"label", label,
|
|
"tooltip", tooltip,
|
|
"stock-id", stock_id,
|
|
NULL);
|
|
}
|
|
|
|
static void
|
|
gtk_action_finalize (GObject *object)
|
|
{
|
|
GtkAction *action;
|
|
action = GTK_ACTION (object);
|
|
|
|
g_free (action->private_data->label);
|
|
g_free (action->private_data->short_label);
|
|
g_free (action->private_data->tooltip);
|
|
g_free (action->private_data->stock_id);
|
|
g_free (action->private_data->icon_name);
|
|
|
|
if (action->private_data->gicon)
|
|
g_object_unref (action->private_data->gicon);
|
|
|
|
g_closure_unref (action->private_data->accel_closure);
|
|
if (action->private_data->accel_group)
|
|
g_object_unref (action->private_data->accel_group);
|
|
|
|
G_OBJECT_CLASS (gtk_action_parent_class)->finalize (object);
|
|
}
|
|
|
|
static void
|
|
gtk_action_set_property (GObject *object,
|
|
guint prop_id,
|
|
const GValue *value,
|
|
GParamSpec *pspec)
|
|
{
|
|
GtkAction *action;
|
|
|
|
action = GTK_ACTION (object);
|
|
|
|
switch (prop_id)
|
|
{
|
|
case PROP_NAME:
|
|
action->private_data->name = g_intern_string (g_value_get_string (value));
|
|
break;
|
|
case PROP_LABEL:
|
|
gtk_action_set_label (action, g_value_get_string (value));
|
|
break;
|
|
case PROP_SHORT_LABEL:
|
|
gtk_action_set_short_label (action, g_value_get_string (value));
|
|
break;
|
|
case PROP_TOOLTIP:
|
|
gtk_action_set_tooltip (action, g_value_get_string (value));
|
|
break;
|
|
case PROP_STOCK_ID:
|
|
gtk_action_set_stock_id (action, g_value_get_string (value));
|
|
break;
|
|
case PROP_GICON:
|
|
gtk_action_set_gicon (action, g_value_get_object (value));
|
|
break;
|
|
case PROP_ICON_NAME:
|
|
gtk_action_set_icon_name (action, g_value_get_string (value));
|
|
break;
|
|
case PROP_VISIBLE_HORIZONTAL:
|
|
gtk_action_set_visible_horizontal (action, g_value_get_boolean (value));
|
|
break;
|
|
case PROP_VISIBLE_VERTICAL:
|
|
gtk_action_set_visible_vertical (action, g_value_get_boolean (value));
|
|
break;
|
|
case PROP_VISIBLE_OVERFLOWN:
|
|
action->private_data->visible_overflown = g_value_get_boolean (value);
|
|
break;
|
|
case PROP_IS_IMPORTANT:
|
|
gtk_action_set_is_important (action, g_value_get_boolean (value));
|
|
break;
|
|
case PROP_HIDE_IF_EMPTY:
|
|
action->private_data->hide_if_empty = g_value_get_boolean (value);
|
|
break;
|
|
case PROP_SENSITIVE:
|
|
gtk_action_set_sensitive (action, g_value_get_boolean (value));
|
|
break;
|
|
case PROP_VISIBLE:
|
|
gtk_action_set_visible (action, g_value_get_boolean (value));
|
|
break;
|
|
case PROP_ACTION_GROUP:
|
|
gtk_action_set_action_group (action, g_value_get_object (value));
|
|
break;
|
|
default:
|
|
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
|
break;
|
|
}
|
|
}
|
|
|
|
static void
|
|
gtk_action_get_property (GObject *object,
|
|
guint prop_id,
|
|
GValue *value,
|
|
GParamSpec *pspec)
|
|
{
|
|
GtkAction *action;
|
|
|
|
action = GTK_ACTION (object);
|
|
|
|
switch (prop_id)
|
|
{
|
|
case PROP_NAME:
|
|
g_value_set_static_string (value, action->private_data->name);
|
|
break;
|
|
case PROP_LABEL:
|
|
g_value_set_string (value, action->private_data->label);
|
|
break;
|
|
case PROP_SHORT_LABEL:
|
|
g_value_set_string (value, action->private_data->short_label);
|
|
break;
|
|
case PROP_TOOLTIP:
|
|
g_value_set_string (value, action->private_data->tooltip);
|
|
break;
|
|
case PROP_STOCK_ID:
|
|
g_value_set_string (value, action->private_data->stock_id);
|
|
break;
|
|
case PROP_ICON_NAME:
|
|
g_value_set_string (value, action->private_data->icon_name);
|
|
break;
|
|
case PROP_GICON:
|
|
g_value_set_object (value, action->private_data->gicon);
|
|
break;
|
|
case PROP_VISIBLE_HORIZONTAL:
|
|
g_value_set_boolean (value, action->private_data->visible_horizontal);
|
|
break;
|
|
case PROP_VISIBLE_VERTICAL:
|
|
g_value_set_boolean (value, action->private_data->visible_vertical);
|
|
break;
|
|
case PROP_VISIBLE_OVERFLOWN:
|
|
g_value_set_boolean (value, action->private_data->visible_overflown);
|
|
break;
|
|
case PROP_IS_IMPORTANT:
|
|
g_value_set_boolean (value, action->private_data->is_important);
|
|
break;
|
|
case PROP_HIDE_IF_EMPTY:
|
|
g_value_set_boolean (value, action->private_data->hide_if_empty);
|
|
break;
|
|
case PROP_SENSITIVE:
|
|
g_value_set_boolean (value, action->private_data->sensitive);
|
|
break;
|
|
case PROP_VISIBLE:
|
|
g_value_set_boolean (value, action->private_data->visible);
|
|
break;
|
|
case PROP_ACTION_GROUP:
|
|
g_value_set_object (value, action->private_data->action_group);
|
|
break;
|
|
default:
|
|
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
|
break;
|
|
}
|
|
}
|
|
|
|
static GtkWidget *
|
|
create_menu_item (GtkAction *action)
|
|
{
|
|
GType menu_item_type;
|
|
|
|
menu_item_type = GTK_ACTION_GET_CLASS (action)->menu_item_type;
|
|
|
|
return g_object_new (menu_item_type, NULL);
|
|
}
|
|
|
|
static GtkWidget *
|
|
create_tool_item (GtkAction *action)
|
|
{
|
|
GType toolbar_item_type;
|
|
|
|
toolbar_item_type = GTK_ACTION_GET_CLASS (action)->toolbar_item_type;
|
|
|
|
return g_object_new (toolbar_item_type, NULL);
|
|
}
|
|
|
|
static void
|
|
remove_proxy (GtkAction *action,
|
|
GtkWidget *proxy)
|
|
{
|
|
action->private_data->proxies = g_slist_remove (action->private_data->proxies, proxy);
|
|
}
|
|
|
|
static void
|
|
connect_proxy (GtkAction *action,
|
|
GtkWidget *proxy)
|
|
{
|
|
action->private_data->proxies = g_slist_prepend (action->private_data->proxies, proxy);
|
|
|
|
if (action->private_data->action_group)
|
|
_gtk_action_group_emit_connect_proxy (action->private_data->action_group, action, proxy);
|
|
|
|
}
|
|
|
|
static void
|
|
disconnect_proxy (GtkAction *action,
|
|
GtkWidget *proxy)
|
|
{
|
|
remove_proxy (action, proxy);
|
|
|
|
if (action->private_data->action_group)
|
|
_gtk_action_group_emit_disconnect_proxy (action->private_data->action_group, action, proxy);
|
|
}
|
|
|
|
/**
|
|
* _gtk_action_sync_menu_visible:
|
|
* @action: a #GtkAction, or %NULL to determine the action from @proxy
|
|
* @proxy: a proxy menu item
|
|
* @empty: whether the submenu attached to @proxy is empty
|
|
*
|
|
* Updates the visibility of @proxy from the visibility of @action
|
|
* according to the following rules:
|
|
* <itemizedlist>
|
|
* <listitem><para>if @action is invisible, @proxy is too
|
|
* </para></listitem>
|
|
* <listitem><para>if @empty is %TRUE, hide @proxy unless the "hide-if-empty"
|
|
* property of @action indicates otherwise
|
|
* </para></listitem>
|
|
* </itemizedlist>
|
|
*
|
|
* This function is used in the implementation of #GtkUIManager.
|
|
**/
|
|
void
|
|
_gtk_action_sync_menu_visible (GtkAction *action,
|
|
GtkWidget *proxy,
|
|
gboolean empty)
|
|
{
|
|
gboolean visible = TRUE;
|
|
gboolean hide_if_empty = TRUE;
|
|
|
|
g_return_if_fail (GTK_IS_MENU_ITEM (proxy));
|
|
g_return_if_fail (action == NULL || GTK_IS_ACTION (action));
|
|
|
|
if (action == NULL)
|
|
action = gtk_activatable_get_related_action (GTK_ACTIVATABLE (proxy));
|
|
|
|
if (action)
|
|
{
|
|
/* a GtkMenu for a <popup/> doesn't have to have an action */
|
|
visible = gtk_action_is_visible (action);
|
|
hide_if_empty = action->private_data->hide_if_empty;
|
|
}
|
|
|
|
if (visible && !(empty && hide_if_empty))
|
|
gtk_widget_show (proxy);
|
|
else
|
|
gtk_widget_hide (proxy);
|
|
}
|
|
|
|
void
|
|
_gtk_action_emit_activate (GtkAction *action)
|
|
{
|
|
GtkActionGroup *group = action->private_data->action_group;
|
|
|
|
if (group != NULL)
|
|
{
|
|
g_object_ref (group);
|
|
_gtk_action_group_emit_pre_activate (group, action);
|
|
}
|
|
|
|
g_signal_emit (action, action_signals[ACTIVATE], 0);
|
|
|
|
if (group != NULL)
|
|
{
|
|
_gtk_action_group_emit_post_activate (group, action);
|
|
g_object_unref (group);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gtk_action_activate:
|
|
* @action: the action object
|
|
*
|
|
* Emits the "activate" signal on the specified action, if it isn't
|
|
* insensitive. This gets called by the proxy widgets when they get
|
|
* activated.
|
|
*
|
|
* It can also be used to manually activate an action.
|
|
*
|
|
* Since: 2.4
|
|
*/
|
|
void
|
|
gtk_action_activate (GtkAction *action)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
if (action->private_data->activate_blocked == FALSE &&
|
|
gtk_action_is_sensitive (action))
|
|
_gtk_action_emit_activate (action);
|
|
}
|
|
|
|
/**
|
|
* gtk_action_block_activate:
|
|
*
|
|
* Disable activation signals from the action
|
|
*
|
|
* This is needed when updating the state of your proxy
|
|
* #GtkActivatable widget could result in calling gtk_action_activate(),
|
|
* this is a convenience function to avoid recursing in those
|
|
* cases (updating toggle state for instance).
|
|
*/
|
|
void
|
|
gtk_action_block_activate (GtkAction *action)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
action->private_data->activate_blocked = TRUE;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_unblock_activate:
|
|
*
|
|
* Reenable activation signals from the action
|
|
*/
|
|
void
|
|
gtk_action_unblock_activate (GtkAction *action)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
action->private_data->activate_blocked = FALSE;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_create_icon:
|
|
* @action: the action object
|
|
* @icon_size: the size of the icon that should be created.
|
|
*
|
|
* This function is intended for use by action implementations to
|
|
* create icons displayed in the proxy widgets.
|
|
*
|
|
* Returns: a widget that displays the icon for this action.
|
|
*
|
|
* Since: 2.4
|
|
*/
|
|
GtkWidget *
|
|
gtk_action_create_icon (GtkAction *action, GtkIconSize icon_size)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), NULL);
|
|
|
|
if (action->private_data->stock_id &&
|
|
gtk_icon_factory_lookup_default (action->private_data->stock_id))
|
|
return gtk_image_new_from_stock (action->private_data->stock_id, icon_size);
|
|
else if (action->private_data->gicon)
|
|
return gtk_image_new_from_gicon (action->private_data->gicon, icon_size);
|
|
else if (action->private_data->icon_name)
|
|
return gtk_image_new_from_icon_name (action->private_data->icon_name, icon_size);
|
|
else
|
|
return NULL;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_create_menu_item:
|
|
* @action: the action object
|
|
*
|
|
* Creates a menu item widget that proxies for the given action.
|
|
*
|
|
* Returns: a menu item connected to the action.
|
|
*
|
|
* Since: 2.4
|
|
*/
|
|
GtkWidget *
|
|
gtk_action_create_menu_item (GtkAction *action)
|
|
{
|
|
GtkWidget *menu_item;
|
|
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), NULL);
|
|
|
|
menu_item = GTK_ACTION_GET_CLASS (action)->create_menu_item (action);
|
|
|
|
gtk_activatable_set_use_action_appearance (GTK_ACTIVATABLE (menu_item), TRUE);
|
|
gtk_activatable_set_related_action (GTK_ACTIVATABLE (menu_item), action);
|
|
|
|
return menu_item;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_create_tool_item:
|
|
* @action: the action object
|
|
*
|
|
* Creates a toolbar item widget that proxies for the given action.
|
|
*
|
|
* Returns: a toolbar item connected to the action.
|
|
*
|
|
* Since: 2.4
|
|
*/
|
|
GtkWidget *
|
|
gtk_action_create_tool_item (GtkAction *action)
|
|
{
|
|
GtkWidget *button;
|
|
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), NULL);
|
|
|
|
button = GTK_ACTION_GET_CLASS (action)->create_tool_item (action);
|
|
|
|
gtk_activatable_set_use_action_appearance (GTK_ACTIVATABLE (button), TRUE);
|
|
gtk_activatable_set_related_action (GTK_ACTIVATABLE (button), action);
|
|
|
|
return button;
|
|
}
|
|
|
|
void
|
|
_gtk_action_add_to_proxy_list (GtkAction *action,
|
|
GtkWidget *proxy)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
g_return_if_fail (GTK_IS_WIDGET (proxy));
|
|
|
|
GTK_ACTION_GET_CLASS (action)->connect_proxy (action, proxy);
|
|
}
|
|
|
|
void
|
|
_gtk_action_remove_from_proxy_list (GtkAction *action,
|
|
GtkWidget *proxy)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
g_return_if_fail (GTK_IS_WIDGET (proxy));
|
|
|
|
GTK_ACTION_GET_CLASS (action)->disconnect_proxy (action, proxy);
|
|
}
|
|
|
|
/**
|
|
* gtk_action_connect_proxy:
|
|
* @action: the action object
|
|
* @proxy: the proxy widget
|
|
*
|
|
* Connects a widget to an action object as a proxy. Synchronises
|
|
* various properties of the action with the widget (such as label
|
|
* text, icon, tooltip, etc), and attaches a callback so that the
|
|
* action gets activated when the proxy widget does.
|
|
*
|
|
* If the widget is already connected to an action, it is disconnected
|
|
* first.
|
|
*
|
|
* Since: 2.4
|
|
*
|
|
* Deprecated 2.16: Use gtk_activatable_set_related_action() instead.
|
|
*/
|
|
void
|
|
gtk_action_connect_proxy (GtkAction *action,
|
|
GtkWidget *proxy)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
g_return_if_fail (GTK_IS_WIDGET (proxy));
|
|
g_return_if_fail (GTK_IS_ACTIVATABLE (proxy));
|
|
|
|
gtk_activatable_set_use_action_appearance (GTK_ACTIVATABLE (proxy), TRUE);
|
|
|
|
gtk_activatable_set_related_action (GTK_ACTIVATABLE (proxy), action);
|
|
}
|
|
|
|
/**
|
|
* gtk_action_disconnect_proxy:
|
|
* @action: the action object
|
|
* @proxy: the proxy widget
|
|
*
|
|
* Disconnects a proxy widget from an action.
|
|
* Does <emphasis>not</emphasis> destroy the widget, however.
|
|
*
|
|
* Since: 2.4
|
|
*
|
|
* Deprecated 2.16: Use gtk_activatable_set_related_action() instead.
|
|
*/
|
|
void
|
|
gtk_action_disconnect_proxy (GtkAction *action,
|
|
GtkWidget *proxy)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
g_return_if_fail (GTK_IS_WIDGET (proxy));
|
|
|
|
gtk_activatable_set_related_action (GTK_ACTIVATABLE (proxy), NULL);
|
|
}
|
|
|
|
/**
|
|
* gtk_action_get_proxies:
|
|
* @action: the action object
|
|
*
|
|
* Returns the proxy widgets for an action.
|
|
* See also gtk_widget_get_action().
|
|
*
|
|
* Return value: a #GSList of proxy widgets. The list is owned by GTK+
|
|
* and must not be modified.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
GSList*
|
|
gtk_action_get_proxies (GtkAction *action)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), NULL);
|
|
|
|
return action->private_data->proxies;
|
|
}
|
|
|
|
|
|
/**
|
|
* gtk_widget_get_action:
|
|
* @widget: a #GtkWidget
|
|
*
|
|
* Returns the #GtkAction that @widget is a proxy for.
|
|
* See also gtk_action_get_proxies().
|
|
*
|
|
* Returns: the action that a widget is a proxy for, or
|
|
* %NULL, if it is not attached to an action.
|
|
*
|
|
* Since: 2.10
|
|
*
|
|
* Deprecated 2.16: Use gtk_activatable_get_related_action() instead.
|
|
*/
|
|
GtkAction*
|
|
gtk_widget_get_action (GtkWidget *widget)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_WIDGET (widget), NULL);
|
|
|
|
if (GTK_IS_ACTIVATABLE (widget))
|
|
return gtk_activatable_get_related_action (GTK_ACTIVATABLE (widget));
|
|
|
|
return NULL;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_get_name:
|
|
* @action: the action object
|
|
*
|
|
* Returns the name of the action.
|
|
*
|
|
* Return value: the name of the action. The string belongs to GTK+ and should not
|
|
* be freed.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
G_CONST_RETURN gchar *
|
|
gtk_action_get_name (GtkAction *action)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), NULL);
|
|
|
|
return action->private_data->name;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_is_sensitive:
|
|
* @action: the action object
|
|
*
|
|
* Returns whether the action is effectively sensitive.
|
|
*
|
|
* Return value: %TRUE if the action and its associated action group
|
|
* are both sensitive.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gtk_action_is_sensitive (GtkAction *action)
|
|
{
|
|
GtkActionPrivate *priv;
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), FALSE);
|
|
|
|
priv = action->private_data;
|
|
return priv->sensitive &&
|
|
(priv->action_group == NULL ||
|
|
gtk_action_group_get_sensitive (priv->action_group));
|
|
}
|
|
|
|
/**
|
|
* gtk_action_get_sensitive:
|
|
* @action: the action object
|
|
*
|
|
* Returns whether the action itself is sensitive. Note that this doesn't
|
|
* necessarily mean effective sensitivity. See gtk_action_is_sensitive()
|
|
* for that.
|
|
*
|
|
* Return value: %TRUE if the action itself is sensitive.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gtk_action_get_sensitive (GtkAction *action)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), FALSE);
|
|
|
|
return action->private_data->sensitive;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_set_sensitive:
|
|
* @action: the action object
|
|
* @sensitive: %TRUE to make the action sensitive
|
|
*
|
|
* Sets the ::sensitive property of the action to @sensitive. Note that
|
|
* this doesn't necessarily mean effective sensitivity. See
|
|
* gtk_action_is_sensitive()
|
|
* for that.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
void
|
|
gtk_action_set_sensitive (GtkAction *action,
|
|
gboolean sensitive)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
sensitive = sensitive != FALSE;
|
|
|
|
if (action->private_data->sensitive != sensitive)
|
|
{
|
|
action->private_data->sensitive = sensitive;
|
|
|
|
g_object_notify (G_OBJECT (action), "sensitive");
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gtk_action_is_visible:
|
|
* @action: the action object
|
|
*
|
|
* Returns whether the action is effectively visible.
|
|
*
|
|
* Return value: %TRUE if the action and its associated action group
|
|
* are both visible.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gtk_action_is_visible (GtkAction *action)
|
|
{
|
|
GtkActionPrivate *priv;
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), FALSE);
|
|
|
|
priv = action->private_data;
|
|
return priv->visible &&
|
|
(priv->action_group == NULL ||
|
|
gtk_action_group_get_visible (priv->action_group));
|
|
}
|
|
|
|
/**
|
|
* gtk_action_get_visible:
|
|
* @action: the action object
|
|
*
|
|
* Returns whether the action itself is visible. Note that this doesn't
|
|
* necessarily mean effective visibility. See gtk_action_is_sensitive()
|
|
* for that.
|
|
*
|
|
* Return value: %TRUE if the action itself is visible.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
gboolean
|
|
gtk_action_get_visible (GtkAction *action)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), FALSE);
|
|
|
|
return action->private_data->visible;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_set_visible:
|
|
* @action: the action object
|
|
* @visible: %TRUE to make the action visible
|
|
*
|
|
* Sets the ::visible property of the action to @visible. Note that
|
|
* this doesn't necessarily mean effective visibility. See
|
|
* gtk_action_is_visible()
|
|
* for that.
|
|
*
|
|
* Since: 2.6
|
|
**/
|
|
void
|
|
gtk_action_set_visible (GtkAction *action,
|
|
gboolean visible)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
visible = visible != FALSE;
|
|
|
|
if (action->private_data->visible != visible)
|
|
{
|
|
action->private_data->visible = visible;
|
|
|
|
g_object_notify (G_OBJECT (action), "visible");
|
|
}
|
|
}
|
|
/**
|
|
* gtk_action_set_is_important:
|
|
* @action: the action object
|
|
* @is_important: %TRUE to make the action important
|
|
*
|
|
* Sets whether the action is important, this attribute is used
|
|
* primarily by toolbar items to decide whether to show a label
|
|
* or not.
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
void
|
|
gtk_action_set_is_important (GtkAction *action,
|
|
gboolean is_important)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
is_important = is_important != FALSE;
|
|
|
|
if (action->private_data->is_important != is_important)
|
|
{
|
|
action->private_data->is_important = is_important;
|
|
|
|
g_object_notify (G_OBJECT (action), "is-important");
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gtk_action_get_is_important:
|
|
* @action: a #GtkAction
|
|
*
|
|
* Checks whether @action is important or not
|
|
*
|
|
* Returns: whether @action is important
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
gboolean
|
|
gtk_action_get_is_important (GtkAction *action)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), FALSE);
|
|
|
|
return action->private_data->is_important;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_set_label:
|
|
* @action: a #GtkAction
|
|
* @label: the label text to set
|
|
*
|
|
* Sets the label of @action.
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
void
|
|
gtk_action_set_label (GtkAction *action,
|
|
const gchar *label)
|
|
{
|
|
gchar *tmp;
|
|
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
tmp = action->private_data->label;
|
|
action->private_data->label = g_strdup (label);
|
|
g_free (tmp);
|
|
action->private_data->label_set = (action->private_data->label != NULL);
|
|
/* if label is unset, then use the label from the stock item */
|
|
if (!action->private_data->label_set && action->private_data->stock_id)
|
|
{
|
|
GtkStockItem stock_item;
|
|
|
|
if (gtk_stock_lookup (action->private_data->stock_id, &stock_item))
|
|
action->private_data->label = g_strdup (stock_item.label);
|
|
}
|
|
|
|
g_object_notify (G_OBJECT (action), "label");
|
|
|
|
/* if short_label is unset, set short_label=label */
|
|
if (!action->private_data->short_label_set)
|
|
{
|
|
gtk_action_set_short_label (action, action->private_data->label);
|
|
action->private_data->short_label_set = FALSE;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gtk_action_get_label:
|
|
* @action: a #GtkAction
|
|
*
|
|
* Gets the label text of @action.
|
|
*
|
|
* Returns: the label text
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
G_CONST_RETURN gchar *
|
|
gtk_action_get_label (GtkAction *action)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), NULL);
|
|
|
|
return action->private_data->label;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_set_short_label:
|
|
* @action: a #GtkAction
|
|
* @label: the label text to set
|
|
*
|
|
* Sets a shorter label text on @action.
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
void
|
|
gtk_action_set_short_label (GtkAction *action,
|
|
const gchar *label)
|
|
{
|
|
gchar *tmp;
|
|
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
tmp = action->private_data->short_label;
|
|
action->private_data->short_label = g_strdup (label);
|
|
g_free (tmp);
|
|
action->private_data->short_label_set = (action->private_data->short_label != NULL);
|
|
/* if short_label is unset, then use the value of label */
|
|
if (!action->private_data->short_label_set)
|
|
action->private_data->short_label = g_strdup (action->private_data->label);
|
|
|
|
g_object_notify (G_OBJECT (action), "short-label");
|
|
}
|
|
|
|
/**
|
|
* gtk_action_get_short_label:
|
|
* @action: a #GtkAction
|
|
* @label: the label text to set
|
|
*
|
|
* Gets the short label text of @action.
|
|
*
|
|
* Returns: the short label text.
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
G_CONST_RETURN gchar *
|
|
gtk_action_get_short_label (GtkAction *action)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), NULL);
|
|
|
|
return action->private_data->short_label;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_set_visible_horizontal:
|
|
* @action: a #GtkAction
|
|
* @visible_horizontal: whether the action is visible horizontally
|
|
*
|
|
* Sets whether @action is visible when horizontal
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
void
|
|
gtk_action_set_visible_horizontal (GtkAction *action,
|
|
gboolean visible_horizontal)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
visible_horizontal = visible_horizontal != FALSE;
|
|
|
|
if (action->private_data->visible_horizontal != visible_horizontal)
|
|
{
|
|
action->private_data->visible_horizontal = visible_horizontal;
|
|
|
|
g_object_notify (G_OBJECT (action), "visible-horizontal");
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gtk_action_get_visible_horizontal:
|
|
* @action: a #GtkAction
|
|
*
|
|
* Checks whether @action is visible when horizontal
|
|
*
|
|
* Returns: whether @action is visible when horizontal
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
gboolean
|
|
gtk_action_get_visible_horizontal (GtkAction *action)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), FALSE);
|
|
|
|
return action->private_data->visible_horizontal;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_set_visible_vertical:
|
|
* @action: a #GtkAction
|
|
* @visible_vertical: whether the action is visible vertically
|
|
*
|
|
* Sets whether @action is visible when vertical
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
void
|
|
gtk_action_set_visible_vertical (GtkAction *action,
|
|
gboolean visible_vertical)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
visible_vertical = visible_vertical != FALSE;
|
|
|
|
if (action->private_data->visible_vertical != visible_vertical)
|
|
{
|
|
action->private_data->visible_vertical = visible_vertical;
|
|
|
|
g_object_notify (G_OBJECT (action), "visible-vertical");
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gtk_action_get_visible_vertical:
|
|
* @action: a #GtkAction
|
|
*
|
|
* Checks whether @action is visible when horizontal
|
|
*
|
|
* Returns: whether @action is visible when horizontal
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
gboolean
|
|
gtk_action_get_visible_vertical (GtkAction *action)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), FALSE);
|
|
|
|
return action->private_data->visible_vertical;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_set_tooltip:
|
|
* @action: a #GtkAction
|
|
* @tooltip: the tooltip text
|
|
*
|
|
* Sets the tooltip text on @action
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
void
|
|
gtk_action_set_tooltip (GtkAction *action,
|
|
const gchar *tooltip)
|
|
{
|
|
gchar *tmp;
|
|
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
tmp = action->private_data->tooltip;
|
|
action->private_data->tooltip = g_strdup (tooltip);
|
|
g_free (tmp);
|
|
|
|
g_object_notify (G_OBJECT (action), "tooltip");
|
|
}
|
|
|
|
/**
|
|
* gtk_action_get_tooltip:
|
|
* @action: a #GtkAction
|
|
*
|
|
* Gets the tooltip text of @action.
|
|
*
|
|
* Returns: the tooltip text
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
G_CONST_RETURN gchar *
|
|
gtk_action_get_tooltip (GtkAction *action)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), NULL);
|
|
|
|
return action->private_data->tooltip;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_set_stock_id:
|
|
* @action: a #GtkAction
|
|
* @tooltip: the tooltip text
|
|
*
|
|
* Sets the stock id on @action
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
void
|
|
gtk_action_set_stock_id (GtkAction *action,
|
|
const gchar *stock_id)
|
|
{
|
|
gchar *tmp;
|
|
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
tmp = action->private_data->stock_id;
|
|
action->private_data->stock_id = g_strdup (stock_id);
|
|
g_free (tmp);
|
|
|
|
g_object_notify (G_OBJECT (action), "stock-id");
|
|
|
|
/* update label and short_label if appropriate */
|
|
if (!action->private_data->label_set)
|
|
{
|
|
GtkStockItem stock_item;
|
|
|
|
if (action->private_data->stock_id &&
|
|
gtk_stock_lookup (action->private_data->stock_id, &stock_item))
|
|
gtk_action_set_label (action, stock_item.label);
|
|
else
|
|
gtk_action_set_label (action, NULL);
|
|
|
|
action->private_data->label_set = FALSE;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* gtk_action_get_stock_id:
|
|
* @action: a #GtkAction
|
|
*
|
|
* Gets the stock id of @action.
|
|
*
|
|
* Returns: the stock id
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
G_CONST_RETURN gchar *
|
|
gtk_action_get_stock_id (GtkAction *action)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), NULL);
|
|
|
|
return action->private_data->stock_id;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_set_icon_name:
|
|
* @action: a #GtkAction
|
|
* @tooltip: the icon name to set
|
|
*
|
|
* Sets the icon name on @action
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
void
|
|
gtk_action_set_icon_name (GtkAction *action,
|
|
const gchar *icon_name)
|
|
{
|
|
gchar *tmp;
|
|
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
tmp = action->private_data->icon_name;
|
|
action->private_data->icon_name = g_strdup (icon_name);
|
|
g_free (tmp);
|
|
|
|
g_object_notify (G_OBJECT (action), "icon-name");
|
|
}
|
|
|
|
/**
|
|
* gtk_action_get_icon_name:
|
|
* @action: a #GtkAction
|
|
*
|
|
* Gets the icon name of @action.
|
|
*
|
|
* Returns: the icon name
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
G_CONST_RETURN gchar *
|
|
gtk_action_get_icon_name (GtkAction *action)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), NULL);
|
|
|
|
return action->private_data->icon_name;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_set_gicon:
|
|
* @action: a #GtkAction
|
|
* @icon: the #GIcon to set
|
|
*
|
|
* Sets the icon of @action.
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
void
|
|
gtk_action_set_gicon (GtkAction *action,
|
|
GIcon *icon)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
if (action->private_data->gicon)
|
|
g_object_unref (action->private_data->gicon);
|
|
|
|
action->private_data->gicon = icon;
|
|
|
|
if (action->private_data->gicon)
|
|
g_object_ref (action->private_data->gicon);
|
|
|
|
g_object_notify (G_OBJECT (action), "gicon");
|
|
}
|
|
|
|
/**
|
|
* gtk_action_get_gicon:
|
|
* @action: a #GtkAction
|
|
*
|
|
* Gets the gicon of @action.
|
|
*
|
|
* Returns: The action's #GIcon if one is set.
|
|
*
|
|
* Since: 2.16
|
|
*/
|
|
GIcon *
|
|
gtk_action_get_gicon (GtkAction *action)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), NULL);
|
|
|
|
return action->private_data->gicon;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_block_activate_from:
|
|
* @action: the action object
|
|
* @proxy: a proxy widget
|
|
*
|
|
* Disables calls to the gtk_action_activate()
|
|
* function by signals on the given proxy widget. This is used to
|
|
* break notification loops for things like check or radio actions.
|
|
*
|
|
* This function is intended for use by action implementations.
|
|
*
|
|
* Since: 2.4
|
|
*
|
|
* Deprecated 2.16: activatables are now responsible for activating the
|
|
* action directly so this doesnt apply anymore.
|
|
*/
|
|
void
|
|
gtk_action_block_activate_from (GtkAction *action,
|
|
GtkWidget *proxy)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
g_signal_handlers_block_by_func (proxy, G_CALLBACK (gtk_action_activate),
|
|
action);
|
|
}
|
|
|
|
/**
|
|
* gtk_action_unblock_activate_from:
|
|
* @action: the action object
|
|
* @proxy: a proxy widget
|
|
*
|
|
* Re-enables calls to the gtk_action_activate()
|
|
* function by signals on the given proxy widget. This undoes the
|
|
* blocking done by gtk_action_block_activate_from().
|
|
*
|
|
* This function is intended for use by action implementations.
|
|
*
|
|
* Since: 2.4
|
|
*
|
|
* Deprecated 2.16: activatables are now responsible for activating the
|
|
* action directly so this doesnt apply anymore.
|
|
*/
|
|
void
|
|
gtk_action_unblock_activate_from (GtkAction *action,
|
|
GtkWidget *proxy)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
g_signal_handlers_unblock_by_func (proxy, G_CALLBACK (gtk_action_activate),
|
|
action);
|
|
}
|
|
|
|
static void
|
|
closure_accel_activate (GClosure *closure,
|
|
GValue *return_value,
|
|
guint n_param_values,
|
|
const GValue *param_values,
|
|
gpointer invocation_hint,
|
|
gpointer marshal_data)
|
|
{
|
|
if (gtk_action_is_sensitive (GTK_ACTION (closure->data)))
|
|
{
|
|
_gtk_action_emit_activate (GTK_ACTION (closure->data));
|
|
|
|
/* we handled the accelerator */
|
|
g_value_set_boolean (return_value, TRUE);
|
|
}
|
|
}
|
|
|
|
static void
|
|
gtk_action_set_action_group (GtkAction *action,
|
|
GtkActionGroup *action_group)
|
|
{
|
|
if (action->private_data->action_group == NULL)
|
|
g_return_if_fail (GTK_IS_ACTION_GROUP (action_group));
|
|
else
|
|
g_return_if_fail (action_group == NULL);
|
|
|
|
action->private_data->action_group = action_group;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_set_accel_path:
|
|
* @action: the action object
|
|
* @accel_path: the accelerator path
|
|
*
|
|
* Sets the accel path for this action. All proxy widgets associated
|
|
* with the action will have this accel path, so that their
|
|
* accelerators are consistent.
|
|
*
|
|
* Note that @accel_path string will be stored in a #GQuark. Therefore, if you
|
|
* pass a static string, you can save some memory by interning it first with
|
|
* g_intern_static_string().
|
|
*
|
|
* Since: 2.4
|
|
*/
|
|
void
|
|
gtk_action_set_accel_path (GtkAction *action,
|
|
const gchar *accel_path)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
action->private_data->accel_quark = g_quark_from_string (accel_path);
|
|
}
|
|
|
|
/**
|
|
* gtk_action_get_accel_path:
|
|
* @action: the action object
|
|
*
|
|
* Returns the accel path for this action.
|
|
*
|
|
* Since: 2.6
|
|
*
|
|
* Returns: the accel path for this action, or %NULL
|
|
* if none is set. The returned string is owned by GTK+
|
|
* and must not be freed or modified.
|
|
*/
|
|
G_CONST_RETURN gchar *
|
|
gtk_action_get_accel_path (GtkAction *action)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), NULL);
|
|
|
|
if (action->private_data->accel_quark)
|
|
return g_quark_to_string (action->private_data->accel_quark);
|
|
else
|
|
return NULL;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_get_accel_closure:
|
|
* @action: the action object
|
|
*
|
|
* Returns the accel closure for this action.
|
|
*
|
|
* Since: 2.8
|
|
*
|
|
* Returns: the accel closure for this action. The returned closure is
|
|
* owned by GTK+ and must not be unreffed or modified.
|
|
*/
|
|
GClosure *
|
|
gtk_action_get_accel_closure (GtkAction *action)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), NULL);
|
|
|
|
return action->private_data->accel_closure;
|
|
}
|
|
|
|
|
|
/**
|
|
* gtk_action_set_accel_group:
|
|
* @action: the action object
|
|
* @accel_group: a #GtkAccelGroup or %NULL
|
|
*
|
|
* Sets the #GtkAccelGroup in which the accelerator for this action
|
|
* will be installed.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
void
|
|
gtk_action_set_accel_group (GtkAction *action,
|
|
GtkAccelGroup *accel_group)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
g_return_if_fail (accel_group == NULL || GTK_IS_ACCEL_GROUP (accel_group));
|
|
|
|
if (accel_group)
|
|
g_object_ref (accel_group);
|
|
if (action->private_data->accel_group)
|
|
g_object_unref (action->private_data->accel_group);
|
|
|
|
action->private_data->accel_group = accel_group;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_connect_accelerator:
|
|
* @action: a #GtkAction
|
|
*
|
|
* Installs the accelerator for @action if @action has an
|
|
* accel path and group. See gtk_action_set_accel_path() and
|
|
* gtk_action_set_accel_group()
|
|
*
|
|
* Since multiple proxies may independently trigger the installation
|
|
* of the accelerator, the @action counts the number of times this
|
|
* function has been called and doesn't remove the accelerator until
|
|
* gtk_action_disconnect_accelerator() has been called as many times.
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
void
|
|
gtk_action_connect_accelerator (GtkAction *action)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
if (!action->private_data->accel_quark ||
|
|
!action->private_data->accel_group)
|
|
return;
|
|
|
|
if (action->private_data->accel_count == 0)
|
|
{
|
|
const gchar *accel_path =
|
|
g_quark_to_string (action->private_data->accel_quark);
|
|
|
|
gtk_accel_group_connect_by_path (action->private_data->accel_group,
|
|
accel_path,
|
|
action->private_data->accel_closure);
|
|
}
|
|
|
|
action->private_data->accel_count++;
|
|
}
|
|
|
|
/**
|
|
* gtk_action_disconnect_accelerator:
|
|
* @action: a #GtkAction
|
|
*
|
|
* Undoes the effect of one call to gtk_action_connect_accelerator().
|
|
*
|
|
* Since: 2.4
|
|
**/
|
|
void
|
|
gtk_action_disconnect_accelerator (GtkAction *action)
|
|
{
|
|
g_return_if_fail (GTK_IS_ACTION (action));
|
|
|
|
if (!action->private_data->accel_quark ||
|
|
!action->private_data->accel_group)
|
|
return;
|
|
|
|
action->private_data->accel_count--;
|
|
|
|
if (action->private_data->accel_count == 0)
|
|
gtk_accel_group_disconnect (action->private_data->accel_group,
|
|
action->private_data->accel_closure);
|
|
}
|
|
|
|
/**
|
|
* gtk_action_create_menu:
|
|
* @action: a #GtkAction
|
|
*
|
|
* If @action provides a #GtkMenu widget as a submenu for the menu
|
|
* item or the toolbar item it creates, this function returns an
|
|
* instance of that menu.
|
|
*
|
|
* Return value: the menu item provided by the action, or %NULL.
|
|
*
|
|
* Since: 2.12
|
|
*/
|
|
GtkWidget *
|
|
gtk_action_create_menu (GtkAction *action)
|
|
{
|
|
g_return_val_if_fail (GTK_IS_ACTION (action), NULL);
|
|
|
|
if (GTK_ACTION_GET_CLASS (action)->create_menu)
|
|
return GTK_ACTION_GET_CLASS (action)->create_menu (action);
|
|
|
|
return NULL;
|
|
}
|
|
|
|
#define __GTK_ACTION_C__
|
|
#include "gtkaliasdef.c"
|