GimpDialog3LIBGIMPWIDGETS LibraryGimpDialogConstructors for GtkDialog's and action_areas as well as other
dialog-related stuff.Synopsis
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);
GtkWidget* gimp_dialog_add_button (GimpDialog *dialog,
const gchar *button_text,
gint response_id);
void gimp_dialog_add_buttons (GimpDialog *dialog,
...);
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);
Object Hierarchy
GObject
+----GInitiallyUnowned
+----GtkObject
+----GtkWidget
+----GtkContainer
+----GtkBin
+----GtkWindow
+----GtkDialog
+----GimpDialog
Implemented Interfaces
GimpDialog implements
AtkImplementorIface.Properties
"help-func" gpointer : Read / Write / Construct Only
"help-id" gchararray : Read / Write / Construct Only
DescriptionDetails<anchor id="GimpDialog-struct" role="struct"/>GimpDialogGimpDialogtypedef struct _GimpDialog GimpDialog;<anchor id="gimp-dialog-new" role="function"/>gimp_dialog_new ()gimp_dialog_newGtkWidget* 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.
<anchor id="gimp-dialog-new-valist" role="function"/>gimp_dialog_new_valist ()gimp_dialog_new_valistGtkWidget* 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.
<anchor id="gimp-dialog-add-button" role="function"/>gimp_dialog_add_button ()gimp_dialog_add_buttonGtkWidget* gimp_dialog_add_button (GimpDialog *dialog,
const gchar *button_text,
gint response_id);
This function is essentially the same as gtk_dialog_add_button()
except it ensures there is only one help button and automatically
sets the RESPONSE_OK widget as the default response.dialog : The dialog to add a button to.
button_text : text of button, or stock ID.
response_id : response ID for the button.
Returns : the button widget that was added.
<anchor id="gimp-dialog-add-buttons" role="function"/>gimp_dialog_add_buttons ()gimp_dialog_add_buttonsvoid gimp_dialog_add_buttons (GimpDialog *dialog,
...);
This function is essentially the same as gtk_dialog_add_buttons()
except it calls gimp_dialog_add_button() instead of gtk_dialog_add_button()dialog : The dialog to add buttons to.
... : button_text-response_id pairs.
<anchor id="gimp-dialog-add-buttons-valist" role="function"/>gimp_dialog_add_buttons_valist ()gimp_dialog_add_buttons_valistvoid gimp_dialog_add_buttons_valist (GimpDialog *dialog,
va_list args);
This function is essentially the same as gimp_dialog_add_buttons()
except it takes a va_list instead of '...'dialog : The dialog to add buttons to.
args : The buttons as va_list.
<anchor id="gimp-dialog-run" role="function"/>gimp_dialog_run ()gimp_dialog_rungint 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 GimpDialogReturns : response ID
<anchor id="gimp-dialogs-show-help-button" role="function" condition="since:GIMP 2.2"/>gimp_dialogs_show_help_button ()gimp_dialogs_show_help_buttonvoid gimp_dialogs_show_help_button (gboolean show);
This function is for internal use only.show : whether a help button should be added when creating a GimpDialog
Since GIMP 2.2
Property Details<anchor id="GimpDialog--help-func"/>The "<literal>help-func</literal>" propertyGimpDialog:help-func "help-func" gpointer : Read / Write / Construct Only<anchor id="GimpDialog--help-id"/>The "<literal>help-id</literal>" propertyGimpDialog:help-id "help-id" gchararray : Read / Write / Construct OnlyDefault value: NULL