Top |
Description
This provides a couple of shortcuts for creating dialogs. If you want to annoy the user by displaying an error message, this is the way to do it.
Functions
rb_error_dialog ()
void rb_error_dialog (GtkWindow *parent
,const char *primary
,const char *secondary
,...
);
Creates and displays a simple error dialog box containing a primary message in bold, larger type and a secondary message in the regular font. Both the primary and secondary message strings should be translated.
Care should be taken to avoid opening multiple error dialog boxes when a single error message (such as 'out of disk space') affects multiple items.
Parameters
parent |
parent GtkWindow for the dialog |
|
primary |
main error message |
|
secondary |
secondary error message (printf-style format string) |
|
... |
any substitution values for the secondary message |
rb_file_chooser_new ()
GtkWidget * rb_file_chooser_new (const char *title
,GtkWindow *parent
,GtkFileChooserAction action
,gboolean local_only
);
Creates and shows a regular gtk+ file chooser dialog with a given title. The user's music directory (typically ~/Music) is added as a shortcut.
For consistency, this should be used anywhere a file chooser is required.
After creating the dialog, the caller should connect a handler to its 'response' signal to process the user's selected files or folders.
Parameters
title |
title for the file chooser |
|
parent |
parent GtkWindow for the file chooser |
|
action |
||
local_only |
if TRUE, don't show network locations |