## gtk_shadeComboBoxWidget

gtk_shadeComboBoxWidget —

## Synopsis

    GtkWidget*  shadeComboBox_new               (gboolean hasAlphaChannel);
    Shade*      shadeComboBoxGet_selectedShade  (ShadeComboBox *shadeComboBox);
    GdkPixbuf*  shadeComboBoxGet_pixbufFromShade
                                                (ShadeComboBox *shadeComboBox,
                                                 Shade *shade);
    gboolean    shadeComboBoxSet_selectionByShade
                                                (ShadeComboBox *shadeComboBox,
                                                 Shade *shade);
    GdkPixbuf*  shadeComboBoxBuild_shadeStamp   (Shade *shade,
                                                 GdkPixbuf *pixbuf);

## Description

## Details

### shadeComboBox_new ()

    GtkWidget*  shadeComboBox_new               (gboolean hasAlphaChannel);

A ShadeComboBox widget is like a GtkComboBox widget, but it is already filled with the known shades. Using this widget is a convienient way to share shades between all part of V_Sim and to give a consistent look of all shade selection. If the argument `hasAlphaChannel` is FALSE, the widget display all shades but without their alpha channel, assuming it to be fully opaque.

`hasAlphaChannel` : | a boolean.
Returns : | a newly created ShadeComboBox widget.

### shadeComboBoxGet_selectedShade ()

    Shade*      shadeComboBoxGet_selectedShade  (ShadeComboBox *shadeComboBox);

The user can access to the selected Shade object using this method.

`shadeComboBox` : | a ShadeComboBox widget.
Returns : | a pointer to the selected Shade object (or NULL). This object is read-only.

### shadeComboBoxGet_pixbufFromShade ()

    GdkPixbuf*  shadeComboBoxGet_pixbufFromShade
                                                (ShadeComboBox *shadeComboBox,
                                                 Shade *shade);

The `shadeComboBox` has little pixbufs to represent the shade. User methods can use these pixbufs but should considered them read-only.

`shadeComboBox` : | a ShadeComboBox widget ;
`shade` : | a Shade object.
Returns : | a pixbuf pointer corresponding to the little image shown on the `shadeComboBox`.

### shadeComboBoxSet_selectionByShade ()

    gboolean    shadeComboBoxSet_selectionByShade
                                                (ShadeComboBox *shadeComboBox,
                                                 Shade *shade);

Use this method to set the ComboBox on the given shade. This emits a 'shade-channel' signal if the shade is changed, which means, a previous shade has been modified, or a new shade is selected.

`shadeComboBox` : | a ShadeComboBox widget ;
`shade` : | a Shade object.
Returns : | TRUE if the `shade` already exists in the model.

### shadeComboBoxBuild_shadeStamp ()

    GdkPixbuf*  shadeComboBoxBuild_shadeStamp   (Shade *shade,
                                                 GdkPixbuf *pixbuf);

`shade` : |
`pixbuf` : |
Returns : |