## GtkPixmap

GtkPixmap — a widget displaying a graphical image or icon.

## Synopsis

    #include <gtk/gtk.h>

    struct      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
       +----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.

## Details

### struct GtkPixmap

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