GNOME.org

GnomeDialog

GnomeDialog — Create generic dialog boxes.

Synopsis

#include <libgnomeui/libgnomeui.h>

struct              GnomeDialog;
GtkWidget *         gnome_dialog_new                    (const gchar *title,
                                                         ...);
GtkWidget *         gnome_dialog_newv                   (const gchar *title,
                                                         const gchar **buttons);
void                gnome_dialog_set_parent             (GnomeDialog *dialog,
                                                         GtkWindow *parent);
void                gnome_dialog_button_connect         (GnomeDialog *dialog,
                                                         gint button,
                                                         GCallback callback,
                                                         gpointer data);
void                gnome_dialog_button_connect_object  (GnomeDialog *dialog,
                                                         gint button,
                                                         GCallback callback,
                                                         GtkObject *obj);
gint                gnome_dialog_run                    (GnomeDialog *dialog);
gint                gnome_dialog_run_and_close          (GnomeDialog *dialog);
void                gnome_dialog_set_default            (GnomeDialog *dialog,
                                                         gint button);
void                gnome_dialog_grab_focus             (GnomeDialog *dialog,
                                                         gint button);
void                gnome_dialog_set_sensitive          (GnomeDialog *dialog,
                                                         gint button,
                                                         gboolean setting);
void                gnome_dialog_set_accelerator        (GnomeDialog *dialog,
                                                         gint button,
                                                         const guchar accelerator_key,
                                                         guint8 accelerator_mods);
void                gnome_dialog_close                  (GnomeDialog *dialog);
void                gnome_dialog_close_hides            (GnomeDialog *dialog,
                                                         gboolean just_hide);
void                gnome_dialog_set_close              (GnomeDialog *dialog,
                                                         gboolean click_closes);
void                gnome_dialog_editable_enters        (GnomeDialog *dialog,
                                                         GtkEditable *editable);
void                gnome_dialog_append_buttons         (GnomeDialog *dialog,
                                                         const gchar *first,
                                                         ...);
void                gnome_dialog_append_button          (GnomeDialog *dialog,
                                                         const gchar *button_name);
void                gnome_dialog_append_buttonsv        (GnomeDialog *dialog,
                                                         const gchar **buttons);
void                gnome_dialog_append_button_with_pixmap
                                                        (GnomeDialog *dialog,
                                                         const gchar *button_name,
                                                         const gchar *pixmap_name);
void                gnome_dialog_append_buttons_with_pixmaps
                                                        (GnomeDialog *dialog,
                                                         const gchar **names,
                                                         const gchar **pixmaps);
void                gnome_dialog_construct              (GnomeDialog *dialog,
                                                         const gchar *title,
                                                         va_list ap);
void                gnome_dialog_constructv             (GnomeDialog *dialog,
                                                         const gchar *title,
                                                         const gchar **buttons);
#define             GNOME_STOCK_BUTTON_OK
#define             GNOME_STOCK_BUTTON_CANCEL
#define             GNOME_STOCK_BUTTON_YES
#define             GNOME_STOCK_BUTTON_NO
#define             GNOME_STOCK_BUTTON_CLOSE
#define             GNOME_STOCK_BUTTON_APPLY
#define             GNOME_STOCK_BUTTON_HELP
#define             GNOME_STOCK_BUTTON_NEXT
#define             GNOME_STOCK_BUTTON_PREV
#define             GNOME_STOCK_BUTTON_UP
#define             GNOME_STOCK_BUTTON_DOWN
#define             GNOME_STOCK_BUTTON_FONT

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkWindow
                                       +----GnomeDialog
                                             +----GnomeMessageBox
                                             +----GnomePropertyBox

Implemented Interfaces

GnomeDialog implements AtkImplementorIface and GtkBuildable.

Signals

  "clicked"                                        : Run Last
  "close"                                          : Run Last

Description

Details

struct GnomeDialog

struct GnomeDialog {
  GtkWidget * vbox;
};

Warning

GnomeDialog is deprecated and should not be used in newly-written code.

Client code can pack widgets (for example, text or images) into vbox.

GtkWidget *vbox;

 The middle portion of the dialog box.

gnome_dialog_new ()

GtkWidget *         gnome_dialog_new                    (const gchar *title,
                                                         ...);

Warning

gnome_dialog_new is deprecated and should not be used in newly-written code.

gnome_dialog_newv ()

GtkWidget *         gnome_dialog_newv                   (const gchar *title,
                                                         const gchar **buttons);

