gnome-window-icon

Name

gnome-window-icon -- Convenience functions for window mini-icons

Synopsis


#include <gnome.h>


void        gnome_window_icon_set_from_default
                                            (GtkWindow *w);
void        gnome_window_icon_set_from_file (GtkWindow *w,
                                             const char *filename);
void        gnome_window_icon_set_from_imlib
                                            (GtkWindow *w,
                                             GdkImlibImage *im);
void        gnome_window_icon_set_default_from_file
                                            (const char *filename);
void        gnome_window_icon_set_default_from_imlib
                                            (GdkImlibImage *im);
void        gnome_window_icon_init          (void);

Description

These functions are a convenience wrapper for the gdk_window_set_icon() function. They allow setting a default icon, which is used by many top level windows in libgnomeui, such as GnomeApp and GnomeDialog windows.

They also handle drawing the icon on the iconified window's icon in window managers such as TWM and Window Maker.

These functions were added with the 1.2.0 release of the GNOME libraries in May, 2000. This means that not all users will have this functionality in the GNOME libraries, and should only be used accordingly. The header file must be explicitely included, also (include <libgnomeui/gnome-window-icon.h>).

Details

gnome_window_icon_set_from_default ()

void        gnome_window_icon_set_from_default
                                            (GtkWindow *w);

Makes the GtkWindow w use the default icon.

w : the GtkWidget to set the icon on


gnome_window_icon_set_from_file ()

void        gnome_window_icon_set_from_file (GtkWindow *w,
                                             const char *filename);

Makes the GtkWindow w use the icon in filename.

w : the GtkWidget to set the icon on
filename : the name of the file to load


gnome_window_icon_set_from_imlib ()

void        gnome_window_icon_set_from_imlib
                                            (GtkWindow *w,
                                             GdkImlibImage *im);

Makes the GtkWindow w use the icon in im.

w : the GtkWidget to set the icon on
im : the imlib image to use for the icon


gnome_window_icon_set_default_from_file ()

void        gnome_window_icon_set_default_from_file
                                            (const char *filename);

Set the default icon to the image in filename, if one of the gnome_window_icon_set_default_from* functions have not already been called.

filename : filename for the default window icon


gnome_window_icon_set_default_from_imlib ()

void        gnome_window_icon_set_default_from_imlib
                                            (GdkImlibImage *im);

Set the default icon to the image in im, if one of the gnome_window_icon_set_default_from* functions have not already been called.

im : imlib image for the default icon


gnome_window_icon_init ()

void        gnome_window_icon_init          (void);

Initialize the gnome window icon by checking the GNOME_DESKTOP_ICON environment variable. This function is automatically called by the gnome_init process.

See Also

gdk_window_set_icon()