RB.SongInfo

g Atk.ImplementorIface Atk.ImplementorIface Gtk.Widget Gtk.Widget Atk.ImplementorIface->Gtk.Widget GObject.GInterface GObject.GInterface GObject.GInterface->Atk.ImplementorIface Gtk.Buildable Gtk.Buildable GObject.GInterface->Gtk.Buildable GObject.InitiallyUnowned GObject.InitiallyUnowned GObject.InitiallyUnowned->Gtk.Widget GObject.Object GObject.Object GObject.Object->GObject.InitiallyUnowned Gtk.Bin Gtk.Bin Gtk.Window Gtk.Window Gtk.Bin->Gtk.Window Gtk.Buildable->Gtk.Widget Gtk.Container Gtk.Container Gtk.Container->Gtk.Bin Gtk.Dialog Gtk.Dialog RB.SongInfo RB.SongInfo Gtk.Dialog->RB.SongInfo Gtk.Widget->Gtk.Container Gtk.Window->Gtk.Dialog

Subclasses:None

Properties

Inherited:Gtk.Dialog (1), Gtk.Window (33), Gtk.Container (3), Gtk.Widget (39)
Name Type Flags Short Description
current-entry RB.RhythmDBEntry r RB.RhythmDBEntry object
entry-view RB.EntryView r/w/co RB.EntryView object
selected-entries GLib.Array r List of selected entries, if this is a multiple-entry dialog
source RB.Source r/w/co RB.Source object

Style Properties

Inherited:Gtk.Dialog (4), Gtk.Window (2), Gtk.Widget (17)

Signals

Inherited:Gtk.Dialog (2), Gtk.Window (5), Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)
Name Short Description
post-metadata-change Emitted just after changes have been applied to the database.
pre-metadata-change Emitted just before the changes made in the song properties window are applied to the database.

Fields

Inherited:Gtk.Dialog (2), Gtk.Window (5), Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)
Name Type Access Description
parent Gtk.Dialog r  

Class Details

class RB.SongInfo(*args, **kwargs)
Bases:Gtk.Dialog
Abstract:No
Structure:RB.SongInfoClass
classmethod new(source, entry_view)
Parameters:
Returns:

the new song properties window

Return type:

Gtk.Widget

Creates a new RB.SongInfo for the selected entry or entries in the specified entry view.

append_page(title, page)
Parameters:
Returns:

the page number

Return type:

int

Adds a new page to the song properties window. Should be called in a handler connected to the RB.Shell ‘create-song-info’ signal.

do_post_metadata_change(entry) virtual
Parameters:entry (RB.RhythmDBEntry) –
do_pre_metadata_change(entry) virtual
Parameters:entry (RB.RhythmDBEntry) –

Signal Details

RB.SongInfo.signals.post_metadata_change(song_info, entry)
Signal Name:

post-metadata-change

Flags:

RUN_LAST

Parameters:

Emitted just after changes have been applied to the database. Probably useless.

RB.SongInfo.signals.pre_metadata_change(song_info, entry)
Signal Name:

pre-metadata-change

Flags:

RUN_LAST

Parameters:

Emitted just before the changes made in the song properties window are applied to the database. This is only emitted in the single-entry case.

Property Details

RB.SongInfo.props.current_entry
Name:current-entry
Type:RB.RhythmDBEntry
Default Value:None
Flags:READABLE

The RB.RhythmDBEntry that is currently being displayed. Will be None for multiple-entry song properties windows.

RB.SongInfo.props.entry_view
Name:entry-view
Type:RB.EntryView
Default Value:None
Flags:READABLE, WRITABLE, CONSTRUCT_ONLY

The RB.EntryView for the source that created the song properties window. Used find the set of selected entries, and to change the selection when the ‘back’ and ‘forward’ buttons are pressed.

RB.SongInfo.props.selected_entries
Name:selected-entries
Type:GLib.Array
Default Value:None
Flags:READABLE

The set of RB.RhythmDBEntry objects currently being displayed. Valid for both single-entry and multiple-entry song properties windows.

RB.SongInfo.props.source
Name:source
Type:RB.Source
Default Value:None
Flags:READABLE, WRITABLE, CONSTRUCT_ONLY

The RB.Source that created the song properties window. Used to update for track list changes, and to find the sets of albums, artist, and genres to use for tag edit completion.