Gtk-- Reference: Gtk::Pixmap

Class Index | Cross Index | Namespace Index

# Class Gtk::Pixmap

A widget displaying a graphical image or icon.
Contained in: Gtk
Derived from: Gtk::Misc
Derived by: none

#include <gtk--/pixmap.h>

### public function member index:
`` | `Pixmap` | `()`;
`` | `Pixmap` | `(`const` `nstring`& `xpmfilename`)`;
`` | `Pixmap` | `(`const` `gchar`* `const`* `data`)`;
`` | `Pixmap` | `(`const` `Gdk_Pixmap`& `pixmap`, `const` `Gdk_Bitmap`& `mask`)`;
``void`` | `get` | `(`Gdk_Pixmap`& `pixmap`, `Gdk_Bitmap`& `mask`) `const``;
``GtkPixmap`*` | `gtkobj` | `()`;
``const` `GtkPixmap`*` | `gtkobj` | `() `const``;
``static` `bool`` | `isA` | `(`Object`* `object`)`;
``void`` | `set` | `(`const` `Gdk_Pixmap`& `pixmap`, `const` `Gdk_Bitmap`& `mask`)`;
``void`` | `set` | `(`const` `gchar`* `const`* `data`)`;
``void`` | `set` | `(`const` `string`& `xpmfilename`)`;
``void`` | `set_build_insensitive` | `(`bool` `build`)`;
``virtual`` | `~Pixmap` | `()`;
### protected function member index:
``void`` | `load_xpm` | `()`;
``virtual` `void`` | `realize_impl` | `()`;
``void`` | `unset` | `()`;

## Description:

The `Gtk::Pixmap` widget displays a graphical image or icon.

The pixels in a `Gtk::Pixmap` 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 `Gtk::Image` and `Gdk::RGB`.

## Function Member Descriptions:

Gtk::Pixmap::Pixmap - Construct an empty pixmap.

`` `Pixmap``()`;

> Note that default constructor puts Pixmap objects to invalid state and you should not show it or add it to containers before you've set() the pixmap and mask for it.

Gtk::Pixmap::Pixmap - Load a pixmap form file.

`` `Pixmap``(`const` `nstring`& `xpmfilename`)`;
Gtk::Pixmap::Pixmap - Create a pixmap from data.

`` `Pixmap``(`const` `gchar`* `const`* `data`)`;

> data must live until Pixmap is realized

Gtk::Pixmap::Pixmap - Create using specified ``pixmap`` and ``mask``.

`` `Pixmap``(`const` `Gdk_Pixmap`& `pixmap`, `const` `Gdk_Bitmap`& `mask`)`;
Gtk::Pixmap::get - Get the ``pixmap`` and border ``mask``.

``void`` `get``(`Gdk_Pixmap`& `pixmap`, `Gdk_Bitmap`& `mask`) `const``;

> works only following realization.

Gtk::Pixmap::gtkobj - Returns the underlaying gtk+ object.

``GtkPixmap`*` `gtkobj``()`;
Gtk::Pixmap::isA - Returns true if object is this type.

``static` `bool`` `isA``(`Object`* `object`)`;
Gtk::Pixmap::set - Set the ``pixmap`` and border ``mask``.

``void`` `set``(`const` `Gdk_Pixmap`& `pixmap`, `const` `Gdk_Bitmap`& `mask`)`;
Gtk::Pixmap::set_build_insensitive - (Gtk 1.1) Build an special pixmap for insensitive states.

``void`` `set_build_insensitive``(`bool` `build`)`;

> Setting this switch will cause Gtk to build a greyed out version on the specified ``pixmap``.

## Variable Member Descriptions: