Libxfce4panel Reference Manual | ||||
---|---|---|---|---|
Top | Description |
#include <libxfce4panel/libxfce4panel.h> GtkWidget * xfce_panel_create_button (void
); GtkWidget * xfce_panel_create_toggle_button (void
); const gchar * xfce_panel_get_channel_name (void
); GdkPixbuf * xfce_panel_pixbuf_from_source (const gchar *source
,GtkIconTheme *icon_theme
,gint size
); GdkPixbuf * xfce_panel_pixbuf_from_source_at_size (const gchar *source
,GtkIconTheme *icon_theme
,gint dest_width
,gint dest_height
); #define xfce_allow_panel_customization #define xfce_create_panel_button #define xfce_create_panel_toggle_button
This section describes a number of functions that were created to help developers of Xfce Panel plugins.
GtkWidget * xfce_panel_create_button (void
);
Create regular GtkButton with a few properties set to be useful in the
Xfce panel: Flat (GTK_RELIEF_NONE
), no focus on click and minimal padding.
Returns : |
newly created GtkButton. |
GtkWidget * xfce_panel_create_toggle_button (void
);
Create regular GtkToggleButton with a few properties set to be useful in
Xfce panel: Flat (GTK_RELIEF_NONE
), no focus on click and minimal padding.
Returns : |
newly created GtkToggleButton. |
const gchar * xfce_panel_get_channel_name (void
);
Function for the name of the Xfconf channel used by the panel. By default this returns "xfce4-panel", but you can override this value with the environment variable XFCE_PANEL_CHANNEL_NAME.
Returns : |
name of the Xfconf channel See also: XFCE_PANEL_CHANNEL_NAME, xfce_panel_plugin_xfconf_channel_new and xfce_panel_plugin_get_property_base |
Since 4.8
GdkPixbuf * xfce_panel_pixbuf_from_source (const gchar *source
,GtkIconTheme *icon_theme
,gint size
);
See xfce_panel_pixbuf_from_source_at_size
|
string that contains the location of an icon |
|
icon theme or NULL to use the default icon theme |
|
size the icon that should be loaded |
Returns : |
a GdkPixbuf or NULL if nothing was found. The value should
be released with g_object_unref when no longer used.
See also: XfcePanelImage |
Since 4.8
GdkPixbuf * xfce_panel_pixbuf_from_source_at_size (const gchar *source
,GtkIconTheme *icon_theme
,gint dest_width
,gint dest_height
);
Try to load a pixbuf from a source string. The source could be an abolute path, an icon name or a filename that points to a file in the pixmaps directory.
This function is particularly usefull for loading names from the Icon key of desktop files.
The pixbuf is never bigger than dest_width
and dest_height
.
If it is when loaded from the disk, the pixbuf is scaled
preserving the aspect ratio.
|
string that contains the location of an icon |
|
icon theme or NULL to use the default icon theme |
|
the maximum returned width of the GdkPixbuf |
|
the maximum returned height of the GdkPixbuf |
Returns : |
a GdkPixbuf or NULL if nothing was found. The value should
be released with g_object_unref when no longer used.
See also: XfcePanelImage |
Since 4.10
#define xfce_allow_panel_customization (FALSE)
xfce_allow_panel_customization
has been deprecated since version 4.8 and should not be used in newly-written code. Look at xfce_panel_plugin_get_locked()
.
Always returns FALSE
. Plugins can be locked on a plugin basis
level in the future, so this function is useless.
#define xfce_create_panel_button xfce_panel_create_button
xfce_create_panel_button
has been deprecated since version 4.8 and should not be used in newly-written code. Use xfce_panel_create_button()
instead.
See xfce_panel_create_button()
for more information.
#define xfce_create_panel_toggle_button xfce_panel_create_toggle_button
xfce_create_panel_toggle_button
has been deprecated since version 4.8 and should not be used in newly-written code. Use xfce_panel_create_toggle_button()
instead.
See xfce_panel_create_toggle_button()
for more information.