com.dt.iTunesController
Class ITUserPlaylist

java.lang.Object
  com.dt.iTunesController.ITObject
      com.dt.iTunesController.ITPlaylist
          com.dt.iTunesController.ITUserPlaylist

public class ITUserPlaylist
extends ITPlaylist

Represents a user-defined playlist. A user playlist includes both smart and manual user-defined playlists.

Field Summary

Fields inherited from class com.dt.iTunesController.ITObject

object

Constructor Summary

ITUserPlaylist(com.jacob.com.Dispatch d)

Method Summary

ITOperationStatus	addFile(java.lang.String filePath) Add a file or files inside a folder to the playlist.
ITTrack	addTrack(ITTrack track) Add an existing track to the playlist.
ITURLTrack	addURL(java.lang.String url) Add a streaming audio URL to the playlist.

Methods inherited from class com.dt.iTunesController.ITPlaylist

delete, getDuration, getKind, getSize, getSongRepeat, getSource, getTime, getTracks, getVisible, playFirstTrack, print, search, setShuffle, setSongRepeat

Methods inherited from class com.dt.iTunesController.ITObject

fetchDispatch, getIndex, getName, getPlaylistID, getSourceID, getTrackDatabaseID, getTrackID, setName

Methods inherited from class java.lang.Object

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

Constructor Detail

ITUserPlaylist

public ITUserPlaylist(com.jacob.com.Dispatch d)

Method Detail

addFile

public ITOperationStatus addFile(java.lang.String filePath)

Add a file or files inside a folder to the playlist. You cannot use this method to add a file that requires conversion to be added (e.g. a CD track), use iTunes.convertFile() or iTunes.convertFile2() instead. If you add a folder that contains files that require conversion, they will be skipped.

Parameters:

filePath - The full path to the file or folder to add.

Returns:

Returns an ITOperationStatus object corresponding to the asynchronous operation. If an error occurs, or no files were added, this will be set to NULL.

addURL

public ITURLTrack addURL(java.lang.String url)

Add a streaming audio URL to the playlist.

Parameters:

url - The URL to add. The length of the URL can be 255 characters or less.

Returns:

Returns an ITURLTrack object corresponding to the new track.

addTrack

public ITTrack addTrack(ITTrack track)

Add an existing track to the playlist. You cannot use this method to add a CD track (ITTrackKindCD) to another playlist, use iTunes.convertTrack() or iTunes.convertTrack2() instead. You cannot add a shared library track (ITTrackKindSharedLibrary) to another playlist.

Parameters:

track - The track to add.

Returns:

Returns an IITTrack object corresponding to the new track.