Warning

gnome_dialog_newv is deprecated and should not be used in newly-written code.

gnome_dialog_set_parent ()

void                gnome_dialog_set_parent             (GnomeDialog *dialog,
                                                         GtkWindow *parent);

Warning

gnome_dialog_set_parent is deprecated and should not be used in newly-written code.

gnome_dialog_button_connect ()

void                gnome_dialog_button_connect         (GnomeDialog *dialog,
                                                         gint button,
                                                         GCallback callback,
                                                         gpointer data);

Warning

gnome_dialog_button_connect is deprecated and should not be used in newly-written code.

gnome_dialog_button_connect_object ()

void                gnome_dialog_button_connect_object  (GnomeDialog *dialog,
                                                         gint button,
                                                         GCallback callback,
                                                         GtkObject *obj);

Warning

gnome_dialog_button_connect_object is deprecated and should not be used in newly-written code.

gnome_dialog_run ()

gint                gnome_dialog_run                    (GnomeDialog *dialog);

Warning

gnome_dialog_run is deprecated and should not be used in newly-written code.

gnome_dialog_run_and_close ()

gint                gnome_dialog_run_and_close          (GnomeDialog *dialog);

Warning

gnome_dialog_run_and_close is deprecated and should not be used in newly-written code.

gnome_dialog_set_default ()

void                gnome_dialog_set_default            (GnomeDialog *dialog,
                                                         gint button);

Warning

gnome_dialog_set_default is deprecated and should not be used in newly-written code.

gnome_dialog_grab_focus ()

void                gnome_dialog_grab_focus             (GnomeDialog *dialog,
                                                         gint button);

Warning

gnome_dialog_grab_focus is deprecated and should not be used in newly-written code.

gnome_dialog_set_sensitive ()

void                gnome_dialog_set_sensitive          (GnomeDialog *dialog,
                                                         gint button,
                                                         gboolean setting);

Warning

gnome_dialog_set_sensitive is deprecated and should not be used in newly-written code.

gnome_dialog_set_accelerator ()

void                gnome_dialog_set_accelerator        (GnomeDialog *dialog,
                                                         gint button,
                                                         const guchar accelerator_key,
                                                         guint8 accelerator_mods);

Warning

gnome_dialog_set_accelerator is deprecated and should not be used in newly-written code.

Set an accelerator key for a button.

dialog :

 GnomeDialog to affect.

button :

 Button number.

accelerator_key :

 Key for the accelerator.

accelerator_mods :

 Modifier.

gnome_dialog_close ()

void                gnome_dialog_close                  (GnomeDialog *dialog);

Warning

gnome_dialog_close is deprecated and should not be used in newly-written code.

gnome_dialog_close_hides ()

void                gnome_dialog_close_hides            (GnomeDialog *dialog,
                                                         gboolean just_hide);

Warning

gnome_dialog_close_hides is deprecated and should not be used in newly-written code.

gnome_dialog_set_close ()

void                gnome_dialog_set_close              (GnomeDialog *dialog,
                                                         gboolean click_closes);

Warning

gnome_dialog_set_close is deprecated and should not be used in newly-written code.

gnome_dialog_editable_enters ()

void                gnome_dialog_editable_enters        (GnomeDialog *dialog,
                                                         GtkEditable *editable);

Warning

gnome_dialog_editable_enters is deprecated and should not be used in newly-written code.

gnome_dialog_append_buttons ()

void                gnome_dialog_append_buttons         (GnomeDialog *dialog,
                                                         const gchar *first,
                                                         ...);

Warning

gnome_dialog_append_buttons is deprecated and should not be used in newly-written code.

gnome_dialog_append_button ()

void                gnome_dialog_append_button          (GnomeDialog *dialog,
                                                         const gchar *button_name);

Warning

gnome_dialog_append_button is deprecated and should not be used in newly-written code.

Add a button to a dialog after its initial construction. This function is mostly for internal library use. You should use gnome_dialog_new() instead. See that function for a description of the button argument.

dialog :

 GnomeDialog to add button to.

button_name :

 Button to add.

gnome_dialog_append_buttonsv ()

void                gnome_dialog_append_buttonsv        (GnomeDialog *dialog,
                                                         const gchar **buttons);

Warning

gnome_dialog_append_buttonsv is deprecated and should not be used in newly-written code.

gnome_dialog_append_button_with_pixmap ()

