gtkpixmap

gtkpixmap — a widget displaying a graphical image or icon

synopsis


#include <gtk/gtk.h>


            gtkpixmap;
gtkwidget*  gtk_pixmap_new                  (gdkpixmap *pixmap,
                                             gdkbitmap *mask);
void        gtk_pixmap_set                  (gtkpixmap *pixmap,
                                             gdkpixmap *val,
                                             gdkbitmap *mask);
void        gtk_pixmap_get                  (gtkpixmap *pixmap,
                                             gdkpixmap **val,
                                             gdkbitmap **mask);
void        gtk_pixmap_set_build_insensitive
                                            (gtkpixmap *pixmap,
                                             gboolean build);

object hierarchy


  gobject
   +----ginitiallyunowned
         +----gtkobject
               +----gtkwidget
                     +----gtkmisc
                           +----gtkpixmap

implemented interfaces

gtkpixmap implements atkimplementoriface.

description

the gtkpixmap widget displays a graphical image or icon. the icon is typically created using gdk_pixmap_colormap_create_from_xpm() or gdk_pixmap_colormap_create_from_xpm_d().

the pixels in a gtkpixmap cannot be manipulated by the application after creation, since under the x window system the pixel data is stored on the x server and so is not available to the client application. if you want to create graphical images which can be manipulated by the application, look at gtkimage and gdkrgb.

gtkpixmap has been deprecated since gtk+ 2.0 and should not be used in newly written code. use gtkimage instead.

details

gtkpixmap

typedef struct _gtkpixmap gtkpixmap;

warning

gtkpixmap is deprecated and should not be used in newly-written code.

the gtkpixmap-struct struct contains private data only, and should be accessed using the functions below.

gtk_pixmap_new ()

gtkwidget*  gtk_pixmap_new                  (gdkpixmap *pixmap,
                                             gdkbitmap *mask);

warning

gtk_pixmap_new is deprecated and should not be used in newly-written code.

creates a new gtkpixmap, using the given gdk pixmap and mask.

`pixmap` :	a gdkpixmap.
`mask` :	a gdkbitmap which indicates which parts of the `pixmap` should be transparent.
returns :	a new gtkpixmap.

gtk_pixmap_set ()

void        gtk_pixmap_set                  (gtkpixmap *pixmap,
                                             gdkpixmap *val,
                                             gdkbitmap *mask);

warning

gtk_pixmap_set is deprecated and should not be used in newly-written code.

sets the gdkpixmap and gdkbitmap mask.

`pixmap` :	a gtkpixmap.
`val` :	a gdkpixmap.
`mask` :	a gdkbitmap, which indicates which parts of the `pixmap` should be transparent. this can be null, in which case none of the `pixmap` is transparent.

gtk_pixmap_get ()

void        gtk_pixmap_get                  (gtkpixmap *pixmap,
                                             gdkpixmap **val,
                                             gdkbitmap **mask);

warning

gtk_pixmap_get is deprecated and should not be used in newly-written code.

gets the current gdkpixmap and gdkbitmap mask.

`pixmap` :	a gtkpixmap.
`val` :	returns the current gdkpixmap.
`mask` :	returns the current gdkbitmap mask.

gtk_pixmap_set_build_insensitive ()

void        gtk_pixmap_set_build_insensitive
                                            (gtkpixmap *pixmap,
                                             gboolean build);

warning

gtk_pixmap_set_build_insensitive is deprecated and should not be used in newly-written code.

sets wether an extra pixmap should be automatically created and used when the pixmap is insensitive. the default value is true.

`pixmap` :	a gtkpixmap.
`build` :	set to `true` if an extra pixmap should be automatically created to use when the pixmap is insensitive.