GimpPatternSelectButton

GimpPatternSelectButton — A button which pops up a pattern select dialog.

Functions

Properties

char * pattern-name Read / Write
char * title Read / Write / Construct Only

Signals

void pattern-set Run First

Types and Values

Object Hierarchy

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

Implemented Interfaces

GimpPatternSelectButton implements AtkImplementorIface, GtkBuildable and GtkOrientable.

Description

A button which pops up a pattern select dialog.

Functions

gimp_pattern_select_button_new ()

GtkWidget *
gimp_pattern_select_button_new (const gchar *title,
                                const gchar *pattern_name);

Creates a new GtkWidget that completely controls the selection of a pattern. 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.

 

pattern_name

Initial pattern name or NULL to use current selection.

 

Returns

A GtkWidget that you can use in your UI.

Since: 2.4


gimp_pattern_select_button_get_pattern ()

const gchar *
gimp_pattern_select_button_get_pattern
                               (GimpPatternSelectButton *button);

Retrieves the name of currently selected pattern.

Parameters

Returns

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

Since: 2.4


gimp_pattern_select_button_set_pattern ()

void
gimp_pattern_select_button_set_pattern
                               (GimpPatternSelectButton *button,
                                const gchar *pattern_name);

Sets the current pattern for the pattern select button.

Parameters

button

A GimpPatternSelectButton

 

pattern_name

Pattern name to set; NULL means no change.

 

Since: 2.4

Types and Values

GimpPatternSelectButton

typedef struct _GimpPatternSelectButton GimpPatternSelectButton;

Property Details

The “pattern-name” property

  “pattern-name”             char *

The name of the currently selected pattern.

Owner: GimpPatternSelectButton

Flags: Read / Write

Default value: NULL

Since: 2.4


The “title” property

  “title”                    char *

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

Owner: GimpPatternSelectButton

Flags: Read / Write / Construct Only

Default value: "Pattern Selection"

Since: 2.4

Signal Details

The “pattern-set” signal

void
user_function (GimpPatternSelectButton *widget,
               char                    *pattern_name,
               int                      width,
               int                      height,
               int                      bpp,
               gpointer                 mask_data,
               gboolean                 dialog_closing,
               gpointer                 user_data)

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

Parameters

widget

the object which received the signal.

 

pattern_name

the name of the currently selected pattern.

 

width

width of the pattern

 

height

height of the pattern

 

bpp

bpp of the pattern

 

mask_data

pattern mask data

 

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