diff options
Diffstat (limited to 'libxfce4panel/xfce-panel-plugin-iface.c')
| -rw-r--r-- | libxfce4panel/xfce-panel-plugin-iface.c | 1471 |
1 files changed, 0 insertions, 1471 deletions
diff --git a/libxfce4panel/xfce-panel-plugin-iface.c b/libxfce4panel/xfce-panel-plugin-iface.c deleted file mode 100644 index 8ff7c058..00000000 --- a/libxfce4panel/xfce-panel-plugin-iface.c +++ /dev/null @@ -1,1471 +0,0 @@ -/* $Id$ - * - * Copyright (c) 2005-2007 Jasper Huijsmans <jasper@xfce.org> - * - * 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 this library; if not, write to the - * Free Software Foundation, Inc., 59 Temple Place - Suite 330, - * Boston, MA 02111-1307, USA. - */ - -#ifdef HAVE_CONFIG_H -#include <config.h> -#endif - -#include <string.h> -#include <gtk/gtk.h> - -#include <libxfce4panel/xfce-panel-macros.h> -#include <libxfce4panel/xfce-panel-convenience.h> -#include <libxfce4panel/xfce-panel-plugin-iface.h> -#include <libxfce4panel/xfce-panel-plugin-iface-private.h> -#include <libxfce4panel/libxfce4panel-enum-types.h> -#include <libxfce4panel/libxfce4panel-marshal.h> -#include <libxfce4panel/libxfce4panel-alias.h> - -enum -{ - SCREEN_POSITION_CHANGED, - ORIENTATION_CHANGED, - SIZE_CHANGED, - FREE_DATA, - SAVE, - ABOUT, - CONFIGURE, - LAST_SIGNAL -}; - -static guint xfce_panel_plugin_signals[LAST_SIGNAL] = { 0 }; - - - -static void -xfce_panel_plugin_base_init (gpointer klass) -{ - static gboolean initialized = FALSE; - - if (G_UNLIKELY (!initialized)) - { - /** - * XfcePanelPlugin::screen-position-changed - * @plugin : a #XfcePanelPlugin widget - * @position : new #XfceScreenPosition of the panel - * - * Emitted when the screen position changes. Most plugins will be - * more interested in the "orientation-changed" signal. - **/ - xfce_panel_plugin_signals [SCREEN_POSITION_CHANGED] = - g_signal_new (I_("screen-position-changed"), - G_TYPE_FROM_CLASS (klass), - G_SIGNAL_RUN_LAST | G_SIGNAL_NO_RECURSE | G_SIGNAL_NO_HOOKS, - 0, NULL, NULL, - g_cclosure_marshal_VOID__ENUM, - G_TYPE_NONE, - 1, XFCE_TYPE_SCREEN_POSITION); - - /** - * XfcePanelPlugin::orientation-changed - * @plugin : a #XfcePanelPlugin widget - * @orientation : new #GtkOrientation of the panel - * - * Emitted when the panel orientation changes. - **/ - xfce_panel_plugin_signals [ORIENTATION_CHANGED] = - g_signal_new (I_("orientation-changed"), - G_TYPE_FROM_CLASS (klass), - G_SIGNAL_RUN_LAST | G_SIGNAL_NO_RECURSE | G_SIGNAL_NO_HOOKS, - 0, NULL, NULL, - g_cclosure_marshal_VOID__ENUM, - G_TYPE_NONE, - 1, GTK_TYPE_ORIENTATION); - - /** - * XfcePanelPlugin::size-changed - * @plugin : a #XfcePanelPlugin widget - * @size : new panel size - * - * Emitted when the panel size changes. - * - * Returns: %TRUE when handled, %FALSE otherwise. - **/ - xfce_panel_plugin_signals [SIZE_CHANGED] = - g_signal_new (I_("size-changed"), - G_TYPE_FROM_CLASS (klass), - G_SIGNAL_RUN_LAST | G_SIGNAL_NO_RECURSE | G_SIGNAL_NO_HOOKS, - 0, - g_signal_accumulator_true_handled, - NULL, - _libxfce4panel_marshal_BOOLEAN__INT, - G_TYPE_BOOLEAN, - 1, G_TYPE_INT); - - /** - * XfcePanelPlugin::free-data - * @plugin : a #XfcePanelPlugin widget - * - * Emitted when the panel is closing. Plugin writers should connect to - * this signal to free any allocated resources. - * - * See also: #XfcePanelPlugin::save - **/ - xfce_panel_plugin_signals [FREE_DATA] = - g_signal_new (I_("free-data"), - G_TYPE_FROM_CLASS (klass), - G_SIGNAL_RUN_LAST | G_SIGNAL_NO_RECURSE | G_SIGNAL_NO_HOOKS, - 0, NULL, NULL, - g_cclosure_marshal_VOID__VOID, - G_TYPE_NONE, - 0); - - /** - * XfcePanelPlugin::save - * @plugin : a #XfcePanelPlugin widget - * - * Emitted before the panel is closing. May be called more than once - * while the panel is running. Plugin writers should connect to - * this signal to save the plugins configuration. - * - * See also: xfce_panel_plugin_get_rc_file() - **/ - xfce_panel_plugin_signals [SAVE] = - g_signal_new (I_("save"), - G_TYPE_FROM_CLASS (klass), - G_SIGNAL_RUN_LAST | G_SIGNAL_NO_RECURSE | G_SIGNAL_NO_HOOKS, - 0, NULL, NULL, - g_cclosure_marshal_VOID__VOID, - G_TYPE_NONE, - 0); - - /** - * XfcePanelPlugin::about - * @plugin : a #XfcePanelPlugin widget - * - * Emitted when the 'About' menu item is clicked. Plugin writers - * should connect to this signal to show information about their - * plugin (and its authors). - * - * See also: xfce_panel_plugin_menu_show_about() - **/ - xfce_panel_plugin_signals [ABOUT] = - g_signal_new (I_("about"), - G_TYPE_FROM_CLASS (klass), - G_SIGNAL_RUN_LAST | G_SIGNAL_NO_RECURSE | G_SIGNAL_NO_HOOKS, - 0, NULL, NULL, - g_cclosure_marshal_VOID__VOID, - G_TYPE_NONE, - 0); - - /** - * XfcePanelPlugin::configure-plugin - * @plugin : a #XfcePanelPlugin widget - * - * Emitted when the 'Configure' menu item is clicked. Plugin writers - * should connect to this signal to show a settings dialog. - * - * See also: xfce_panel_plugin_menu_show_configure() - **/ - xfce_panel_plugin_signals [CONFIGURE] = - g_signal_new (I_("configure-plugin"), - G_TYPE_FROM_CLASS (klass), - G_SIGNAL_RUN_LAST | G_SIGNAL_NO_RECURSE | G_SIGNAL_NO_HOOKS, - 0, NULL, NULL, - g_cclosure_marshal_VOID__VOID, - G_TYPE_NONE, - 0); - - /** - * XfcePanelPlugin:name - * - * Untranslated plugin name. This identifies the plugin type and - * therefore has to be unique. - **/ - g_object_interface_install_property (klass, - g_param_spec_string ("name", - "xfce_panel_plugin_name", - "Plugin name", - NULL, - PANEL_PARAM_READABLE)); - - /** - * XfcePanelPlugin:id - * - * Unique identifier string created for every #XfcePanelPlugin instance. - **/ - g_object_interface_install_property (klass, - g_param_spec_string ("id", - "xfce_panel_plugin_id", - "Plugin id", - NULL, - PANEL_PARAM_READABLE)); - - /** - * XfcePanelPlugin:display-name - * - * Translated plugin name. This is the name that can be presented to - * the user, e.g. in dialogs or menus. - **/ - g_object_interface_install_property (klass, - g_param_spec_string ("display-name", - "xfce_panel_plugin_display_name", - "Plugin display name", - NULL, - PANEL_PARAM_READABLE)); - - /** - * XfcePanelPlugin:size - * - * The current panel size. - **/ - g_object_interface_install_property (klass, - g_param_spec_int ("size", - "xfce_panel_plugin_size", - "Panel size", - 10, 128, 32, - PANEL_PARAM_READABLE)); - - /** - * XfcePanelPlugin:screen-position - * - * The current #XfceScreenPosition of the panel. - **/ - g_object_interface_install_property (klass, - g_param_spec_enum ("screen-position", - "xfce_panel_plugin_screen_position", - "Panel screen position", - XFCE_TYPE_SCREEN_POSITION, - XFCE_SCREEN_POSITION_S, - PANEL_PARAM_READABLE)); - - /** - * XfcePanelPlugin:expand - * - * Whether to expand the plugin when the panel width increases. - **/ - g_object_interface_install_property (klass, - g_param_spec_boolean ("expand", - "xfce_panel_plugin_expand", - "Whether to expand the plugin", - FALSE, - PANEL_PARAM_READWRITE)); - - initialized = TRUE; - } -} - - - -GType -xfce_panel_plugin_get_type (void) -{ - static GType type = 0; - - if (type == 0) - { - GTypeInfo info = - { - sizeof (XfcePanelPluginInterface), - xfce_panel_plugin_base_init, - NULL, - NULL, - NULL, - NULL, - 0, - 0, - NULL, - NULL - }; - - type = g_type_register_static (G_TYPE_INTERFACE, I_("XfcePanelPlugin"), &info, 0); - g_type_interface_add_prerequisite(type, GTK_TYPE_CONTAINER); - } - - return type; -} - - - -/** - * _xfce_panel_plugin_signal_screen_position - * @plugin : a #XfcePanelPlugin - * @position : the new #XfceScreenPosition of the panel. - * - * Should be called by implementations of the interface. - **/ -void -_xfce_panel_plugin_signal_screen_position (XfcePanelPlugin *plugin, - XfceScreenPosition position) -{ - _panel_return_if_fail (XFCE_IS_PANEL_PLUGIN (plugin)); - - g_signal_emit (G_OBJECT (plugin), xfce_panel_plugin_signals[SCREEN_POSITION_CHANGED], - 0, position); -} - - - -/** - * _xfce_panel_plugin_signal_orientation - * @plugin : a #XfcePanelPlugin - * @orientation : the new #GtkOrientation of the panel. - * - * Should be called by implementations of the interface. - **/ -void -_xfce_panel_plugin_signal_orientation (XfcePanelPlugin *plugin, - GtkOrientation orientation) -{ - _panel_return_if_fail (XFCE_IS_PANEL_PLUGIN (plugin)); - - g_signal_emit (G_OBJECT (plugin), xfce_panel_plugin_signals[ORIENTATION_CHANGED], 0, - orientation); -} - - - -/** - * _xfce_panel_plugin_signal_size - * @plugin : a #XfcePanelPlugin - * @size : the new size of the panel. - * - * Should be called by implementations of the interface. - **/ -void -_xfce_panel_plugin_signal_size (XfcePanelPlugin *plugin, - gint size) -{ - gboolean handled = FALSE; - - _panel_return_if_fail (XFCE_IS_PANEL_PLUGIN (plugin)); - - /* emit signal */ - g_signal_emit (G_OBJECT (plugin), xfce_panel_plugin_signals[SIZE_CHANGED], 0, - size, &handled); - - if (!handled) - { - /* size was not handled by the plugin, so we set it */ - gtk_widget_set_size_request (GTK_WIDGET (plugin), size, size); - } -} - - - -/** - * _xfce_panel_plugin_signal_free_data - * @plugin : a #XfcePanelPlugin - * - * Should be called by implementations of the interface. - **/ -void -_xfce_panel_plugin_signal_free_data (XfcePanelPlugin *plugin) -{ - _panel_return_if_fail (XFCE_IS_PANEL_PLUGIN (plugin)); - - g_signal_emit (G_OBJECT (plugin), xfce_panel_plugin_signals[FREE_DATA], 0); -} - - - -/** - * _xfce_panel_plugin_signal_save - * @plugin : a #XfcePanelPlugin - * - * Should be called by implementations of the interface. - **/ -void -_xfce_panel_plugin_signal_save (XfcePanelPlugin *plugin) -{ - _panel_return_if_fail (XFCE_IS_PANEL_PLUGIN (plugin)); - - g_signal_emit (G_OBJECT (plugin), xfce_panel_plugin_signals[SAVE], 0); -} - - - -/** - * xfce_panel_plugin_signal_about - * @plugin : a #XfcePanelPlugin - * - * Should be called by implementations of the interface. - **/ -static void -xfce_panel_plugin_signal_about (XfcePanelPlugin *plugin) -{ - _panel_return_if_fail (XFCE_IS_PANEL_PLUGIN (plugin)); - - g_signal_emit (G_OBJECT (plugin), xfce_panel_plugin_signals[ABOUT], 0); -} - - - -/** - * _xfce_panel_plugin_signal_configure - * @plugin : a #XfcePanelPlugin - * - * Should be called by implementations of the interface. - **/ -void -_xfce_panel_plugin_signal_configure (XfcePanelPlugin *plugin) -{ - _panel_return_if_fail (XFCE_IS_PANEL_PLUGIN (plugin)); - - g_signal_emit (G_OBJECT (plugin), xfce_panel_plugin_signals[CONFIGURE], 0); -} - - - -/** - * xfce_panel_plugin_get_name - * @plugin : a #XfcePanelPlugin - * - * The plugin name identifies a plugin type and therefore must be unique. - * - * Returns: the plugin name. - **/ -gchar * -xfce_panel_plugin_get_name (XfcePanelPlugin *plugin) -{ - gchar *name = NULL; - - _panel_return_val_if_fail (XFCE_IS_PANEL_PLUGIN (plugin), NULL); - - g_object_get (G_OBJECT (plugin), I_("name"), &name, NULL); - - return name; -} - - - -/** - * xfce_panel_plugin_get_id: - * @plugin : a #XfcePanelPlugin - * - * The plugin id is a unique identifier string that is given to every instance - * of a panel plugin. The returned string must be free using g_free(). - * - * Returns: the plugin id. - **/ -gchar * -xfce_panel_plugin_get_id (XfcePanelPlugin *plugin) -{ - gchar *id = NULL; - - _panel_return_val_if_fail (XFCE_IS_PANEL_PLUGIN (plugin), NULL); - - g_object_get (G_OBJECT (plugin), I_("id"), &id, NULL); - - return id; -} - - - -/** - * xfce_panel_plugin_get_display_name: - * @plugin : a #XfcePanelPlugin - * - * The display name is the (translated) plugin name that can be used in a user - * interface, e.g. a dialog or a menu. - * - * Returns: the display name of @plugin. - **/ -gchar * -xfce_panel_plugin_get_display_name (XfcePanelPlugin *plugin) -{ - gchar *name = NULL; - - _panel_return_val_if_fail (XFCE_IS_PANEL_PLUGIN (plugin), NULL); - - g_object_get (G_OBJECT (plugin), I_("display-name"), &name, NULL); - - return name; -} - - - -/** - * xfce_panel_plugin_get_size - * @plugin : a #XfcePanelPlugin - * - * The size of the panel that the plugin is part of. - * - * Returns: the current panel size. - **/ -gint -xfce_panel_plugin_get_size (XfcePanelPlugin *plugin) -{ - gint size; - - _panel_return_val_if_fail (XFCE_IS_PANEL_PLUGIN (plugin), 48); - - g_object_get (G_OBJECT (plugin), I_("size"), &size, NULL); - - return size; -} - - - -/** - * xfce_panel_plugin_get_screen_position - * @plugin : a #XfcePanelPlugin - * - * The #XfceScreenPosition of the panel that the plugin is part of. - * - * Returns: the current #XfceScreenPosition of the panel. - **/ -XfceScreenPosition -xfce_panel_plugin_get_screen_position (XfcePanelPlugin *plugin) -{ - XfceScreenPosition screen_position; - - _panel_return_val_if_fail (XFCE_IS_PANEL_PLUGIN (plugin), - XFCE_SCREEN_POSITION_S); - - g_object_get (G_OBJECT (plugin), I_("screen-position"), &screen_position, - NULL); - - return screen_position; -} - - - -/** - * xfce_panel_plugin_get_expand: - * @plugin : a #XfcePanelPlugin - * - * Return if this plugin will expand when the panel width increases. - * - * Returns: %TRUE when it will expand. - **/ -gboolean -xfce_panel_plugin_get_expand (XfcePanelPlugin *plugin) -{ - gboolean expand; - - _panel_return_val_if_fail (XFCE_IS_PANEL_PLUGIN (plugin), FALSE); - - g_object_get (G_OBJECT (plugin), I_("expand"), &expand, NULL); - - return expand; -} - - - -/** - * xfce_panel_plugin_get_orientation: - * @plugin : a #XfcePanelPlugin - * - * Return the #GtkOrientation of the panel that the plugin is part of. - * - * Returns: the current #GtkOrientation of the panel. - **/ -GtkOrientation -xfce_panel_plugin_get_orientation (XfcePanelPlugin *plugin) -{ - XfceScreenPosition screen_position; - - _panel_return_val_if_fail (XFCE_IS_PANEL_PLUGIN (plugin), - GTK_ORIENTATION_HORIZONTAL); - - g_object_get (G_OBJECT (plugin), I_("screen-position"), &screen_position, - NULL); - - return xfce_screen_position_get_orientation (screen_position); -} - - - -/** - * _xfce_panel_plugin_remove_confirm: - * @plugin : a #XfcePanelPlugin - * - * Ask the plugin to be removed. - **/ -void -_xfce_panel_plugin_remove_confirm (XfcePanelPlugin *plugin) -{ - GtkWidget *dialog; - gint response; - gchar *name; - - name = xfce_panel_plugin_get_display_name (plugin); - - dialog = gtk_message_dialog_new (NULL, - GTK_DIALOG_MODAL, - GTK_MESSAGE_QUESTION, - GTK_BUTTONS_NONE, - _("Remove \"%s\"?"), name); - - gtk_dialog_add_buttons (GTK_DIALOG (dialog), - GTK_STOCK_CANCEL, GTK_RESPONSE_NO, - GTK_STOCK_REMOVE, GTK_RESPONSE_YES, - NULL); - g_free (name); - - gtk_window_set_screen (GTK_WINDOW (dialog), - gtk_widget_get_screen (GTK_WIDGET (plugin))); - - gtk_dialog_set_default_response (GTK_DIALOG (dialog), GTK_RESPONSE_YES); - - gtk_message_dialog_format_secondary_text (GTK_MESSAGE_DIALOG (dialog), - _("The item will be removed from " - "the panel and its configuration " - "will be lost.")); - - response = gtk_dialog_run (GTK_DIALOG (dialog)); - gtk_widget_destroy (dialog); - - if (G_LIKELY (response == GTK_RESPONSE_YES)) - _xfce_panel_plugin_remove (plugin); -} - - - -/** - * _xfce_panel_plugin_remove: - * @plugin : a #XfcePanelPlugin - * - * Remove the plugin from the panel. - **/ -void -_xfce_panel_plugin_remove (XfcePanelPlugin *plugin) -{ - XFCE_PANEL_PLUGIN_GET_INTERFACE (plugin)->remove (plugin); -} - - - -/** - * xfce_panel_plugin_set_expand: - * @plugin : a #XfcePanelPlugin - * @expand : whether to expand the plugin - * - * Sets whether to expand the plugin when the width of the panel increases. - **/ -void -xfce_panel_plugin_set_expand (XfcePanelPlugin *plugin, - gboolean expand) -{ - XFCE_PANEL_PLUGIN_GET_INTERFACE (plugin)->set_expand (plugin, expand); -} - - - -/** - * _xfce_panel_plugin_customize_panel: - * @plugin : a #XfcePanelPlugin - * - * Ask the panel to show the settings dialog. - **/ -void -_xfce_panel_plugin_customize_panel (XfcePanelPlugin *plugin) -{ - XFCE_PANEL_PLUGIN_GET_INTERFACE (plugin)->customize_panel (plugin); -} - - - -/** - * xfce_panel_plugin_customize_items: - * @plugin : a #XfcePanelPlugin - * - * Ask the panel to show the settings dialog, with the 'Add Items' tab shown. - **/ -void -_xfce_panel_plugin_customize_items (XfcePanelPlugin *plugin) -{ - XFCE_PANEL_PLUGIN_GET_INTERFACE (plugin)->customize_items (plugin); -} - - - -/** - * xfce_panel_plugin_move: - * @plugin : a #XfcePanelPlugin - * - * Ask the panel to start a move operation. - **/ -void -_xfce_panel_plugin_move (XfcePanelPlugin *plugin) -{ - XFCE_PANEL_PLUGIN_GET_INTERFACE (plugin)->move (plugin); -} - - - -/** - * xfce_panel_plugin_register_menu: - * @plugin : a #XfcePanelPlugin - * @menu : a #GtkMenu that will be opened - * - * Register an open menu. This will make sure the panel will properly handle - * its autohide behaviour. You have to call this function every time the menu - * is opened (e.g. using gtk_popup_menu()). - * - * If you want to open the menu aligned to the side of the panel (and the - * plugin), you should use xfce_panel_plugin_position_menu() as - * #GtkMenuPositionFunc. This callback function will take care of calling - * xfce_panel_plugin_register_menu() as well. - * - * See also: xfce_panel_plugin_position_menu(). - **/ -void -xfce_panel_plugin_register_menu (XfcePanelPlugin *plugin, - GtkMenu *menu) -{ - XFCE_PANEL_PLUGIN_GET_INTERFACE (plugin)->register_menu (plugin, menu); -} - - - -/** - * xfce_panel_plugin_focus_widget: - * @plugin : a #XfcePanelPlugin - * @widget : widget to focus - * - * Grab the focus on @widget. Asks the panel to allow focus on its items and - * set the focus to the requested widget. - **/ -void -xfce_panel_plugin_focus_widget (XfcePanelPlugin *plugin, - GtkWidget *widget) -{ - XFCE_PANEL_PLUGIN_GET_INTERFACE (plugin)->focus_panel (plugin); - - gtk_widget_grab_focus (widget); -} - - - -/** - * xfce_panel_plugin_set_panel_hidden: - * @plugin : a #XfcePanelPlugin - * @hidden : %FALSE to unhide, %TRUE to hide the panel - * - * Ask the panel to hide or unhide. This only has effect when autohide is - * enabled. - **/ -void -xfce_panel_plugin_set_panel_hidden (XfcePanelPlugin *plugin, - gboolean hidden) -{ - XFCE_PANEL_PLUGIN_GET_INTERFACE (plugin)->set_panel_hidden (plugin, hidden); -} - - - -static void -_plugin_menu_deactivate (GtkWidget *menu) -{ - gint id = GPOINTER_TO_INT (g_object_get_data (G_OBJECT (menu), - I_("xfce-panel-plugin-button-release-callback"))); - - if (id) - { - g_signal_handler_disconnect (G_OBJECT (menu), id); - g_object_set_data (G_OBJECT (menu), - I_("xfce-panel-plugin-button-release-callback"), - NULL); - } -} - - - -static gboolean -_plugin_menu_button_released (GtkWidget *menu, - GdkEventButton *ev, - XfcePanelPlugin *plugin) -{ - gint id = GPOINTER_TO_INT (g_object_get_data (G_OBJECT (menu), - I_("xfce-panel-plugin-button-release-callback"))); - - if (id) - { - g_signal_handler_disconnect (G_OBJECT (menu), id); - g_object_set_data (G_OBJECT (menu), - I_("xfce-panel-plugin-button-release-callback"), - NULL); - return TRUE; - } - - return FALSE; -} - - - -void -_xfce_panel_plugin_create_menu (XfcePanelPlugin *plugin) -{ - GtkWidget *menu, *mi, *img; - gint insert_position; - gint configure_position; - gchar *name; - - _panel_return_if_fail (XFCE_IS_PANEL_PLUGIN (plugin)); - - /* leave when the user is not allowed to edit the panel */ - if (G_UNLIKELY (xfce_allow_panel_customization () == FALSE)) - return; - - xfce_textdomain (GETTEXT_PACKAGE, PACKAGE_LOCALE_DIR, "UTF-8"); - - menu = gtk_menu_new (); - - /* title */ - name = xfce_panel_plugin_get_display_name (plugin); - mi = gtk_menu_item_new_with_label (name); - g_free (name); - gtk_widget_set_sensitive (mi, FALSE); - gtk_widget_show (mi); - gtk_menu_shell_append (GTK_MENU_SHELL (menu), mi); - - mi = gtk_separator_menu_item_new (); - gtk_widget_show (mi); - gtk_menu_shell_append (GTK_MENU_SHELL (menu), mi); - - /* TRANSLATORS: Properties menu item in the right-click plugin menu */ - mi = gtk_image_menu_item_new_with_label (_("Properties")); - gtk_menu_shell_append (GTK_MENU_SHELL (menu), mi); - - img = gtk_image_new_from_stock (GTK_STOCK_PROPERTIES, GTK_ICON_SIZE_MENU); - gtk_widget_show (img); - gtk_image_menu_item_set_image (GTK_IMAGE_MENU_ITEM (mi), img); - - g_signal_connect_swapped (G_OBJECT (mi), "activate", - G_CALLBACK (_xfce_panel_plugin_signal_configure), - plugin); - - configure_position = 2; - g_object_set_data (G_OBJECT (plugin), - I_("xfce-panel-plugin-configure-position"), - GINT_TO_POINTER (configure_position)); - - /* TRANSLATORS: About menu item in the right-click plugin menu */ - mi = gtk_image_menu_item_new_with_label (_("About")); - gtk_menu_shell_append (GTK_MENU_SHELL (menu), mi); - - img = gtk_image_new_from_stock (GTK_STOCK_ABOUT, GTK_ICON_SIZE_MENU); - gtk_widget_show (img); - gtk_image_menu_item_set_image (GTK_IMAGE_MENU_ITEM (mi), img); - - g_signal_connect_swapped (G_OBJECT (mi), "activate", - G_CALLBACK (xfce_panel_plugin_signal_about), - plugin); - - /* TRANSLATORS: Move menu item in the right-click plugin menu */ - mi = gtk_image_menu_item_new_with_label (_("Move")); - gtk_widget_show (mi); - gtk_menu_shell_append (GTK_MENU_SHELL (menu), mi); - - img = gtk_image_new_from_stock (GTK_STOCK_GO_FORWARD, GTK_ICON_SIZE_MENU); - gtk_widget_show (img); - gtk_image_menu_item_set_image (GTK_IMAGE_MENU_ITEM (mi), img); - - g_signal_connect_swapped (G_OBJECT (mi), "activate", - G_CALLBACK (_xfce_panel_plugin_move), plugin); - - /* insert custom items after move */ - insert_position = 5; - - /* remove */ - mi = gtk_separator_menu_item_new(); - gtk_widget_show (mi); - gtk_menu_shell_append (GTK_MENU_SHELL (menu), mi); - - /* TRANSLATORS: Remove menu item in the right-click plugin menu */ - mi = gtk_image_menu_item_new_with_label (_("Remove")); - gtk_widget_show (mi); - gtk_menu_shell_append (GTK_MENU_SHELL (menu), mi); - - img = gtk_image_new_from_stock (GTK_STOCK_REMOVE, GTK_ICON_SIZE_MENU); - gtk_widget_show (img); - gtk_image_menu_item_set_image (GTK_IMAGE_MENU_ITEM (mi), img); - - g_signal_connect_swapped (G_OBJECT (mi), "activate", - G_CALLBACK (_xfce_panel_plugin_remove_confirm), - plugin); - - /* panel section */ - mi = gtk_separator_menu_item_new(); - gtk_widget_show (mi); - gtk_menu_shell_append (GTK_MENU_SHELL (menu), mi); - - /* TRANSLATORS: Add menu item in the right-click plugin menu */ - mi = gtk_image_menu_item_new_with_label (_("Add New Items...")); - gtk_widget_show (mi); - gtk_menu_shell_append (GTK_MENU_SHELL (menu), mi); - - img = gtk_image_new_from_stock (GTK_STOCK_ADD, GTK_ICON_SIZE_MENU); - gtk_widget_show (img); - gtk_image_menu_item_set_image (GTK_IMAGE_MENU_ITEM (mi), img); - - g_signal_connect_swapped (G_OBJECT (mi), "activate", - G_CALLBACK (_xfce_panel_plugin_customize_items), plugin); - - /* TRANSLATORS: Customize menu item in the right-click plugin menu */ - mi = gtk_image_menu_item_new_with_label (_("Customize Panel...")); - gtk_widget_show (mi); - gtk_menu_shell_append (GTK_MENU_SHELL (menu), mi); - - img = gtk_image_new_from_stock (GTK_STOCK_PREFERENCES, GTK_ICON_SIZE_MENU); - gtk_widget_show (img); - gtk_image_menu_item_set_image (GTK_IMAGE_MENU_ITEM (mi), img); - - g_signal_connect_swapped (G_OBJECT (mi), "activate", - G_CALLBACK (_xfce_panel_plugin_customize_panel), plugin); - - g_object_set_data (G_OBJECT (plugin), - I_("xfce-panel-plugin-insert-position"), - GINT_TO_POINTER (insert_position)); - - /* deactivation */ - g_signal_connect (G_OBJECT (menu), "deactivate", - G_CALLBACK (_plugin_menu_deactivate), NULL); - - g_object_set_data_full (G_OBJECT (plugin), I_("xfce-panel-plugin-menu"), - menu, (GDestroyNotify) gtk_widget_destroy); -} - - - -/** - * _xfce_panel_plugin_popup_menu: - * @plugin : a #XfcePanelPlugin - * - * Shows the right-click menu. - **/ -void -_xfce_panel_plugin_popup_menu (XfcePanelPlugin *plugin) -{ - GtkMenu *menu; - gint block, id; - - block = GPOINTER_TO_INT (g_object_get_data (G_OBJECT (plugin), - I_("xfce-panel-plugin-block"))); - - if (block > 0) - return; - - menu = g_object_get_data (G_OBJECT (plugin), I_("xfce-panel-plugin-menu")); - - if (menu) - { - id = g_signal_connect (G_OBJECT (menu), "button-release-event", - G_CALLBACK (_plugin_menu_button_released), - plugin); - - g_object_set_data (G_OBJECT (menu), - I_("xfce-panel-plugin-button-release-callback"), - GINT_TO_POINTER (id)); - - xfce_panel_plugin_register_menu (plugin, menu); - - gtk_menu_set_screen (menu, gtk_widget_get_screen (GTK_WIDGET (plugin))); - - gtk_menu_popup (menu, NULL, NULL, NULL, NULL, 0, GDK_CURRENT_TIME); - } -} - - - -static gboolean -_plugin_popup_menu (GtkWidget *widget, - GdkEventButton *ev, - XfcePanelPlugin *plugin) -{ - GtkMenu *menu; - guint modifiers; - gint block; - - block = GPOINTER_TO_INT (g_object_get_data (G_OBJECT (plugin), - I_("xfce-panel-plugin-block"))); - - if (block > 0) - return FALSE; - - menu = g_object_get_data (G_OBJECT (plugin), I_("xfce-panel-plugin-menu")); - - modifiers = gtk_accelerator_get_default_mod_mask (); - - if (ev->button == 3 || (ev->button == 1 && - (ev->state & modifiers) == GDK_CONTROL_MASK)) - { - gtk_menu_set_screen (menu, gtk_widget_get_screen (widget)); - - xfce_panel_plugin_register_menu (plugin, menu); - - gtk_menu_popup (menu, NULL, NULL, NULL, NULL, ev->button, ev->time); - - return TRUE; - } - - return FALSE; -} - - - -/** - * xfce_panel_plugin_add_action_widget: - * @plugin : a #XfcePanelPlugin - * @widget : a #GtkWidget that receives mouse events - * - * Attach the plugin menu to this widget. Plugin writers should call this - * for every widget that can receive mouse events. If you forget to call this - * the plugin will not have a right-click menu and the user won't be able to - * remove it. - **/ -void -xfce_panel_plugin_add_action_widget (XfcePanelPlugin *plugin, - GtkWidget *widget) -{ - GtkWidget *menu = - g_object_get_data (G_OBJECT (plugin), I_("xfce-panel-plugin-menu")); - - if (menu) - { - g_signal_connect (G_OBJECT (widget), "button-press-event", - G_CALLBACK (_plugin_popup_menu), plugin); - } -} - - - -/** - * xfce_panel_plugin_menu_insert_item: - * @plugin : a #XfcePanelPlugin - * @item : the menu item to add - * - * Insert custom menu item. - **/ -void -xfce_panel_plugin_menu_insert_item (XfcePanelPlugin *plugin, - GtkMenuItem *item) -{ - gint position; - GtkWidget *menu = - g_object_get_data (G_OBJECT (plugin), I_("xfce-panel-plugin-menu")); - - if (menu) - { - position = GPOINTER_TO_INT (g_object_get_data (G_OBJECT (plugin), - I_("xfce-panel-plugin-insert-position"))); - - gtk_menu_shell_insert (GTK_MENU_SHELL (menu), GTK_WIDGET (item), - position); - - position++; - - g_object_set_data (G_OBJECT (plugin), - I_("xfce-panel-plugin-insert-position"), - GINT_TO_POINTER (position)); - } -} - - - -/** - * xfce_panel_plugin_menu_show_about: - * @plugin : a #XfcePanelPlugin - * - * Show the 'About' item in the menu. Clicking on the menu item will emit - * the "about" signal. - **/ -void -xfce_panel_plugin_menu_show_about (XfcePanelPlugin *plugin) -{ - gint position; - GList *l; - GtkWidget *menu = - g_object_get_data (G_OBJECT (plugin), I_("xfce-panel-plugin-menu")); - - if (menu) - { - position = GPOINTER_TO_INT (g_object_get_data (G_OBJECT (plugin), - I_("xfce-panel-plugin-configure-position"))); - - l = g_list_nth (GTK_MENU_SHELL (menu)->children, position+1); - - if (l) - gtk_widget_show (GTK_WIDGET (l->data)); - } -} - - - -/** - * xfce_panel_plugin_menu_show_configure: - * @plugin : a #XfcePanelPlugin - * - * Show the 'Configure' item in the menu. Clicking on the menu item will emit - * the "configure-plugin" signal. - **/ -void -xfce_panel_plugin_menu_show_configure (XfcePanelPlugin *plugin) -{ - GtkWidget *menu; - gint position; - GList *l; - - if (G_UNLIKELY (xfce_allow_panel_customization() == FALSE)) - return; - - menu = g_object_get_data (G_OBJECT (plugin), I_("xfce-panel-plugin-menu")); - - if (menu) - { - position = GPOINTER_TO_INT (g_object_get_data (G_OBJECT (plugin), - I_("xfce-panel-plugin-configure-position"))); - - l = g_list_nth (GTK_MENU_SHELL (menu)->children, position); - - if (l) - gtk_widget_show (GTK_WIDGET (l->data)); - } -} - - - -/** - * xfce_panel_plugin_block_menu: - * @plugin : a #XfcePanelPlugin - * - * Temporarily block the menu from being shown. This can be used by plugin - * writers when the configuration dialog is active. - * - * See also: xfce_panel_plugin_unblock_menu() - **/ -void -xfce_panel_plugin_block_menu (XfcePanelPlugin *plugin) -{ - gint n = 1; - - g_object_set_data (G_OBJECT (plugin), I_("xfce-panel-plugin-block"), - GINT_TO_POINTER (n)); -} - - - -/** - * xfce_panel_plugin_unblock_menu: - * @plugin : a #XfcePanelPlugin - * - * Don't block the menu from being shown. - * - * See also: xfce_panel_plugin_block_menu() - **/ -void -xfce_panel_plugin_unblock_menu (XfcePanelPlugin *plugin) -{ - g_object_set_data (G_OBJECT (plugin), I_("xfce-panel-plugin-block"), NULL); -} - - - -/** - * xfce_panel_plugin_lookup_rc_file: - * @plugin : a #XfcePanelPlugin - * - * Looks up unique filename associated with @plugin in standard configuration - * locations. Only use this function when you want the read location of the - * configuration file, since the path might point to a not writable file (for - * example the default- or kiosk-configuration). - * - * See also: xfce_panel_plugin_save_location() and #xfce_resource_lookup () - * - * Returns: path to configuration file or %NULL if none was found. The - * returned string must be freed using g_free (). - **/ -gchar * -xfce_panel_plugin_lookup_rc_file (XfcePanelPlugin *plugin) -{ - gchar path[255]; - gchar *id, *name; - - name = xfce_panel_plugin_get_name (plugin); - id = xfce_panel_plugin_get_id (plugin); - - g_snprintf (path, sizeof (path), - "xfce4" G_DIR_SEPARATOR_S - "panel" G_DIR_SEPARATOR_S "%s-%s.rc", name, id); - - g_free (name); - g_free (id); - - return xfce_resource_lookup (XFCE_RESOURCE_CONFIG, path); -} - - - -/** - * xfce_panel_plugin_save_location: - * @plugin : a #XfcePanelPlugin - * @create : whether the file should be created - * - * Returns the path that can be used to store configuration information. Don't use - * this function when you want to read the configuration file, then use - * #xfce_panel_plugin_lookup_rc_file. - * - * See also xfce_panel_plugin_lookup_rc_file() and #xfce_resource_save_location(). - * - * Returns: path to configuration file or %NULL is the file could not be - * created. The returned string must be freed using g_free (). - **/ -gchar * -xfce_panel_plugin_save_location (XfcePanelPlugin *plugin, - gboolean create) -{ - gchar path[255]; - gchar *name, *id; - - name = xfce_panel_plugin_get_name (plugin); - id = xfce_panel_plugin_get_id (plugin); - - g_snprintf (path, sizeof (path), - "xfce4" G_DIR_SEPARATOR_S - "panel" G_DIR_SEPARATOR_S "%s-%s.rc", name, id); - - g_free (name); - g_free (id); - - return xfce_resource_save_location (XFCE_RESOURCE_CONFIG, path, create); -} - - - -void -_xfce_panel_plugin_set_sensitive (XfcePanelPlugin *plugin, - gboolean sensitive) -{ - if (GTK_BIN (plugin)->child) - gtk_widget_set_sensitive (GTK_BIN (plugin)->child, sensitive); - else - g_signal_connect_after (G_OBJECT (plugin), "realize", - G_CALLBACK (_xfce_panel_plugin_set_sensitive), - GINT_TO_POINTER (sensitive)); -} - - - -/* user menus & popups */ - -/** - * xfce_panel_plugin_arrow_type: - * @plugin : an #XfcePanelPlugin - * - * Determine the #GtkArrowType for a widget that opens a menu and uses - * xfce_panel_plugin_position_menu() to position the menu. - * - * Returns: The #GtkArrowType to use. - **/ -GtkArrowType -xfce_panel_plugin_arrow_type (XfcePanelPlugin *plugin) -{ - XfceScreenPosition position; - GdkScreen *screen; - GdkRectangle geom; - gint mon, x, y; - - if (!GTK_WIDGET_REALIZED (plugin)) - return GTK_ARROW_UP; - - position = xfce_panel_plugin_get_screen_position (plugin); - switch (position) - { - /* top */ - case XFCE_SCREEN_POSITION_NW_H: - case XFCE_SCREEN_POSITION_N: - case XFCE_SCREEN_POSITION_NE_H: - return GTK_ARROW_DOWN; - - /* left */ - case XFCE_SCREEN_POSITION_NW_V: - case XFCE_SCREEN_POSITION_W: - case XFCE_SCREEN_POSITION_SW_V: - return GTK_ARROW_RIGHT; - - /* right */ - case XFCE_SCREEN_POSITION_NE_V: - case XFCE_SCREEN_POSITION_E: - case XFCE_SCREEN_POSITION_SE_V: - return GTK_ARROW_LEFT; - - /* bottom */ - case XFCE_SCREEN_POSITION_SW_H: - case XFCE_SCREEN_POSITION_S: - case XFCE_SCREEN_POSITION_SE_H: - return GTK_ARROW_UP; - - /* floating */ - default: - /* get the screen information */ - screen = gtk_widget_get_screen (GTK_WIDGET (plugin)); - mon = gdk_screen_get_monitor_at_window (screen, GTK_WIDGET (plugin)->window); - gdk_screen_get_monitor_geometry (screen, mon, &geom); - gdk_window_get_root_origin (GTK_WIDGET (plugin)->window, &x, &y); - - /* get the position based on the screen position */ - if (position == XFCE_SCREEN_POSITION_FLOATING_H) - return ((y < (geom.y + geom.height / 2)) ? GTK_ARROW_DOWN : GTK_ARROW_UP); - else - return ((x < (geom.x + geom.width / 2)) ? GTK_ARROW_RIGHT : GTK_ARROW_LEFT); - } -} - - - -/** - * xfce_panel_plugin_position_widget: - * @plugin : an #XfcePanelPlugin - * @menu_widget : a #GtkWidget that will be used as popup menu - * @attach_widget : a #GtkWidget relative to which the menu should be positioned - * @x : return location for the x coordinate - * @y : return location for the y coordinate - * - * The menu widget is positioned relative to @attach_widget. - * If @attach_widget is NULL, the menu widget is instead positioned - * relative to @panel_plugin. - * - * This function is intended for custom menu widgets. - * For a regular #GtkMenu you should use xfce_panel_plugin_position_menu() - * instead (as callback argument to gtk_menu_popup()). - * - * See also: xfce_panel_plugin_position_menu(). - **/ -void -xfce_panel_plugin_position_widget (XfcePanelPlugin *plugin, - GtkWidget *menu_widget, - GtkWidget *attach_widget, - gint *x, - gint *y) -{ - GtkRequisition req; - GdkScreen *screen; - GdkRectangle geom; - gint mon; - - _panel_return_if_fail (XFCE_IS_PANEL_PLUGIN (plugin)); - _panel_return_if_fail (GTK_IS_WIDGET (menu_widget)); - _panel_return_if_fail (attach_widget == NULL || GTK_IS_WIDGET (attach_widget)); - - if (attach_widget == NULL) - attach_widget = GTK_WIDGET (plugin); - - if (!GTK_WIDGET_REALIZED (menu_widget)) - gtk_widget_realize (menu_widget); - - gtk_widget_size_request (menu_widget, &req); - gdk_window_get_origin (attach_widget->window, x, y); - - switch (xfce_panel_plugin_arrow_type (plugin)) - { - case GTK_ARROW_UP: - *y -= req.height; - break; - - case GTK_ARROW_DOWN: - *y += attach_widget->allocation.height; - break; - - case GTK_ARROW_LEFT: - *x -= req.width; - break; - - default: /* GTK_ARROW_RIGHT and GTK_ARROW_NONE */ - *x += attach_widget->allocation.width; - break; - } - - screen = gtk_widget_get_screen (attach_widget); - mon = gdk_screen_get_monitor_at_window (screen, attach_widget->window); - gdk_screen_get_monitor_geometry (screen, mon, &geom); - - /* keep inside the screen */ - if (*x > geom.x + geom.width - req.width) - *x = geom.x + geom.width - req.width; - if (*x < geom.x) - *x = geom.x; - if (*y > geom.y + geom.height - req.height) - *y = geom.y + geom.height - req.height; - if (*y < geom.y) - *y = geom.y; - - if (G_LIKELY (GTK_IS_MENU (menu_widget))) - gtk_menu_set_screen (GTK_MENU (menu_widget), screen); - else if (GTK_IS_WINDOW (menu_widget)) - gtk_window_set_screen (GTK_WINDOW (menu_widget), screen); -} - - - -/** - * xfce_panel_plugin_position_menu: - * @menu : a #GtkMenu - * @x : return location for the x coordinate - * @y : return location for the y coordinate - * @push_in : keep inside the screen (see #GtkMenuPositionFunc) - * @panel_plugin : a pointer to an #XfcePanelPlugin - * - * Function to be used as #GtkMenuPositionFunc in a call to gtk_menu_popup(). - * As data argument it needs an #XfcePanelPlugin. - * - * The menu is normally positioned relative to @panel_plugin. If you want the - * menu to be positioned relative to another widget, you can use - * gtk_menu_attach_to_widget() to explicitly set a 'parent' widget. - * - * As a convenience, xfce_panel_plugin_position_menu() calls - * xfce_panel_plugin_register_menu() for the menu. - * - * <example> - * void - * myplugin_popup_menu (XfcePanelPlugin *plugin, - * GtkMenu *menu, - * GdkEventButton *ev) - * { - * gtk_menu_popup (menu, NULL, NULL, - * xfce_panel_plugin_position_menu, plugin, - * ev->button, ev->time ); - * } - * </example> - * - * For a custom widget that will be used as a popup menu, use - * xfce_panel_plugin_position_widget() instead. - * - * See also: gtk_menu_popup(). - **/ -void -xfce_panel_plugin_position_menu (GtkMenu *menu, - gint *x, - gint *y, - gboolean *push_in, - gpointer panel_plugin) -{ - XfcePanelPlugin *plugin = XFCE_PANEL_PLUGIN (panel_plugin); - GtkWidget *attach_widget; - - attach_widget = gtk_menu_get_attach_widget (menu); - - xfce_panel_plugin_position_widget (plugin, - GTK_WIDGET (menu), - attach_widget, - x, y); - - /* keep inside screen */ - *push_in = TRUE; - - xfce_panel_plugin_register_menu (plugin, menu); -} - - - -#define __XFCE_PANEL_PLUGIN_IFACE_C__ -#include <libxfce4panel/libxfce4panel-aliasdef.c> - |