| 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 role which will be set with
gtk_window_set_role().
|
parent : |
The parent widget 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-terminated va_list destribing 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 role which will be set with
gtk_window_set_role().
|
parent : |
The parent widget of this dialog or NULL.
|
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_list destribing 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 dialog to 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 |