## 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 and GtkBuildable.

## 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 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.