rb-dialog

## rb-dialog rb-dialog — helper functions for creating gtk+ dialog windows |

## Synopsis

    void                rb_error_dialog                     (GtkWindow *parent,
                                                             const char *primary,
                                                             const char *secondary,
                                                             ...);
    GtkWidget *         rb_file_chooser_new                 (const char *title,
                                                             GtkWindow *parent,
                                                             GtkFileChooserAction action,
                                                             gboolean local_only);

## 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.

## Details

### 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.

`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.

`title` : | title for the file chooser
`parent` : | parent GtkWindow for the file chooser
`action` : | the GtkFileChooserAction
`local_only` : | if TRUE, don't show network locations
Returns : | the file chooser GtkWidget