void                gnome_dialog_append_button_with_pixmap
                                                        (GnomeDialog *dialog,
                                                         const gchar *button_name,
                                                         const gchar *pixmap_name);

Warning

gnome_dialog_append_button_with_pixmap is deprecated and should not be used in newly-written code.

Add a pixmap button to a dialog. gnome_dialog_new() does not permit custom buttons with pixmaps, so if you want one of those you need to use this function.

dialog :

 GnomeDialog to add the button to.

button_name :

 Name of the button, or stock button #define.

pixmap_name :

 Stock pixmap name.

gnome_dialog_append_buttons_with_pixmaps ()

void                gnome_dialog_append_buttons_with_pixmaps
                                                        (GnomeDialog *dialog,
                                                         const gchar **names,
                                                         const gchar **pixmaps);

Warning

gnome_dialog_append_buttons_with_pixmaps is deprecated and should not be used in newly-written code.

gnome_dialog_construct ()

void                gnome_dialog_construct              (GnomeDialog *dialog,
                                                         const gchar *title,
                                                         va_list ap);

Warning

gnome_dialog_construct is deprecated and should not be used in newly-written code.

gnome_dialog_constructv ()

void                gnome_dialog_constructv             (GnomeDialog *dialog,
                                                         const gchar *title,
                                                         const gchar **buttons);

Warning

gnome_dialog_constructv is deprecated and should not be used in newly-written code.

GNOME_STOCK_BUTTON_OK

#define GNOME_STOCK_BUTTON_OK     GTK_STOCK_OK

Warning

GNOME_STOCK_BUTTON_OK is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

GNOME_STOCK_BUTTON_CANCEL

#define GNOME_STOCK_BUTTON_CANCEL GTK_STOCK_CANCEL

Warning

GNOME_STOCK_BUTTON_CANCEL is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

GNOME_STOCK_BUTTON_YES

#define GNOME_STOCK_BUTTON_YES    GTK_STOCK_YES

Warning

GNOME_STOCK_BUTTON_YES is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

GNOME_STOCK_BUTTON_NO

#define GNOME_STOCK_BUTTON_NO     GTK_STOCK_NO

Warning

GNOME_STOCK_BUTTON_NO is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

GNOME_STOCK_BUTTON_CLOSE

#define GNOME_STOCK_BUTTON_CLOSE  GTK_STOCK_CLOSE

Warning

GNOME_STOCK_BUTTON_CLOSE is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

GNOME_STOCK_BUTTON_APPLY

#define GNOME_STOCK_BUTTON_APPLY  GTK_STOCK_APPLY

Warning

GNOME_STOCK_BUTTON_APPLY is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

GNOME_STOCK_BUTTON_HELP

#define GNOME_STOCK_BUTTON_HELP   GTK_STOCK_HELP

Warning

GNOME_STOCK_BUTTON_HELP is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

GNOME_STOCK_BUTTON_NEXT

#define GNOME_STOCK_BUTTON_NEXT   GTK_STOCK_GO_FORWARD

Warning

GNOME_STOCK_BUTTON_NEXT is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

GNOME_STOCK_BUTTON_PREV

#define GNOME_STOCK_BUTTON_PREV   GTK_STOCK_GO_BACK

Warning

GNOME_STOCK_BUTTON_PREV is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

GNOME_STOCK_BUTTON_UP

#define GNOME_STOCK_BUTTON_UP     GTK_STOCK_GO_UP

Warning

GNOME_STOCK_BUTTON_UP is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

GNOME_STOCK_BUTTON_DOWN

#define GNOME_STOCK_BUTTON_DOWN   GTK_STOCK_GO_DOWN

Warning

GNOME_STOCK_BUTTON_DOWN is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

GNOME_STOCK_BUTTON_FONT

#define GNOME_STOCK_BUTTON_FONT   GTK_STOCK_SELECT_FONT

Warning

GNOME_STOCK_BUTTON_FONT is deprecated and should not be used in newly-written code.

This button has been replaced by one in GTK+ and new code should use that.

Signal Details

The "clicked" signal

void                user_function                      (GnomeDialog *dialog,
                                                        gint         arg1,
                                                        gpointer     user_data)      : Run Last

dialog :

 the object which received the signal.

user_data :

 user data set when the signal handler was connected.

The "close" signal

gboolean            user_function                      (GnomeDialog *dialog,
                                                        gpointer     user_data)      : Run Last

dialog :

 the object which received the signal.

user_data :

 user data set when the signal handler was connected.
Generated by GTK-Doc V1.16