rb-dialog

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

Functions

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