SearchForSongs Function

Searches for songs recursively using the file extension and starting directory specified in the parameters. Builds a new list with the results.

Protected afx_msg short SearchForSongs(LPCTSTR , LPCTSTR )

Type Name Description
  LPCTSTR fileExtension file extension to search for
  LPCTSTR startingDir path of the directory to start in
       
Return Description
  afx_msg short returns the number of songs found


UseExternalWindow Function

Creates an external window for the playlist

Protected afx_msg void UseExternalWindow(LPCTSTR , short )

Type Name Description
  LPCTSTR title the title of the window
  short width the width of the window
       
Return Description
  afx_msg void  


GetCurrentSong Function

Retrieves the full path of the current song

Protected afx_msg BSTR GetCurrentSong()

Return Description
  afx_msg BSTR returns the full path of the currently selected song, returns NULL if no song is selected



SelectNextSong Function

Selects the next song in the list

Protected afx_msg BOOL SelectNextSong()

Return Description
  afx_msg BOOL returns true if it is able to select the next song, returns false if there is no currently selected song or it is the last song in the list



SetBkColor Function

Sets the window background color

Protected afx_msg void SetBkColor(short = 0, short = 0, short = 0)

Type Name Description
  short red red RGB value
  short green green RGB value
  short blue blue RGB value
       
Return Description
  afx_msg void  


SetTextColor Function

Sets the text color

Protected afx_msg void SetTextColor(short = 0, short = 0, short = 0)

Type Name Description
  short red red RGB value
  short green green RGB value
  short blue blue RGB value
       
Return Description
  afx_msg void  


SetTextBkColor Function

Sets the text background color

Protected afx_msg void SetTextBkColor(short = 0, short = 0, short = 0)

Type Name Description
  short red red RGB value
  short green green RGB value
  short blue blue RGB value
       
Return Description
  afx_msg void  


ClearList Function

Clears the list of songs

Protected afx_msg void ClearList()

Return Description
  afx_msg void  


GetCurrentSongTitle Function

Retrieves the current song's title

Protected afx_msg BSTR GetCurrentSongTitle()

Return Description
  afx_msg BSTR returns the title as a string, or NULL if no song is currently selected



SelectFirstSong Function

Selects the first song in the list

Protected afx_msg void SelectFirstSong()

Return Description
  afx_msg void  


SelectPreviousSong Function

Selects the previous song in the list

Protected afx_msg BOOL SelectPreviousSong()

Return Description
  afx_msg BOOL returns true if it is able to select the previous song, returns false if there is no currently selected song or it is the first song in the list



SelectRandomSong Function

Selects a random song from the songs that have not been played yet.
If all the songs have been played, it starts over and randomly picks one of the songs.

Protected afx_msg void SelectRandomSong()

Return Description
  afx_msg void  


CloseExternalWindow Function

Closes the external window if it exists.

Protected afx_msg void CloseExternalWindow()

Return Description
  afx_msg void  


GetNumberOfSongs Function

Retrieves the number of songs in the list

Protected afx_msg short GetNumberOfSongs()

Return Description
  afx_msg void returns the number of songs



Save Function

Saves the current list

Protected afx_msg BOOL Save(LPCTSTR )

Type Name Description
  LPCTSTR path this should be a specific filename (including path), or empty if you want to present a dialog.
       
Return Description
  afx_msg BOOL returns true if successfull, false if the user clicks cancel on the dialog or if the file cannot be opened



Load Function

Loads a saved list

Protected afx_msg BOOL Load(LPCTSTR )

Type Name Description
  LPCTSTR path this should be a specific filename (including path), or empty if you want to present a dialog.
       
Return Description
  afx_msg BOOL returns true if successfull, false if the user clicks cancel on the dialog or if the file cannot be opened



GetCurrentSongIndex Function

Retrieves the current song index in the list

Protected afx_msg short GetCurrentSongIndex()

Return Description
  afx_msg short returns the current song index, if there is no current song it returns 0


FireOnSelectionChanged Function

This event fires whenever the selection is changed

Protected void FireOnSelectionChanged()

Return Description
  void