LayoutWidget Class Reference

Displays list of subalbums and a particular subalbum layout. More...

#include <layoutWidget.h>

Inheritance diagram for LayoutWidget:

Collaboration diagram for LayoutWidget:

Public Slots
void	setEditTabEnabled (bool val)
void	editSelectedPhoto ()
	Edits first select photo.
void	organize ()
	Select organize tab.
void	photoStateChangedEvent ()
	handle the changing state of selected/shown photos
void	refreshSelectedCollectionIconName ()
	updates the selected collection icon name
void	updateSubalbumImage (QPixmap *val)
	Updates the current subalbums image.

Signals
void	collectionSelected (Subalbum *)

Public Member Functions
	LayoutWidget (QWidget *parent=0, const char *name=0)
	Creates empty layout.
SubalbumWidget *	getSubalbum ()
	Returns a pointer to the subalbum.
SubalbumsWidget *	getSubalbums ()
	Returns a pointer to the subalbums.
Window *	getWindow ()
	Returns a pointer to the window.
void	refresh ()
	Refreshes layout.
void	revertPhotos ()
	Reverts all selected photos in organize mode, or currently shown photo if in editing mode.

Private Slots
void	tabChanged (QWidget *widget)
	handle tab shown changed signal
void	showCollection (Subalbum *collection)

Private Attributes
Window *	window
	Window pointer.
Q3GridLayout *	grid
	Grid items placed in.
SubalbumsWidget *	subalbums
	List of subalbums.
QTabWidget *	tabbedArea
	Tab widget containing organize and edit widgets.
SubalbumWidget *	subalbum
	Collection organize widget.
EditingInterface *	editingInterface
	Editing interface.

Detailed Description

Displays list of subalbums and a particular subalbum layout.

Definition at line 39 of file layoutWidget.h.

Constructor & Destructor Documentation

LayoutWidget()

LayoutWidget::LayoutWidget	(	QWidget *	parent = 0,
		const char *	name = 0 )

Creates empty layout.

Definition at line 33 of file layoutWidget.cpp.

                                                             : QWidget(parent,name)
{
  window = (Window*)parent;
  subalbums = new SubalbumsWidget( this, "subalbums" );
  connect( subalbums, SIGNAL( collectionSelected(Subalbum*)),
           this,      SLOT( showCollection( Subalbum* )) );
  
  subalbum = new SubalbumWidget( NULL, this, "subalbum" );
  editingInterface = new EditingInterface( this, "editingInterface" );
 
  tabbedArea = new QTabWidget( this, "tabbedArea" );  
  tabbedArea->addTab(subalbum, tr("Organize") );
  tabbedArea->addTab(editingInterface, tr("Edit") );
  
  //by default no photo has been edited
  tabbedArea->setTabEnabled(editingInterface, false);   
  
  //catch changing tab selection in order to
  //initialize editing interface if it was selected
  connect( tabbedArea, SIGNAL( currentChanged(QWidget*) ),
           this, SLOT( tabChanged(QWidget*) ) );
  
  //catch selectedPhotoStateChanged signal in order to
  //enable/disable Photos and Tools menu items
  connect( subalbum, SIGNAL( selectedPhotoStateChanged() ),
           this, SLOT( photoStateChangedEvent() ) );
  
  //catch photo modified signal in order to 
  //enable/disable Photos and Tools menu items
  connect( editingInterface, SIGNAL( photoModified() ),
           this, SLOT( photoStateChangedEvent() ) );
    
  //place the subalbums list and tabbed area in grid
  grid = new Q3GridLayout( this, 1, 2, 0 );
  
  grid->addWidget( subalbums, 0, 0 );
  grid->setColSpacing( 0, subalbums->sizeHint().width() );
 
  grid->addWidget( tabbedArea, 0, 1 );
  grid->setColStretch( 1, 1 );
}

References collectionSelected(), editingInterface, grid, photoStateChangedEvent(), showCollection(), subalbum, subalbums, tabbedArea, tabChanged(), and window.

Member Function Documentation

collectionSelected

void LayoutWidget::collectionSelected ( Subalbum * )

signal

Referenced by LayoutWidget(), and showCollection().

editSelectedPhoto

void LayoutWidget::editSelectedPhoto ( )

slot

Edits first select photo.

Definition at line 154 of file layoutWidget.cpp.

{
  tabbedArea->showPage( editingInterface );
}

References editingInterface, and tabbedArea.

getSubalbum()

SubalbumWidget * LayoutWidget::getSubalbum

(

)

Returns a pointer to the subalbum.

Definition at line 97 of file layoutWidget.cpp.

{
  return subalbum;
}

References subalbum.

