![]() | ![]() | ![]() | GIMP Widgets Library Reference Manual | ![]() |
---|
GimpDialog — Constructors for GtkDialog's and action_areas as well as other dialog-related stuff.
struct GimpDialog; GtkWidget* gimp_dialog_new (const gchar *title, const gchar *wmclass_name, GimpHelpFunc help_func, const gchar *help_id, GtkWindowPosition position, gint allow_shrink, gint allow_grow, gint auto_shrink, ...); GtkWidget* gimp_dialog_newv (const gchar *title, const gchar *wmclass_name, GimpHelpFunc help_func, const gchar *help_id, 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 AtkImplementorIface.
GtkWidget* gimp_dialog_new (const gchar *title, const gchar *wmclass_name, GimpHelpFunc help_func, const gchar *help_id, 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 gtk_window_set_title(). |
wmclass_name : | The dialog's wmclass_name which will be set with gtk_window_set_wmclass(). The wmclass_class will be automatically set to "Gimp". |
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. |
position : | The dialog's initial position which will be set with gtk_window_set_position(). |
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 gtk_window_set_policy(). |
... : | A NULL-terminated va_list destribing the action_area buttons. |
Returns : | A GimpDialog. |
GtkWidget* gimp_dialog_newv (const gchar *title, const gchar *wmclass_name, GimpHelpFunc help_func, const gchar *help_id, 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 gtk_window_set_title(). |
wmclass_name : | The dialog's wmclass_name which will be set with gtk_window_set_wmclass(). The wmclass_class will be automatically set to "Gimp". |
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. |
position : | The dialog's initial position which will be set with gtk_window_set_position(). |
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 gtk_window_set_policy(). |
args : | A va_list as obtained with va_start() describing the action_area buttons. |
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 GtkButton's has the following format:
gchar *label, | The button's label. |
GtkSignalFunc callback, | The callback which will be connected to the button's "clicked" signal |
gpointer data, | The callback data which will be used in gtk_signal_connect(). If you pass NULL, then the dialog itself will by passed as data. |
GtkObject *slot_object, | If you pass a pointer other than NULL, then the button's "clicked" signal will be connected with gtk_signal_connect_object() instead of gtk_signal_connect(). If you want the dialog itself to be the slot_object, pass "1". |
GtkWidget **widget_ptr, | A pointer to store the created button in. |
gboolean default_action, | TRUE if this button should grab the default dialog action with gtk_widget_grab_default(). |
gboolean connect_delete, | TRUE if the dialog's "delete_event" should be connected to this button's callback. Usually you will connect to the dialog's "Cancel" callback. Note that the callback will be called indirectly, so you don't have to worry about the GdkEvent pointer which comes with the "delete_event", as it will be stripped away before your "Cancel" callback is called. |
dialog : | The GimpDialog you want to create the action_area for. |
args : | A va_list as obtained with va_start() describing the action_area buttons. |
<< GimpColorScale | GimpFileSelection >> |