X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=gtk%2Fgtkmenutoolbutton.c;h=c133f88a7b5bc10e63dfa8fe5a754719516b3b5a;hb=d484721b5ca9e82d6422cca8a3a40f001208f87b;hp=d44f8bc50dbfc54eab068ea0cde83efe6fb49736;hpb=94eec042676a8e18cebc9af8f27cd251355f4ba4;p=~andy%2Fgtk diff --git a/gtk/gtkmenutoolbutton.c b/gtk/gtkmenutoolbutton.c index d44f8bc50..c133f88a7 100644 --- a/gtk/gtkmenutoolbutton.c +++ b/gtk/gtkmenutoolbutton.c @@ -14,41 +14,75 @@ * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public - * License along with this library; if not, write to the - * Free Software Foundation, Inc., 59 Temple Place - Suite 330, - * Boston, MA 02111-1307, USA. + * License along with this library. If not, see . */ -#include +#include "config.h" + #include "gtkmenutoolbutton.h" -#include "gtkintl.h" + #include "gtktogglebutton.h" #include "gtkarrow.h" -#include "gtkhbox.h" -#include "gtkvbox.h" +#include "gtkmenubutton.h" +#include "gtkmenubuttonprivate.h" +#include "gtkbox.h" #include "gtkmenu.h" #include "gtkmain.h" +#include "gtksizerequest.h" +#include "gtkbuildable.h" + #include "gtkprivate.h" -#include "gtkalias.h" +#include "gtkintl.h" + +/** + * SECTION:gtkmenutoolbutton + * @Short_description: A GtkToolItem containing a button with an additional dropdown menu + * @Title: GtkMenuToolButton + * @See_also: #GtkToolbar, #GtkToolButton + * + * A #GtkMenuToolButton is a #GtkToolItem that contains a button and + * a small additional button with an arrow. When clicked, the arrow + * button pops up a dropdown menu. + * + * Use gtk_menu_tool_button_new() to create a new + * #GtkMenuToolButton. Use gtk_menu_tool_button_new_from_stock() to + * create a new #GtkMenuToolButton containing a stock item. + * + * + * GtkMenuToolButton as GtkBuildable + * + * The GtkMenuToolButton implementation of the GtkBuildable interface + * supports adding a menu by specifying "menu" as the "type" + * attribute of a <child> element. + * + * + * A UI definition fragment with menus + * + * + * + * + * + * ]]> + * + * + * + */ -#define GTK_MENU_TOOL_BUTTON_GET_PRIVATE(object)(G_TYPE_INSTANCE_GET_PRIVATE ((object), GTK_TYPE_MENU_TOOL_BUTTON, GtkMenuToolButtonPrivate)) struct _GtkMenuToolButtonPrivate { GtkWidget *button; - GtkWidget *arrow; GtkWidget *arrow_button; GtkWidget *box; - GtkMenu *menu; }; -static void gtk_menu_tool_button_init (GtkMenuToolButton *button); -static void gtk_menu_tool_button_class_init (GtkMenuToolButtonClass *klass); -static void gtk_menu_tool_button_destroy (GtkObject *object); - -static int menu_deactivate_cb (GtkMenuShell *menu_shell, - GtkMenuToolButton *button); +static void gtk_menu_tool_button_buildable_interface_init (GtkBuildableIface *iface); +static void gtk_menu_tool_button_buildable_add_child (GtkBuildable *buildable, + GtkBuilder *builder, + GObject *child, + const gchar *type); enum { @@ -59,91 +93,58 @@ enum enum { PROP_0, - PROP_MENU, - LAST_PROP + PROP_MENU }; static gint signals[LAST_SIGNAL]; -static GObjectClass *parent_class = NULL; - -GType -gtk_menu_tool_button_get_type (void) -{ - static GType type = 0; - - if (type == 0) - { - static const GTypeInfo info = - { - sizeof (GtkMenuToolButtonClass), - (GBaseInitFunc) 0, - (GBaseFinalizeFunc) 0, - (GClassInitFunc) gtk_menu_tool_button_class_init, - (GClassFinalizeFunc) 0, - NULL, - sizeof (GtkMenuToolButton), - 0, /* n_preallocs */ - (GInstanceInitFunc) gtk_menu_tool_button_init - }; - - type = g_type_register_static (GTK_TYPE_TOOL_BUTTON, - I_("GtkMenuToolButton"), - &info, 0); - } - - return type; -} - -static gboolean -gtk_menu_tool_button_set_tooltip (GtkToolItem *tool_item, - GtkTooltips *tooltips, - const char *tip_text, - const char *tip_private) -{ - GtkMenuToolButton *button; - - g_return_val_if_fail (GTK_IS_MENU_TOOL_BUTTON (tool_item), FALSE); +static GtkBuildableIface *parent_buildable_iface; - button = GTK_MENU_TOOL_BUTTON (tool_item); - gtk_tooltips_set_tip (tooltips, button->priv->button, tip_text, tip_private); - - return TRUE; -} +G_DEFINE_TYPE_WITH_CODE (GtkMenuToolButton, gtk_menu_tool_button, GTK_TYPE_TOOL_BUTTON, + G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE, + gtk_menu_tool_button_buildable_interface_init)) static void gtk_menu_tool_button_construct_contents (GtkMenuToolButton *button) { GtkMenuToolButtonPrivate *priv = button->priv; GtkWidget *box; + GtkWidget *parent; GtkOrientation orientation; orientation = gtk_tool_item_get_orientation (GTK_TOOL_ITEM (button)); if (orientation == GTK_ORIENTATION_HORIZONTAL) { - box = gtk_hbox_new (FALSE, 0); - gtk_arrow_set (GTK_ARROW (priv->arrow), GTK_ARROW_DOWN, GTK_SHADOW_NONE); + box = gtk_box_new (GTK_ORIENTATION_HORIZONTAL, 0); + gtk_menu_button_set_direction (GTK_MENU_BUTTON (priv->arrow_button), GTK_ARROW_DOWN); } else { - box = gtk_vbox_new (FALSE, 0); - gtk_arrow_set (GTK_ARROW (priv->arrow), GTK_ARROW_RIGHT, GTK_SHADOW_NONE); + GtkTextDirection direction; + GtkArrowType type; + + box = gtk_box_new (GTK_ORIENTATION_VERTICAL, 0); + direction = gtk_widget_get_direction (GTK_WIDGET (button)); + type = (direction == GTK_TEXT_DIR_LTR ? GTK_ARROW_RIGHT : GTK_ARROW_LEFT); + gtk_menu_button_set_direction (GTK_MENU_BUTTON (priv->arrow_button), type); } - if (priv->button && priv->button->parent) + parent = gtk_widget_get_parent (priv->button); + if (priv->button && parent) { g_object_ref (priv->button); - gtk_container_remove (GTK_CONTAINER (priv->button->parent), + gtk_container_remove (GTK_CONTAINER (parent), priv->button); gtk_container_add (GTK_CONTAINER (box), priv->button); g_object_unref (priv->button); } - if (priv->arrow_button && priv->arrow_button->parent) + parent = gtk_widget_get_parent (priv->arrow_button); + if (priv->arrow_button && parent) { g_object_ref (priv->arrow_button); - gtk_container_remove (GTK_CONTAINER (priv->arrow_button->parent), + gtk_container_remove (GTK_CONTAINER (parent), priv->arrow_button); gtk_box_pack_end (GTK_BOX (box), priv->arrow_button, FALSE, FALSE, 0); @@ -152,6 +153,17 @@ gtk_menu_tool_button_construct_contents (GtkMenuToolButton *button) if (priv->box) { + gchar *tmp; + + /* Transfer a possible tooltip to the new box */ + g_object_get (priv->box, "tooltip-markup", &tmp, NULL); + + if (tmp) + { + g_object_set (box, "tooltip-markup", tmp, NULL); + g_free (tmp); + } + /* Note: we are not destroying the button and the arrow_button * here because they were removed from their container above */ @@ -175,20 +187,7 @@ gtk_menu_tool_button_toolbar_reconfigured (GtkToolItem *toolitem) gtk_menu_tool_button_construct_contents (GTK_MENU_TOOL_BUTTON (toolitem)); /* chain up */ - GTK_TOOL_ITEM_CLASS (parent_class)->toolbar_reconfigured (toolitem); -} - -static void -gtk_menu_tool_button_state_changed (GtkWidget *widget, - GtkStateType previous_state) -{ - GtkMenuToolButton *button = GTK_MENU_TOOL_BUTTON (widget); - GtkMenuToolButtonPrivate *priv = button->priv; - - if (!GTK_WIDGET_IS_SENSITIVE (widget) && priv->menu) - { - gtk_menu_shell_deactivate (GTK_MENU_SHELL (priv->menu)); - } + GTK_TOOL_ITEM_CLASS (gtk_menu_tool_button_parent_class)->toolbar_reconfigured (toolitem); } static void @@ -222,7 +221,7 @@ gtk_menu_tool_button_get_property (GObject *object, switch (prop_id) { case PROP_MENU: - g_value_set_object (value, button->priv->menu); + g_value_set_object (value, gtk_menu_button_get_popup (GTK_MENU_BUTTON (button->priv->arrow_button))); break; default: @@ -235,26 +234,29 @@ static void gtk_menu_tool_button_class_init (GtkMenuToolButtonClass *klass) { GObjectClass *object_class; - GtkObjectClass *gtk_object_class; - GtkWidgetClass *widget_class; GtkToolItemClass *toolitem_class; - GtkToolButtonClass *toolbutton_class; - - parent_class = g_type_class_peek_parent (klass); object_class = (GObjectClass *)klass; - gtk_object_class = (GtkObjectClass *)klass; - widget_class = (GtkWidgetClass *)klass; toolitem_class = (GtkToolItemClass *)klass; - toolbutton_class = (GtkToolButtonClass *)klass; object_class->set_property = gtk_menu_tool_button_set_property; object_class->get_property = gtk_menu_tool_button_get_property; - gtk_object_class->destroy = gtk_menu_tool_button_destroy; - widget_class->state_changed = gtk_menu_tool_button_state_changed; - toolitem_class->set_tooltip = gtk_menu_tool_button_set_tooltip; + toolitem_class->toolbar_reconfigured = gtk_menu_tool_button_toolbar_reconfigured; + /** + * GtkMenuToolButton::show-menu: + * @button: the object on which the signal is emitted + * + * The ::show-menu signal is emitted before the menu is shown. + * + * It can be used to populate the menu on demand, using + * gtk_menu_tool_button_set_menu(). + + * Note that even if you populate the menu dynamically in this way, + * you must set an empty menu on the #GtkMenuToolButton beforehand, + * since the arrow is made insensitive if the menu is not set. + */ signals[SHOW_MENU] = g_signal_new (I_("show-menu"), G_OBJECT_CLASS_TYPE (klass), @@ -275,150 +277,28 @@ gtk_menu_tool_button_class_init (GtkMenuToolButtonClass *klass) g_type_class_add_private (object_class, sizeof (GtkMenuToolButtonPrivate)); } -static void -menu_position_func (GtkMenu *menu, - int *x, - int *y, - gboolean *push_in, - GtkMenuToolButton *button) -{ - GtkMenuToolButtonPrivate *priv = button->priv; - GtkWidget *widget = GTK_WIDGET (button); - GtkRequisition req; - GtkRequisition menu_req; - GtkOrientation orientation; - GtkTextDirection direction; - GdkRectangle monitor; - gint monitor_num; - GdkScreen *screen; - - gtk_widget_size_request (GTK_WIDGET (priv->menu), &menu_req); - - orientation = gtk_tool_item_get_orientation (GTK_TOOL_ITEM (button)); - direction = gtk_widget_get_direction (widget); - - screen = gtk_widget_get_screen (GTK_WIDGET (menu)); - monitor_num = gdk_screen_get_monitor_at_window (screen, widget->window); - if (monitor_num < 0) - monitor_num = 0; - gdk_screen_get_monitor_geometry (screen, monitor_num, &monitor); - - if (orientation == GTK_ORIENTATION_HORIZONTAL) - { - gdk_window_get_origin (widget->window, x, y); - *x += widget->allocation.x; - *y += widget->allocation.y; - - if (direction == GTK_TEXT_DIR_LTR) - *x += MAX (widget->allocation.width - menu_req.width, 0); - else if (menu_req.width > widget->allocation.width) - *x -= menu_req.width - widget->allocation.width; - - if ((*y + priv->arrow_button->allocation.height + menu_req.height) <= monitor.y + monitor.height) - *y += priv->arrow_button->allocation.height; - else if ((*y - menu_req.height) >= monitor.y) - *y -= menu_req.height; - else if (monitor.y + monitor.height - (*y + priv->arrow_button->allocation.height) > *y) - *y += priv->arrow_button->allocation.height; - else - *y -= menu_req.height; - } - else - { - gdk_window_get_origin (GTK_BUTTON (priv->arrow_button)->event_window, x, y); - gtk_widget_size_request (priv->arrow_button, &req); - - if (direction == GTK_TEXT_DIR_LTR) - *x += priv->arrow_button->allocation.width; - else - *x -= menu_req.width; - - if (*y + menu_req.height > monitor.y + monitor.height && - *y + priv->arrow_button->allocation.height - monitor.y > monitor.y + monitor.height - *y) - *y += priv->arrow_button->allocation.height - menu_req.height; - } - - *push_in = FALSE; -} - -static void -popup_menu_under_arrow (GtkMenuToolButton *button, - GdkEventButton *event) -{ - GtkMenuToolButtonPrivate *priv = button->priv; - - g_signal_emit (button, signals[SHOW_MENU], 0); - - if (!priv->menu) - return; - - gtk_menu_popup (priv->menu, NULL, NULL, - (GtkMenuPositionFunc) menu_position_func, - button, - event ? event->button : 0, - event ? event->time : gtk_get_current_event_time ()); -} - -static void -arrow_button_toggled_cb (GtkToggleButton *togglebutton, - GtkMenuToolButton *button) -{ - GtkMenuToolButtonPrivate *priv = button->priv; - - if (!priv->menu) - return; - - if (gtk_toggle_button_get_active (togglebutton) && - !GTK_WIDGET_VISIBLE (priv->menu)) - { - /* we get here only when the menu is activated by a key - * press, so that we can select the first menu item */ - popup_menu_under_arrow (button, NULL); - gtk_menu_shell_select_first (GTK_MENU_SHELL (priv->menu), FALSE); - } -} - -static gboolean -arrow_button_button_press_event_cb (GtkWidget *widget, - GdkEventButton *event, - GtkMenuToolButton *button) -{ - if (event->button == 1) - { - popup_menu_under_arrow (button, event); - gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (widget), TRUE); - - return TRUE; - } - else - { - return FALSE; - } -} - static void gtk_menu_tool_button_init (GtkMenuToolButton *button) { GtkWidget *box; - GtkWidget *arrow; GtkWidget *arrow_button; GtkWidget *real_button; - button->priv = GTK_MENU_TOOL_BUTTON_GET_PRIVATE (button); + button->priv = G_TYPE_INSTANCE_GET_PRIVATE (button, + GTK_TYPE_MENU_TOOL_BUTTON, + GtkMenuToolButtonPrivate); gtk_tool_item_set_homogeneous (GTK_TOOL_ITEM (button), FALSE); - box = gtk_hbox_new (FALSE, 0); + box = gtk_box_new (GTK_ORIENTATION_HORIZONTAL, 0); - real_button = GTK_BIN (button)->child; + real_button = gtk_bin_get_child (GTK_BIN (button)); g_object_ref (real_button); gtk_container_remove (GTK_CONTAINER (button), real_button); gtk_container_add (GTK_CONTAINER (box), real_button); g_object_unref (real_button); - arrow_button = gtk_toggle_button_new (); - arrow = gtk_arrow_new (GTK_ARROW_DOWN, GTK_SHADOW_NONE); - gtk_container_add (GTK_CONTAINER (arrow_button), arrow); + arrow_button = gtk_menu_button_new (); gtk_box_pack_end (GTK_BOX (box), arrow_button, FALSE, FALSE, 0); @@ -428,49 +308,38 @@ gtk_menu_tool_button_init (GtkMenuToolButton *button) gtk_widget_show_all (box); gtk_container_add (GTK_CONTAINER (button), box); + gtk_menu_button_set_align_widget (GTK_MENU_BUTTON (arrow_button), + GTK_WIDGET (button)); button->priv->button = real_button; - button->priv->arrow = arrow; button->priv->arrow_button = arrow_button; button->priv->box = box; - - g_signal_connect (arrow_button, "toggled", - G_CALLBACK (arrow_button_toggled_cb), button); - g_signal_connect (arrow_button, "button_press_event", - G_CALLBACK (arrow_button_button_press_event_cb), button); } static void -gtk_menu_tool_button_destroy (GtkObject *object) +gtk_menu_tool_button_buildable_add_child (GtkBuildable *buildable, + GtkBuilder *builder, + GObject *child, + const gchar *type) { - GtkMenuToolButton *button; - - button = GTK_MENU_TOOL_BUTTON (object); + if (type && strcmp (type, "menu") == 0) + gtk_menu_tool_button_set_menu (GTK_MENU_TOOL_BUTTON (buildable), + GTK_WIDGET (child)); + else + parent_buildable_iface->add_child (buildable, builder, child, type); +} - if (button->priv->menu) - { - g_signal_handlers_disconnect_by_func (button->priv->menu, - menu_deactivate_cb, - button); - g_object_unref (button->priv->menu); - button->priv->menu = NULL; - - g_signal_handlers_disconnect_by_func (button->priv->arrow_button, - arrow_button_toggled_cb, - button); - g_signal_handlers_disconnect_by_func (button->priv->arrow_button, - arrow_button_button_press_event_cb, - button); - } - - if (GTK_OBJECT_CLASS (parent_class)->destroy) - (*GTK_OBJECT_CLASS (parent_class)->destroy) (object); +static void +gtk_menu_tool_button_buildable_interface_init (GtkBuildableIface *iface) +{ + parent_buildable_iface = g_type_interface_peek_parent (iface); + iface->add_child = gtk_menu_tool_button_buildable_add_child; } /** * gtk_menu_tool_button_new: - * @icon_widget: a widget that will be used as icon widget, or %NULL - * @label: a string that will be used as label, or %NULL + * @icon_widget: (allow-none): a widget that will be used as icon widget, or %NULL + * @label: (allow-none): a string that will be used as label, or %NULL * * Creates a new #GtkMenuToolButton using @icon_widget as icon and * @label as label. @@ -522,19 +391,11 @@ gtk_menu_tool_button_new_from_stock (const gchar *stock_id) return GTK_TOOL_ITEM (button); } -/* Callback for the "deactivate" signal on the pop-up menu. - * This is used so that we unset the state of the toggle button - * when the pop-up menu disappears. - */ -static int -menu_deactivate_cb (GtkMenuShell *menu_shell, - GtkMenuToolButton *button) +static void +_show_menu_emit (gpointer user_data) { - GtkMenuToolButtonPrivate *priv = button->priv; - - gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (priv->arrow_button), FALSE); - - return TRUE; + GtkMenuToolButton *button = (GtkMenuToolButton *) user_data; + g_signal_emit (button, signals[SHOW_MENU], 0); } /** @@ -558,34 +419,10 @@ gtk_menu_tool_button_set_menu (GtkMenuToolButton *button, priv = button->priv; - if (priv->menu != GTK_MENU (menu)) - { - if (priv->menu && GTK_WIDGET_VISIBLE (priv->menu)) - gtk_menu_shell_deactivate (GTK_MENU_SHELL (priv->menu)); - - if (priv->menu) - { - g_signal_handlers_disconnect_by_func (priv->menu, - menu_deactivate_cb, - button); - g_object_unref (priv->menu); - } - - priv->menu = GTK_MENU (menu); - - if (priv->menu) - { - g_object_ref (priv->menu); - gtk_object_sink (GTK_OBJECT (priv->menu)); - - gtk_widget_set_sensitive (priv->arrow_button, TRUE); - - g_signal_connect (button->priv->menu, "deactivate", - G_CALLBACK (menu_deactivate_cb), button); - } - else - gtk_widget_set_sensitive (priv->arrow_button, FALSE); - } + _gtk_menu_button_set_popup_with_func (GTK_MENU_BUTTON (priv->arrow_button), + menu, + _show_menu_emit, + button); g_object_notify (G_OBJECT (button), "menu"); } @@ -596,41 +433,61 @@ gtk_menu_tool_button_set_menu (GtkMenuToolButton *button, * * Gets the #GtkMenu associated with #GtkMenuToolButton. * - * Return value: the #GtkMenu associated with #GtkMenuToolButton + * Return value: (transfer none): the #GtkMenu associated + * with #GtkMenuToolButton * * Since: 2.6 **/ GtkWidget * gtk_menu_tool_button_get_menu (GtkMenuToolButton *button) { + GtkMenu *ret; + g_return_val_if_fail (GTK_IS_MENU_TOOL_BUTTON (button), NULL); - return GTK_WIDGET (button->priv->menu); + ret = gtk_menu_button_get_popup (GTK_MENU_BUTTON (button->priv->arrow_button)); + if (!ret) + return NULL; + + return GTK_WIDGET (ret); } /** - * gtk_menu_tool_button_set_arrow_tooltip: + * gtk_menu_tool_button_set_arrow_tooltip_text: * @button: a #GtkMenuToolButton - * @tooltips: the #GtkTooltips object to be used - * @tip_text: text to be used as tooltip text for tool_item - * @tip_private: text to be used as private tooltip text + * @text: text to be used as tooltip text for button's arrow button * - * Sets the #GtkTooltips object to be used for arrow button which - * pops up the menu. See gtk_tool_item_set_tooltip() for setting - * a tooltip on the whole #GtkMenuToolButton. + * Sets the tooltip text to be used as tooltip for the arrow button which + * pops up the menu. See gtk_tool_item_set_tooltip_text() for setting a tooltip + * on the whole #GtkMenuToolButton. * - * Since: 2.6 + * Since: 2.12 **/ void -gtk_menu_tool_button_set_arrow_tooltip (GtkMenuToolButton *button, - GtkTooltips *tooltips, - const gchar *tip_text, - const gchar *tip_private) +gtk_menu_tool_button_set_arrow_tooltip_text (GtkMenuToolButton *button, + const gchar *text) { g_return_if_fail (GTK_IS_MENU_TOOL_BUTTON (button)); - gtk_tooltips_set_tip (tooltips, button->priv->arrow_button, tip_text, tip_private); + gtk_widget_set_tooltip_text (button->priv->arrow_button, text); } -#define __GTK_MENU_TOOL_BUTTON_C__ -#include "gtkaliasdef.c" +/** + * gtk_menu_tool_button_set_arrow_tooltip_markup: + * @button: a #GtkMenuToolButton + * @markup: markup text to be used as tooltip text for button's arrow button + * + * Sets the tooltip markup text to be used as tooltip for the arrow button + * which pops up the menu. See gtk_tool_item_set_tooltip_text() for setting a + * tooltip on the whole #GtkMenuToolButton. + * + * Since: 2.12 + **/ +void +gtk_menu_tool_button_set_arrow_tooltip_markup (GtkMenuToolButton *button, + const gchar *markup) +{ + g_return_if_fail (GTK_IS_MENU_TOOL_BUTTON (button)); + + gtk_widget_set_tooltip_markup (button->priv->arrow_button, markup); +}