RecentAlbums Class Reference

This class maintains and handles saving and loading a list of recently viewed albums. More...

#include <recentAlbums.h>

Collaboration diagram for RecentAlbums:

Public Member Functions
	RecentAlbums ()
void	clearList ()
int	numEntries ()
int	getMaxItems ()
void	getEntry (int index, QString &name, QString &location, QString &photoCount)
void	insertEntry (QString name, QString location, QString photos="-1", bool insertAtBack=true)

Private Attributes
QStringList	albumNames
	lists of album names and locations
QStringList	albumLocations
QStringList	albumPhotoCounts
uint	maxItems
	max allowable items in list

Detailed Description

This class maintains and handles saving and loading a list of recently viewed albums.

Definition at line 26 of file recentAlbums.h.

Constructor & Destructor Documentation

RecentAlbums()

RecentAlbums::RecentAlbums

(

)

Definition at line 20 of file recentAlbums.cpp.

{
  maxItems = MAX_RECENT_ALBUMS;
}

References MAX_RECENT_ALBUMS, and maxItems.

Member Function Documentation

clearList()

void RecentAlbums::clearList

(

)

Definition at line 25 of file recentAlbums.cpp.

{
  albumNames.clear();
  albumLocations.clear();
  albumPhotoCounts.clear();
}

References albumLocations, albumNames, and albumPhotoCounts.

Referenced by TitleWidget::clearOpenRecentMenu().

getEntry()

void RecentAlbums::getEntry	(	int	index,
		QString &	name,
		QString &	location,
		QString &	photoCount )

Definition at line 42 of file recentAlbums.cpp.

{
  name       = *( albumNames.at       (index) );
  location   = *( albumLocations.at   (index) );
  photoCount = *( albumPhotoCounts.at (index) );  
}

References albumLocations, albumNames, and albumPhotoCounts.

Referenced by TitleWidget::loadRecentAlbum(), TitleWidget::refreshOpenRecentMenu(), and Window::~Window().

getMaxItems()

int RecentAlbums::getMaxItems

(

)

Definition at line 37 of file recentAlbums.cpp.

{
  return maxItems;
}

References maxItems.

Referenced by TitleWidget::populateOpenRecentMenu(), and TitleWidget::TitleWidget().

insertEntry()

void RecentAlbums::insertEntry	(	QString	name,
		QString	location,
		QString	photos = "-1",
		bool	insertAtBack = true )

Definition at line 49 of file recentAlbums.cpp.

{
  //items are inserted at back during intialization of list when
  //starting up the program. no duplicates should exist so no checking is performed
  if(insertAtBack || albumNames.count() == 0)
  {
    albumNames.append      ( name     );
    albumLocations.append  ( location );
    albumPhotoCounts.append( photos   ); 
  }
  //items are inserted at the front of the list when either:
  //1.) a new album is saved or
  //2.) an album is opened.
  //the list must then be checked for duplicates and any such duplicates should be removed
  else
  {
    //prepend item
    albumNames.prepend(name);
    albumLocations.prepend(location);
    albumPhotoCounts.prepend(photos);
 
    QStringList::Iterator namesIterator=albumNames.find(name);
    QStringList::Iterator locationsIterator=albumLocations.find(location);
    QStringList::Iterator photoCountsIterator=albumPhotoCounts.find(photos);
 
    //search list for dupes
    while( true )
    {
      //move to next item.
      namesIterator++;
      locationsIterator++;
      photoCountsIterator++; 
 
      //if location matches remove item
      if( location.compare(*locationsIterator) == 0 )
      {
        albumNames.remove      ( namesIterator       );
        albumLocations.remove  ( locationsIterator   );
        albumPhotoCounts.remove( photoCountsIterator );
        break;
      }
 
      //end of list? stop
      if( namesIterator == albumNames.end() ) break;
    }
 
  }//end else
 
  //truncate list as necessary
  while(albumNames.count() > maxItems )
  {
    albumNames.remove( albumNames.last() );
    albumLocations.remove( albumLocations.last() );
    albumPhotoCounts.remove( albumPhotoCounts.last() );
  }  
}

References albumLocations, albumNames, albumPhotoCounts, and maxItems.

Referenced by TitleWidget::loadAlbum(), TitleWidget::saveAlbum(), TitleWidget::saveAsAlbum(), and TitleWidget::TitleWidget().

numEntries()

int RecentAlbums::numEntries

(

)

Definition at line 32 of file recentAlbums.cpp.

{
  return albumNames.count();
}

References albumNames.

Referenced by TitleWidget::refreshOpenRecentMenu(), and Window::~Window().

Member Data Documentation

albumLocations

QStringList RecentAlbums::albumLocations

private

Definition at line 56 of file recentAlbums.h.

Referenced by clearList(), getEntry(), and insertEntry().

albumNames

QStringList RecentAlbums::albumNames

private

lists of album names and locations

Definition at line 55 of file recentAlbums.h.

Referenced by clearList(), getEntry(), insertEntry(), and numEntries().

albumPhotoCounts

QStringList RecentAlbums::albumPhotoCounts

private

Definition at line 57 of file recentAlbums.h.

Referenced by clearList(), getEntry(), and insertEntry().

maxItems

uint RecentAlbums::maxItems

private

max allowable items in list

Definition at line 60 of file recentAlbums.h.

Referenced by getMaxItems(), insertEntry(), and RecentAlbums().

---

The documentation for this class was generated from the following files:

• recentAlbums.h
• recentAlbums.cpp