| GTK+ / Gnome Application Development | |||
|---|---|---|---|
| <<< Previous | Home | Next >>> | |
Here's a piece of code from the Gnome plot and chart component, Guppi. This is used for an "Open file" dialog. Future versions of Gnome will have a GnomeFileSelection widget, which would be more appropriate for this particular task than a custom dialog; but the example is nonetheless instructive.
GtkWidget * dialog;
dialog = gnome_dialog_new(_("Guppi: Open"),
GNOME_STOCK_BUTTON_OK,
GNOME_STOCK_BUTTON_CANCEL,
NULL);
gnome_dialog_set_close(GNOME_DIALOG(dialog), TRUE);
gnome_dialog_close_hides(GNOME_DIALOG(dialog), TRUE);
guppi_setup_dialog(dialog);
GtkWidget* fileentry =
gnome_file_entry_new("guppi:guppi_loadsave_history",
_("Guppi: Browse Files For Open"));
gnome_dialog_editable_enters(GNOME_DIALOG(dialog),
GTK_EDITABLE(gnome_file_entry_gtk_entry(GNOME_FILE_ENTRY(fileentry))));
gnome_dialog_set_default(GNOME_DIALOG(dialog), GNOME_OK);
gtk_box_pack_start(GTK_BOX(GNOME_DIALOG(dialog)->vbox),
fileentry,
TRUE, TRUE, GNOME_PAD);
gtk_widget_show_all(dialog);
int reply = gnome_dialog_run(GNOME_DIALOG(dialog));
if (reply == GNOME_OK)
{
gchar* s =
gnome_file_entry_get_full_path(GNOME_FILE_ENTRY(fileentry),
TRUE);
/* Application-specific details of actually
* loading the file omitted.
*/
}
gtk_widget_destroy(dialog);
|
gnome_dialog_set_close() is called, so this dialog will close if any of its buttons are clicked. However, closing the dialog only calls gtk_widget_hide(), rather than destroying it; gnome_dialog_close_hides() configures this behavior. guppi_setup_dialog() is a wrapper function that calls gnome_dialog_set_parent() to set the main application window as the dialog's parent.
Since the purpose of the dialog is to get a filename, it will be convenient to have the Enter key press the "OK" button; thus the "OK" button should be the default. However, the text entry box would normally steal the Enter key press; gnome_dialog_editable_enters() fixes the problem. gnome_dialog_run() waits for the user to take some action; if "OK" is clicked, we fetch the contents of the text entry and load the file. Note that the dialog is not destroyed after gnome_dialog_run() returns, because we called gnome_dialog_close_hides(). However, the dialog is closed after gnome_dialog_run() returns, because the code ensures that all user actions will close it (using gnome_dialog_set_close() and relying on the default behavior for the window manager's close button). Finally, gtk_widget_destroy() is necessary, since the dialog was not destroyed when it was closed.