GimpPaletteSelect: GIMP Library Reference Manual

Home

GimpPaletteSelect

GimpPaletteSelect — A button which pops up a palette select dialog.

Functions

GtkWidget * gimp_palette_select_button_new ()

const gchar * gimp_palette_select_button_get_palette ()

void gimp_palette_select_button_set_palette ()

Properties

gchar * palette-name Read / Write

gchar * title Read / Write / Construct Only

Signals

void palette-set Run First

Types and Values

GimpPaletteSelectButton

Object Hierarchy

 GObject
 ╰── GInitiallyUnowned
 ╰── GtkObject
 ╰── GtkWidget
 ╰── GtkContainer
 ╰── GtkBox
 ╰── GimpSelectButton
 ╰── GimpPaletteSelectButton

Implemented Interfaces

GimpPaletteSelectButton implements AtkImplementorIface, GtkBuildable and GtkOrientable.

Description

A button which pops up a palette select dialog.

Functions

gimp_palette_select_button_new ()

GtkWidget *
gimp_palette_select_button_new (const gchar *title,
 const gchar *palette_name);

Creates a new GtkWidget that completely controls the selection of a palette. This widget is suitable for placement in a table in a plug-in dialog.

Parameters

title

Title of the dialog to use or NULL to use the default title.

palette_name

Initial palette name.

Returns

A GtkWidget that you can use in your UI.

Since: 2.4

gimp_palette_select_button_get_palette ()

const gchar *
gimp_palette_select_button_get_palette
 (GimpPaletteSelectButton *button);

Retrieves the name of currently selected palette.

Parameters

button

A GimpPaletteSelectButton

Returns

an internal copy of the palette name which must not be freed.

Since: 2.4

gimp_palette_select_button_set_palette ()

void
gimp_palette_select_button_set_palette
 (GimpPaletteSelectButton *button,
 const gchar *palette_name);

Sets the current palette for the palette select button.

Parameters

button

A GimpPaletteSelectButton

palette_name

Palette name to set; NULL means no change.

Since: 2.4

Types and Values

GimpPaletteSelectButton

typedef struct _GimpPaletteSelectButton GimpPaletteSelectButton;

Property Details

The `"palette-name"` property

 "palette-name" gchar *

The name of the currently selected palette.

Owner: GimpPaletteSelectButton

Flags: Read / Write

Default value: NULL

Since: 2.4

The `"title"` property

 "title" gchar *

The title to be used for the palette selection popup dialog.

Owner: GimpPaletteSelectButton

Flags: Read / Write / Construct Only

Default value: "Palette Selection"

Since: 2.4

Signal Details

The `"palette-set"` signal

void
user_function (GimpPaletteSelectButton *widget,
 gchar *palette_name,
 gboolean dialog_closing,
 gpointer user_data)

The ::palette-set signal is emitted when the user selects a palette.

Parameters

widget

the object which received the signal.

palette_name

the name of the currently selected palette.

dialog_closing

whether the dialog was closed or not.

user_data

user data set when the signal handler was connected.

Flags: Run First

Since: 2.4

Generated by GTK-Doc V1.32