GtkPixmap: GTK+ 2 Reference Manual

GtkPixmap

GtkPixmap — A widget displaying a graphical image or icon

Functions

GtkWidget *	gtk_pixmap_new ()
void	gtk_pixmap_set ()
void	gtk_pixmap_get ()
void	gtk_pixmap_set_build_insensitive ()

Types and Values

struct

GtkPixmap

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkObject
            ╰── GtkWidget
                ╰── GtkMisc
                    ╰── GtkPixmap

Implemented Interfaces

GtkPixmap implements AtkImplementorIface and GtkBuildable.

Includes

#include <gtk/gtk.h>

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.

Functions

gtk_pixmap_new ()

GtkWidget *
gtk_pixmap_new (GdkPixmap *pixmap,
                GdkBitmap *mask);

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.

Parameters

pixmap	a GDKPixmap.
mask	.	[allow-none]

Returns

a new GtkPixmap.

gtk_pixmap_set ()

void
gtk_pixmap_set (GtkPixmap *pixmap,
                GdkPixmap *val,
                GdkBitmap *mask);

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

Sets the GdkPixmap and GdkBitmap mask.

Parameters

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);

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

Gets the current GdkPixmap and GdkBitmap mask.

Parameters

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);

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.

Parameters

pixmap	a GtkPixmap.
build	set to `TRUE` if an extra pixmap should be automatically created to use when the pixmap is insensitive.

Types and Values

struct GtkPixmap

struct GtkPixmap;

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.