|  |  |  | GIMP Widgets Library Reference Manual |  | 
|---|---|---|---|---|
| GimpDialogGimpDialog — Constructors for GtkDialog's and action_areas as well as other dialog-related stuff. | 
            GimpDialog;
GtkWidget*  gimp_dialog_new                 (const gchar *title,
                                             const gchar *role,
                                             GtkWidget *parent,
                                             GtkDialogFlags flags,
                                             GimpHelpFunc help_func,
                                             const gchar *help_id,
                                             ...);
GtkWidget*  gimp_dialog_new_valist          (const gchar *title,
                                             const gchar *role,
                                             GtkWidget *parent,
                                             GtkDialogFlags flags,
                                             GimpHelpFunc help_func,
                                             const gchar *help_id,
                                             va_list args);
void        gimp_dialog_add_buttons_valist  (GimpDialog *dialog,
                                             va_list args);
gint        gimp_dialog_run                 (GimpDialog *dialog);
void        gimp_dialogs_show_help_button   (gboolean show);
  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkWindow
                                       +----GtkDialog
                                             +----GimpDialog
"help-func" gpointer : Read / Write / Construct Only "help-id" gchararray : Read / Write / Construct Only
GtkWidget*  gimp_dialog_new                 (const gchar *title,
                                             const gchar *role,
                                             GtkWidget *parent,
                                             GtkDialogFlags flags,
                                             GimpHelpFunc help_func,
                                             const gchar *help_id,
                                             ...);
Creates a new GimpDialog widget.
This function simply packs the action_area arguments passed in "..."
into a va_list variable and passes everything to gimp_dialog_new_valist().
For a description of the format of the va_list describing the
action_area buttons see gtk_dialog_new_with_buttons().
| title: | The dialog's title which will be set with gtk_window_set_title(). | 
| role: | The dialog's rolewhich will be set withgtk_window_set_role(). | 
| parent: | The parentwidget of this dialog. | 
| flags: | The flags(see the GtkDialog documentation). | 
| help_func: | The function which will be called if the user presses "F1". | 
| help_id: | The help_id which will be passed to help_func. | 
| ...: | A NULL-terminatedva_listdestribing the
               action_area buttons. | 
| Returns : | A GimpDialog. | 
GtkWidget*  gimp_dialog_new_valist          (const gchar *title,
                                             const gchar *role,
                                             GtkWidget *parent,
                                             GtkDialogFlags flags,
                                             GimpHelpFunc help_func,
                                             const gchar *help_id,
                                             va_list args);
Creates a new GimpDialog widget. If a GtkWindow is specified as
parent then the dialog will be made transient for this window.
For a description of the format of the va_list describing the
action_area buttons see gtk_dialog_new_with_buttons().
| title: | The dialog's title which will be set with gtk_window_set_title(). | 
| role: | The dialog's rolewhich will be set withgtk_window_set_role(). | 
| parent: | The parentwidget of this dialog orNULL. | 
| flags: | The flags(see the GtkDialog documentation). | 
| help_func: | The function which will be called if the user presses "F1". | 
| help_id: | The help_id which will be passed to help_func. | 
| args: | A va_listdestribing the action_area buttons. | 
| Returns : | A GimpDialog. | 
void gimp_dialog_add_buttons_valist (GimpDialog *dialog, va_list args);
This function is essentially the same as gtk_dialog_add_buttons()
except it takes a va_list instead of '...'
| dialog: | The dialogto add buttons to. | 
| args: | The buttons as va_list. | 
gint gimp_dialog_run (GimpDialog *dialog);
This function does exactly the same as gtk_dialog_run() except it
does not make the dialog modal while the GMainLoop is running.
| dialog: | a GimpDialog | 
| Returns : | response ID |