Referenced by TitleWidget::dropEvent(), TitleWidget::exportLargeImages(), TitleWidget::exportSmallWebGallery(), TitleWidget::loadAlbum(), TitleWidget::newAlbum(), TitleWidget::removeSelectedPhotoDesc(), TitleWidget::saveAlbum(), TitleWidget::saveAsAlbum(), TitleWidget::setAlbumImage(), TitleWidget::setSubalbumImage(), and TitleWidget::setSubalbumImage().

getSubalbums()

SubalbumsWidget * LayoutWidget::getSubalbums

(

)

Returns a pointer to the subalbums.

Definition at line 102 of file layoutWidget.cpp.

{
  return subalbums;
}

References subalbums.

Referenced by SubalbumWidget::addImageAction(), TitleWidget::exportLargeImages(), TitleWidget::exportSmallWebGallery(), TitleWidget::loadAlbum(), SubalbumWidget::removeImageAction(), SubalbumWidget::rotate270ImageAction(), SubalbumWidget::rotate90ImageAction(), TitleWidget::saveAlbum(), TitleWidget::saveAsAlbum(), TitleWidget::setSubalbumImage(), TitleWidget::storeAnnotations(), and TitleWidget::unsetSubalbumImage().

getWindow()

Window * LayoutWidget::getWindow

(

)

Returns a pointer to the window.

Definition at line 107 of file layoutWidget.cpp.

{
  return window;
}

References window.

Referenced by SubalbumWidget::addImageAction(), EditingInterface::adjustGrain(), EditingInterface::applyEffect(), EditingInterface::colorBalance(), SubalbumsWidget::createAction(), EditingInterface::crop(), SubalbumsWidget::deleteAction(), EditingInterface::enhanceContrast(), EditingInterface::finishCorrectTilt(), SubalbumsWidget::handleSelectionAttempt(), SubalbumsWidget::refreshCollectionsList(), SubalbumWidget::removeImageAction(), EditingInterface::removeRedeye(), SubalbumsWidget::reorder(), EditingInterface::revertCurrentPhoto(), SubalbumWidget::rotate270ImageAction(), SubalbumWidget::rotate90ImageAction(), EditingInterface::rotateFlip(), and EditingInterface::tuneLevels().

organize

void LayoutWidget::organize ( )

slot

Select organize tab.

Definition at line 159 of file layoutWidget.cpp.

{
  tabbedArea->setCurrentPage( 0 );
}

References tabbedArea.

Referenced by EditingInterface::returnAction(), and showCollection().

photoStateChangedEvent

void LayoutWidget::photoStateChangedEvent ( )

slot

handle the changing state of selected/shown photos

Definition at line 177 of file layoutWidget.cpp.

{
  //determine if:
  //1.) any photos are selected - false if in editing mode
  //2.) if any revertable photos are selected/shown
  bool anySelected = false;
  bool anyRevertable = false;
  
  if( tabbedArea->currentPage() == subalbum )
  {
    anySelected = subalbum->anyPhotosSelected();
    anyRevertable = anySelected && subalbum->anySelectedPhotosRevertable();    
  }
  else
  {
    //none selected in editing mode
    anySelected = false;
    anyRevertable = editingInterface->currentPhotoRevertable();
  }
  
  //update menus
  window->getTitle()->updateMenus(anySelected, anyRevertable);    
}

References SubalbumWidget::anyPhotosSelected(), SubalbumWidget::anySelectedPhotosRevertable(), EditingInterface::currentPhotoRevertable(), editingInterface, Window::getTitle(), subalbum, tabbedArea, TitleWidget::updateMenus(), and window.

Referenced by LayoutWidget(), and tabChanged().

refresh()

void LayoutWidget::refresh

(

)

Refreshes layout.

Definition at line 112 of file layoutWidget.cpp.

{
  subalbums->refreshCollectionsList();
}

References SubalbumsWidget::refreshCollectionsList(), and subalbums.

Referenced by Window::refresh(), and Window::Window().

refreshSelectedCollectionIconName

void LayoutWidget::refreshSelectedCollectionIconName ( )

slot

updates the selected collection icon name

Definition at line 87 of file layoutWidget.cpp.

{
  subalbums->refreshSelectedCollectionName();
}

References SubalbumsWidget::refreshSelectedCollectionName(), and subalbums.

revertPhotos()

void LayoutWidget::revertPhotos

(

)

Reverts all selected photos in organize mode, or currently shown photo if in editing mode.

Definition at line 169 of file layoutWidget.cpp.

{
  if( tabbedArea->currentPage() == subalbum )
    subalbum->revertSelectedPhotos();
  else if( tabbedArea->currentPage() == editingInterface )
    editingInterface->revertCurrentPhoto();
}

