HildonDialog

HildonDialog — A popup window in the Hildon framework.

Synopsis


#include <hildon/hildon.h>

                    HildonDialog;
GtkWidget*          hildon_dialog_new                   (void);
GtkWidget*          hildon_dialog_new_with_buttons      (const gchar *title,
                                                         GtkWindow *parent,
                                                         GtkDialogFlags flags,
                                                         const gchar *first_button_text,
                                                         ...);
GtkWidget*          hildon_dialog_add_button            (HildonDialog *dialog,
                                                         const gchar *button_text,
                                                         gint response_id);
void                hildon_dialog_add_buttons           (HildonDialog *dialog,
                                                         const gchar *first_button_text,
                                                         ...);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkWindow
                                       +----GtkDialog
                                             +----HildonDialog
                                                   +----HildonPickerDialog

Implemented Interfaces

HildonDialog implements AtkImplementorIface and GtkBuildable.

Description

HildonDialog is a popup window in the Hildon framework. It is derived from GtkDialog and provides additional commodities specific to the Hildon framework.

As of hildon 2.2, HildonDialog has been deprecated in favor of GtkDialog.

Note

HildonDialog has been deprecated since Hildon 2.2 and should not be used in newly written code. See Migrating Hildon Dialogs section to know how to migrate this deprecated widget.

Example 27. Simple HildonDialog usage

void quick_message (gchar *message)
{

    GtkWidget *dialog, *label;

    dialog = hildon_dialog_new ();
    label = gtk_label_new (message);

    g_signal_connect_swapped (dialog,
                              "response",
                              G_CALLBACK (gtk_widget_destroy),
                              dialog);

    gtk_container_add (GTK_CONTAINER (GTK_DIALOG(dialog)->vbox),
                       label);
    gtk_widget_show_all (dialog);

}


Details

HildonDialog

typedef struct _HildonDialog HildonDialog;

Warning

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


hildon_dialog_new ()

GtkWidget*          hildon_dialog_new                   (void);

Warning

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

Creates a new HildonDialog widget

Returns : the newly created HildonDialog

Since 2.2


hildon_dialog_new_with_buttons ()

GtkWidget*          hildon_dialog_new_with_buttons      (const gchar *title,
                                                         GtkWindow *parent,
                                                         GtkDialogFlags flags,
                                                         const gchar *first_button_text,
                                                         ...);

Warning

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

Creates a new HildonDialog. See gtk_dialog_new_with_buttons() for more information.

title : Title of the dialog, or NULL
parent : Transient parent of the dialog, or NULL
flags : from GtkDialogFlags
first_button_text : stock ID or text to go in first button, or NULL
... : response ID for first button, then additional buttons, ending with NULL
Returns : a new HildonDialog

Since 2.2


hildon_dialog_add_button ()

GtkWidget*          hildon_dialog_add_button            (HildonDialog *dialog,
                                                         const gchar *button_text,
                                                         gint response_id);

Warning

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

Adds a button to the dialog. Works exactly like gtk_dialog_add_button(), the only difference being that the button has finger size.

dialog : a HildonDialog
button_text : text of the button, or stock ID
response_id : response ID for the button.
Returns : the button widget that was added

Since 2.2


hildon_dialog_add_buttons ()

void                hildon_dialog_add_buttons           (HildonDialog *dialog,
                                                         const gchar *first_button_text,
                                                         ...);

Warning

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

Adds several buttons to the dialog. Works exactly like gtk_dialog_add_buttons(), the only difference being that the buttons have finger size.

dialog : a HildonDialog
first_button_text : text of the button, or stock ID
... : response ID for first button, then more text-response_id pairs

Since 2.2

See Also

HildonCodeDialog, HildonColorChooserDialog, HildonFontSelectionDialog, HildonGetPasswordDialog, HildonLoginDialog, HildonSetPasswordDialog, HildonSortDialog, HildonWizardDialog