| GIMP Widgets Library Reference Manual |
|---|
GimpDialog — Constructors for
struct GimpDialog;GtkWidget * gimp_dialog_new (constgchar *title, constgchar *wmclass_name, GimpHelpFunc help_func, constgchar *help_data,GtkWindowPosition position,gint allow_shrink,gint allow_grow,gint auto_shrink, ...);GtkWidget * gimp_dialog_newv (constgchar *title, constgchar *wmclass_name, GimpHelpFunc help_func, constgchar *help_data,GtkWindowPosition position,gint allow_shrink,gint allow_grow,gint auto_shrink, va_list args); void gimp_dialog_create_action_area (GimpDialog *dialog, ...); void gimp_dialog_create_action_areav (GimpDialog *dialog, va_list args);
GObject +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkWindow +----GtkDialog +----GimpDialog
GimpDialog implements
GtkWidget * gimp_dialog_new (constgchar *title, constgchar *wmclass_name, GimpHelpFunc help_func, constgchar *help_data,GtkWindowPosition position,gint allow_shrink,gint allow_grow,gint auto_shrink, ...);
This function simply packs the action_area arguments passed in "..." into a va_list variable and passes everything to gimp_dialog_newv().
For a description of the format of the va_list describing the action_area buttons see gimp_dialog_create_action_areav().
| title : | The dialog's title which will be set with
|
| wmclass_name : | The dialog's wmclass_name which will be set with
|
| help_func : | The function which will be called if the user presses "F1". |
| help_data : | The data pointer which will be passed to help_func. |
| position : | The dialog's initial position which will be set with
|
| allow_shrink : | The dialog's allow_shrink flag, ... |
| allow_grow : | ... it't allow_grow flag and ... |
| auto_shrink : | ... it's auto_shrink flag which will all be set with
|
| ... : | A NULL-terminated va_list destribing the action_area buttons. |
| Returns : | A GimpDialog. |
GtkWidget * gimp_dialog_newv (constgchar *title, constgchar *wmclass_name, GimpHelpFunc help_func, constgchar *help_data,GtkWindowPosition position,gint allow_shrink,gint allow_grow,gint auto_shrink, va_list args);
This function performs all neccessary setps to set up a standard GIMP dialog.
The va_list describing the action_area buttons will be passed to gimp_dialog_create_action_areav().
| title : | The dialog's title which will be set with
|
| wmclass_name : | The dialog's wmclass_name which will be set with
|
| help_func : | The function which will be called if the user presses "F1". |
| help_data : | The data pointer which will be passed to help_func. |
| position : | The dialog's initial position which will be set with
|
| allow_shrink : | The dialog's allow_shrink flag, ... |
| allow_grow : | ... it't allow_grow flag and ... |
| auto_shrink : | ... it's auto_shrink flag which will all be set with
|
| args : | A va_list as obtained with |
| Returns : | A GimpDialog. |
void gimp_dialog_create_action_area (GimpDialog *dialog, ...);
This function simply packs the action_area arguments passed in "..." into a va_list variable and passes everything to gimp_dialog_create_action_areav().
| dialog : | The GimpDialog you want to create the action_area for. |
| ... : | A NULL-terminated va_list destribing the action_area buttons. |
void gimp_dialog_create_action_areav (GimpDialog *dialog, va_list args);
This function creates the action area of a GimpDialog. You will rarely need to call it directly. Instead use gimp_dialog_new() or its variants.
The va_list describing the action_area
| The button's label. | |
| The callback which will be connected to the button's "clicked" signal | |
| The callback data which will be used in
| |
| If you pass a pointer other than | |
| A pointer to store the created button in. | |
| dialog : | The GimpDialog you want to create the action_area for. |
| args : | A va_list as obtained with |
| << GimpUnitMenu | Display Filters >> |