References editingInterface, EditingInterface::revertCurrentPhoto(), SubalbumWidget::revertSelectedPhotos(), subalbum, and tabbedArea.

Referenced by TitleWidget::revertPhotos().

setEditTabEnabled

void LayoutWidget::setEditTabEnabled ( bool val )

slot

Definition at line 164 of file layoutWidget.cpp.

{
  tabbedArea->setTabEnabled(editingInterface, val);   
}

References editingInterface, and tabbedArea.

Referenced by SubalbumWidget::updateButtons(), and SubalbumWidget::updateButtons().

showCollection

void LayoutWidget::showCollection ( Subalbum * collection )

privateslot

Definition at line 75 of file layoutWidget.cpp.

{
  //ensure currently in organize mode
  organize();
  
  //load collection
  subalbum->setSubalbum(collection);
  
  //pass signal on so title area can update as well
  emit collectionSelected( collection );
}

References collectionSelected(), organize(), SubalbumWidget::setSubalbum(), and subalbum.

Referenced by LayoutWidget().

tabChanged

void LayoutWidget::tabChanged ( QWidget * widget )

privateslot

handle tab shown changed signal

get current collection and photo pointers

Definition at line 117 of file layoutWidget.cpp.

{
  //orignize tab seleced
  if(widget != editingInterface)
  {
    //refresh all thumbnails since any could have changed
    subalbum->refreshAllPhotos();
 
    //handle the selected/shown photo state having been changed
    photoStateChangedEvent();
 
    //find and select the last shown photo in the
    //editing interface, unselect all other items
    subalbum->setSelectedPhoto( editingInterface->getPhoto() );
    
    return;
  }
  //edit tab selected - init editor
  else
  {
    Subalbum* collection = subalbum->getSubalbum();
    Photo* photo = subalbum->getFirstSelectedPhoto();    
 
    //bail if either pointer is null (sanity check)
    if(collection == NULL || photo == NULL)
      return;
  
    //init editing interface for current collection:photo
    editingInterface->setPhoto( collection, photo);
    editingInterface->setFocus();
 
    //handle the selected/shown photo state having been changed
    photoStateChangedEvent();
  }
}

References editingInterface, SubalbumWidget::getFirstSelectedPhoto(), EditingInterface::getPhoto(), SubalbumWidget::getSubalbum(), photoStateChangedEvent(), SubalbumWidget::refreshAllPhotos(), EditingInterface::setFocus(), EditingInterface::setPhoto(), SubalbumWidget::setSelectedPhoto(), and subalbum.

Referenced by LayoutWidget().

updateSubalbumImage

void LayoutWidget::updateSubalbumImage ( QPixmap * val )

slot

Updates the current subalbums image.

Definition at line 92 of file layoutWidget.cpp.

{
  subalbums->updatedSelectedCollectionImage(val);
}

References subalbums, and SubalbumsWidget::updatedSelectedCollectionImage().

Member Data Documentation

editingInterface

EditingInterface* LayoutWidget::editingInterface

private

Editing interface.

Definition at line 80 of file layoutWidget.h.

Referenced by editSelectedPhoto(), LayoutWidget(), photoStateChangedEvent(), revertPhotos(), setEditTabEnabled(), and tabChanged().

grid

Q3GridLayout* LayoutWidget::grid

private

Grid items placed in.

Definition at line 68 of file layoutWidget.h.

Referenced by LayoutWidget().

subalbum

SubalbumWidget* LayoutWidget::subalbum

private

Collection organize widget.

Definition at line 77 of file layoutWidget.h.

Referenced by getSubalbum(), LayoutWidget(), photoStateChangedEvent(), revertPhotos(), showCollection(), and tabChanged().

subalbums

SubalbumsWidget* LayoutWidget::subalbums

private

List of subalbums.

Definition at line 71 of file layoutWidget.h.

Referenced by getSubalbums(), LayoutWidget(), refresh(), refreshSelectedCollectionIconName(), and updateSubalbumImage().

tabbedArea

QTabWidget* LayoutWidget::tabbedArea

private

Tab widget containing organize and edit widgets.

Definition at line 74 of file layoutWidget.h.

Referenced by editSelectedPhoto(), LayoutWidget(), organize(), photoStateChangedEvent(), revertPhotos(), and setEditTabEnabled().

window

Window* LayoutWidget::window

private

Window pointer.

Definition at line 65 of file layoutWidget.h.

Referenced by getWindow(), LayoutWidget(), and photoStateChangedEvent().

---

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

• layoutWidget.h
• layoutWidget.cpp