libxfce4panel Reference Manual |
---|
XfcePanelPluginXfcePanelPlugin — Panel plugin interface. |
XfcePanelPlugin; void (*XfcePanelPluginFunc) (XfcePanelPlugin *plugin); const char* xfce_panel_plugin_get_name (XfcePanelPlugin *plugin); const char* xfce_panel_plugin_get_id (XfcePanelPlugin *plugin); const char* xfce_panel_plugin_get_display_name (XfcePanelPlugin *plugin); int xfce_panel_plugin_get_size (XfcePanelPlugin *plugin); XfceScreenPosition xfce_panel_plugin_get_screen_position (XfcePanelPlugin *plugin); void xfce_panel_plugin_set_expand (XfcePanelPlugin *plugin, gboolean expand); gboolean xfce_panel_plugin_get_expand (XfcePanelPlugin *plugin); GtkOrientation xfce_panel_plugin_get_orientation (XfcePanelPlugin *plugin); void xfce_panel_plugin_add_action_widget (XfcePanelPlugin *plugin, GtkWidget *widget); void xfce_panel_plugin_menu_insert_item (XfcePanelPlugin *plugin, GtkMenuItem *item); void xfce_panel_plugin_menu_show_about (XfcePanelPlugin *plugin); void xfce_panel_plugin_menu_show_configure (XfcePanelPlugin *plugin); void xfce_panel_plugin_block_menu (XfcePanelPlugin *plugin); void xfce_panel_plugin_unblock_menu (XfcePanelPlugin *plugin); void xfce_panel_plugin_register_menu (XfcePanelPlugin *plugin, GtkMenu *menu); char* xfce_panel_plugin_lookup_rc_file (XfcePanelPlugin *plugin); char* xfce_panel_plugin_save_location (XfcePanelPlugin *plugin, gboolean create);
XfcePanelPlugin is implemented by XfceExternalPanelPlugin and XfceInternalPanelPlugin.
"display-name" gchararray : Read "expand" gboolean : Read / Write "id" gchararray : Read "name" gchararray : Read "screen-position" XfceScreenPosition : Read "size" gint : Read
"about" void user_function (XfcePanelPlugin *plugin, gpointer user_data); "configure-plugin" void user_function (XfcePanelPlugin *plugin, gpointer user_data); "free-data" void user_function (XfcePanelPlugin *plugin, gpointer user_data); "orientation-changed" void user_function (XfcePanelPlugin *plugin, GtkOrientation orientation, gpointer user_data); "save" void user_function (XfcePanelPlugin *plugin, gpointer user_data); "screen-position-changed" void user_function (XfcePanelPlugin *plugin, XfceScreenPosition position, gpointer user_data); "size-changed" gboolean user_function (XfcePanelPlugin *plugin, gint size, gpointer user_data);
The interface implemented by both internal and external plugins. Plugin writers may use the functions described below to interact with the plugin widget.
typedef struct _XfcePanelPlugin XfcePanelPlugin;
The XfcePanelPlugin-struct is a purely virtual object to describe an instance of a widget implementing the panel plugin interface.
void (*XfcePanelPluginFunc) (XfcePanelPlugin *plugin);
Callback function to create the plugin contents. It should be given as the argument to the registration macros.
See also: XFCE_PANEL_PLUGIN_REGISTER_EXTERNAL()
and
XFCE_PANEL_PLUGIN_REGISTER_INTERNAL()
plugin : |
The XfcePanelPlugin |
const char* xfce_panel_plugin_get_name (XfcePanelPlugin *plugin);
The plugin name identifies a plugin type and therefore must be unique.
plugin : |
an XfcePanelPlugin |
Returns : | the plugin name. |
const char* xfce_panel_plugin_get_id (XfcePanelPlugin *plugin);
The plugin id is a unique identifier string that is given to every instance of a panel plugin.
plugin : |
an XfcePanelPlugin |
Returns : | the plugin id. |
const char* xfce_panel_plugin_get_display_name (XfcePanelPlugin *plugin);
The display name is the (translated) plugin name that can be used in a user interface, e.g. a dialog or a menu.
plugin : |
an XfcePanelPlugin |
Returns : | the display name of plugin .
|
int xfce_panel_plugin_get_size (XfcePanelPlugin *plugin);
plugin : |
an XfcePanelPlugin |
Returns : | the current panel size. |
XfceScreenPosition xfce_panel_plugin_get_screen_position (XfcePanelPlugin *plugin);
plugin : |
an XfcePanelPlugin |
Returns : | the current XfceScreenPosition of the panel. |
void xfce_panel_plugin_set_expand (XfcePanelPlugin *plugin, gboolean expand);
Sets whether to expand the plugin when the width of the panel increases.
plugin : |
an XfcePanelPlugin |
expand : |
whether to expand the plugin |
gboolean xfce_panel_plugin_get_expand (XfcePanelPlugin *plugin);
plugin : |
an XfcePanelPlugin |
Returns : | whether the plugin will expand when the panel width increases. |
GtkOrientation xfce_panel_plugin_get_orientation (XfcePanelPlugin *plugin);
plugin : |
an XfcePanelPlugin |
Returns : | the current GtkOrientation of the panel. |
void xfce_panel_plugin_add_action_widget (XfcePanelPlugin *plugin, GtkWidget *widget);
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.
plugin : |
an XfcePanelPlugin |
widget : |
a GtkWidget that receives mouse events |
void xfce_panel_plugin_menu_insert_item (XfcePanelPlugin *plugin, GtkMenuItem *item);
Insert custom menu item.
plugin : |
an XfcePanelPlugin |
item : |
the menu item to add |
void xfce_panel_plugin_menu_show_about (XfcePanelPlugin *plugin);
Show the 'About' item in the menu. Clicking on the menu item will emit the "about" signal.
plugin : |
an XfcePanelPlugin |
void xfce_panel_plugin_menu_show_configure (XfcePanelPlugin *plugin);
Show the 'Configure' item in the menu. Clicking on the menu item will emit the "configure-plugin" signal.
plugin : |
an XfcePanelPlugin |
void xfce_panel_plugin_block_menu (XfcePanelPlugin *plugin);
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()
plugin : |
an XfcePanelPlugin |
void xfce_panel_plugin_unblock_menu (XfcePanelPlugin *plugin);
Don't block the menu from being shown.
See also: xfce_panel_plugin_block_menu()
plugin : |
an XfcePanelPlugin |
void xfce_panel_plugin_register_menu (XfcePanelPlugin *plugin, GtkMenu *menu);
Register an open menu. This will make sure the panel will properly handle its autohide behaviour.
plugin : |
an XfcePanelPlugin |
menu : |
a GtkMenu that will be opened |
char* xfce_panel_plugin_lookup_rc_file (XfcePanelPlugin *plugin);
Looks up unique filename associated with plugin
in standard configuration
locations. Uses xfce_resource_lookup()
internally.
plugin : |
an XfcePanelPlugin |
Returns : | path to configuration file or NULL if none was found. The
returned string must be freed using g_free() .
See also: xfce_panel_plugin_save_location()
|
char* xfce_panel_plugin_save_location (XfcePanelPlugin *plugin, gboolean create);
Unique file location that can be used to store configuration information.
Uses xfce_resource_save_location()
internally.
plugin : |
an XfcePanelPlugin |
create : |
whether the file should be created |
Returns : | path to configuration file or NULL is the file could not be
created. The returned string must be freed using g_free() .
See also: xfce_panel_plugin_lookup_rc_file()
|
display-name
" property"display-name" gchararray : Read
Translated plugin name. This is the name that can be presented to the user, e.g. in dialogs or menus.
Default value: NULL
expand
" property"expand" gboolean : Read / Write
Whether to expand the plugin when the panel width increases.
Default value: FALSE
id
" property"id" gchararray : Read
Unique identifier string created for every XfcePanelPlugin instance.
Default value: NULL
name
" property"name" gchararray : Read
Untranslated plugin name. This identifies the plugin type and therefore has to be unique.
Default value: NULL
screen-position
" property"screen-position" XfceScreenPosition : Read
The current XfceScreenPosition of the panel.
Default value: XFCE_SCREEN_POSITION_S
size
" property"size" gint : Read
The current panel size.
Allowed values: [10,128]
Default value: 32
void user_function (XfcePanelPlugin *plugin, gpointer user_data);
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()
plugin : |
a XfcePanelPlugin widget |
user_data : |
user data set when the signal handler was connected. |
void user_function (XfcePanelPlugin *plugin, gpointer user_data);
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()
plugin : |
a XfcePanelPlugin widget |
user_data : |
user data set when the signal handler was connected. |
void user_function (XfcePanelPlugin *plugin, gpointer user_data);
Emitted when the panel is closing. Plugin writers should connect to this signal to free any allocated resources.
See also: XfcePanelPlugin::save
plugin : |
a XfcePanelPlugin widget |
user_data : |
user data set when the signal handler was connected. |
void user_function (XfcePanelPlugin *plugin, GtkOrientation orientation, gpointer user_data);
Emitted when the panel orientation changes.
plugin : |
a XfcePanelPlugin widget |
orientation : |
new GtkOrientation of the panel |
user_data : |
user data set when the signal handler was connected. |
void user_function (XfcePanelPlugin *plugin, gpointer user_data);
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()
plugin : |
a XfcePanelPlugin widget |
user_data : |
user data set when the signal handler was connected. |
void user_function (XfcePanelPlugin *plugin, XfceScreenPosition position, gpointer user_data);
Emitted when the screen position changes. Most plugins will be more interested in the "orientation-changed" signal.
plugin : |
a XfcePanelPlugin widget |
position : |
new XfceScreenPosition of the panel |
user_data : |
user data set when the signal handler was connected. |
gboolean user_function (XfcePanelPlugin *plugin, gint size, gpointer user_data);
Emitted when the panel size changes.
plugin : |
a XfcePanelPlugin widget |
size : |
new panel size |
user_data : |
user data set when the signal handler was connected. |
Returns : | TRUE when handled, FALSE otherwise.
|
<< Writing Plugins | XfceExternalPanelPlugin >> |