Rhythmbox Development Reference Manual: rb-dialog

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

## Functions

void | rb_error_dialog ()
GtkWidget * | rb_file_chooser_new ()

## 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 | the GtkFileChooserAction |
local_only | if TRUE, don't show network locations |

#### Returns

the file chooser GtkWidget.

[transfer full]

## Types and Values