Package com.tagtraum.beatunes.action.standard

Class NewPlayListFromSelectionAction

java.lang.Object

javax.swing.AbstractAction

com.tagtraum.core.app.ApplicationAction

com.tagtraum.beatunes.action.BaseAction

com.tagtraum.beatunes.action.standard.NewPlayListAction

com.tagtraum.beatunes.action.standard.NewPlayListFromSelectionAction

All Implemented Interfaces:

ApplicationComponent<BeaTunes>, ActionListener, Serializable, Cloneable, EventListener, Action

public class NewPlayListFromSelectionAction
extends NewPlayListAction

New playlist from selected songs action.

Author:

Hendrik Schreiber

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.tagtraum.beatunes.action.BaseAction

BaseAction.EnabledView, BaseAction.Location, BaseAction.SelectionCount

Nested classes/interfaces inherited from class com.tagtraum.core.app.ApplicationAction

ApplicationAction.ApplicationActionFacade

Field Summary

Fields inherited from class com.tagtraum.beatunes.action.BaseAction

ITEMS_EDITABLE

Fields inherited from class com.tagtraum.core.app.ApplicationAction

BUTTON_MODEL, DISABLED_ICON, DISABLED_SELECTED_ICON, PRESSED_ICON, ROLLOVER_ICON, SELECTED_ICON, SHORT_NAME

Fields inherited from class javax.swing.AbstractAction

changeSupport, enabled

Fields inherited from interface javax.swing.Action

ACCELERATOR_KEY, ACTION_COMMAND_KEY, DEFAULT, DISPLAYED_MNEMONIC_INDEX_KEY, LARGE_ICON_KEY, LONG_DESCRIPTION, MNEMONIC_KEY, NAME, SELECTED_KEY, SHORT_DESCRIPTION, SMALL_ICON

Constructor Summary

Constructors

Constructor	Description
NewPlayListFromSelectionAction(BeaTunes beaTunes)

Method Summary

Modifier and Type	Method	Description
boolean	fillPlayList(PlayList newPlayList, long[] selectedSongIds)	This method is called by the action as part of its NewPlayListAction.actionPerformed(ActionEvent) method.
ActionLocation[]	getActionLocations()	By default installs this action in the File menu below the New Folder action and—if NewPlayListAction.isRequiresSelectedSongs() returns true also in the context menu.
String	getId()	Returns a unique id for this action.
void	init()	Initializes this action.

Methods inherited from class com.tagtraum.beatunes.action.standard.NewPlayListAction

actionPerformed, createEmptyPlayList, isRequiresSelectedSongs, loadResources, setRequiresSelectedSongs

Methods inherited from class com.tagtraum.beatunes.action.BaseAction

bindListeners, bindListeners, getApplication, getFocusedPlayList, getFocusOwner, getMostRecentlyFocused, getPlayListTreeNode, getSelectedPlayList, getSelectedPlayListTreeNode, getSelectedSong, getSelectedSongCount, getSelectedSongIds, getSelectedSongs, getSelectedSongs, isAnalysisQueueFocused, isMatchTableFocused, isPlayListTreeFocused, isSimpleSongTableFocused, isSongTableFocused, numberOfSelectedSongs, numberOfSelectedSongs, setApplication, shutdown

Methods inherited from class com.tagtraum.core.app.ApplicationAction

getButtonModel, getIconButtonFacade, getMenuFacade, getToolbarButtonFacade, isVisible, register, setButtonModel, setVisible

Methods inherited from class javax.swing.AbstractAction

addPropertyChangeListener, clone, firePropertyChange, getKeys, getPropertyChangeListeners, getValue, isEnabled, putValue, removePropertyChangeListener, setEnabled

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.swing.Action

accept

Constructor Detail

NewPlayListFromSelectionAction

public NewPlayListFromSelectionAction(BeaTunes beaTunes)

Parameters:

beaTunes - beaTunes

Method Detail

getId

public String getId()

Description copied from class: ApplicationAction

Returns a unique id for this action. Typically follows the x.y.z notation from general to specific.

Specified by:

getId in interface ApplicationComponent<BeaTunes>

Specified by:

getId in class ApplicationAction

Returns:

unique id for this action

init

public void init()

Description copied from class: BaseAction

Initializes this action. This method is called by ActionManager.init(), after all components are instantiated and set up. The default implementation is empty.

Specified by:

init in interface ApplicationComponent<BeaTunes>

Overrides:

init in class BaseAction

getActionLocations

public ActionLocation[] getActionLocations()

Description copied from class: NewPlayListAction

By default installs this action in the File menu below the New Folder action and—if NewPlayListAction.isRequiresSelectedSongs() returns true also in the context menu. If you require different locations, override this method.

Overrides:

getActionLocations in class NewPlayListAction

Returns:

action locations

fillPlayList

public boolean fillPlayList(PlayList newPlayList,
                            long[] selectedSongIds)

Description copied from class: NewPlayListAction

This method is called by the action as part of its NewPlayListAction.actionPerformed(ActionEvent) method. You are given an empty, new playlist and the ids of the currently selected songs, if NewPlayListAction.isRequiresSelectedSongs() is true. The idea is to add songs to the playlist using the PlayList.addSongIds(java.util.List) method. If you don't just want to add any of the selected songs, use MediaLibrary to find other songs you want to add to this playlist.

You may also modify the playlist object itself, e.g. change the default name programmatically.

Note that you are not called from either the EDT or the default database thread, but an independent thread. This means, that you may block this thread indefinitely (of course you shouldn't though!). It also means, that from this thread you should invoke UI code using SwingUtilities.invokeAndWait(Runnable).

After this method returns, beaTunes adds the playlist to the PlayListTree, selects it, and allows the user to edit its name.

Specified by:

fillPlayList in class NewPlayListAction

Parameters:

newPlayList - new, empty playlist

selectedSongIds - selected song ids or an empty array, if NewPlayListAction.isRequiresSelectedSongs() is false

Returns:

true on success, false on cancel