digiKam
Public Types | Public Slots | Signals | Public Member Functions | Protected Slots | Protected Member Functions | Protected Attributes | List of all members
Digikam::AlbumSelectionTreeView Class Reference
+ Inheritance diagram for Digikam::AlbumSelectionTreeView:

Public Types

enum  Flag {
  CreateDefaultModel , CreateDefaultFilterModel , CreateDefaultDelegate , ShowCountAccordingToSettings ,
  AlwaysShowInclusiveCounts , DefaultFlags = CreateDefaultFilterModel | CreateDefaultDelegate | ShowCountAccordingToSettings
}
 
enum  StateSavingDepth { INSTANCE , DIRECT_CHILDREN , RECURSIVE }
 

Public Slots

void adaptColumnsToContent ()
 
void expandEverything (const QModelIndex &index)
 
void scrollToSelectedAlbum ()
 
void setCurrentAlbum (int albumId, bool selectInAlbumManager=true)
 
void setCurrentAlbums (const QList< Album * > &albums, bool selectInAlbumManager=true)
 
void setSearchTextSettings (const SearchTextSettings &settings)
 
void slotCollapseAllNodes ()
 slotCollapseAllNodes - collapse all nodes without root node More...
 
void slotCollapseNode ()
 slotCollapseNode - collapse recursively selected nodes More...
 
void slotExpandNode ()
 slotExpandNode - expands recursively selected nodes More...
 

Signals

void currentAlbumChanged (Album *currentAlbum)
 
void selectedAlbumsChanged (const QList< Album * > &selectedAlbums)
 
void signalFindDuplicates (const QList< PAlbum * > &albums)
 

Public Member Functions

void addContextMenuElement (ContextMenuElement *const element)
 
CheckableAlbumFilterModel * albumFilterModel () const
 
PAlbum * albumForIndex (const QModelIndex &index) const
 
AlbumModel * albumModel () const
 
 AlbumSelectionTreeView (QWidget *const parent, AlbumModel *const model, AlbumModificationHelper *const albumModificationHelper)
 
CheckableAlbumFilterModel * checkableAlbumFilterModel () const
 
AbstractCheckableAlbumModel * checkableModel () const
 
QList< ContextMenuElement * > contextMenuElements () const
 
PAlbum * currentAlbum () const
 
template<class A >
QList< A * > currentAlbums ()
 
void doLoadState () override
 
void doSaveState () override
 
bool expandMatches (const QModelIndex &index)
 
StateSavingDepth getStateSavingDepth () const
 
QModelIndex indexVisuallyAt (const QPoint &p)
 
bool isRestoreCheckState () const
 
void loadState ()
 
void removeContextMenuElement (ContextMenuElement *const element)
 
void saveState ()
 
QList< Album * > selectedItems ()
 selectedItems() - More...
 
void setAlbumFilterModel (CheckableAlbumFilterModel *const filterModel)
 
void setAlbumManagerCurrentAlbum (const bool setCurrentAlbum)
 
void setAlbumModel (AlbumModel *const model)
 
void setCheckOnMiddleClick (bool doThat)
 Enable checking on middle mouse button click (default: on) More...
 
virtual void setConfigGroup (const KConfigGroup &group)
 
void setContextMenuIcon (const QPixmap &pixmap)
 
void setContextMenuTitle (const QString &title)
 
void setEnableContextMenu (const bool enable)
 
void setEnableToolTips (bool enable)
 
virtual void setEntryPrefix (const QString &prefix)
 
void setExpandNewCurrentItem (const bool doThat)
 
void setExpandOnSingleClick (const bool doThat)
 
void setRestoreCheckState (bool restore)
 
void setSelectAlbumOnClick (const bool selectOnClick)
 
void setSelectOnContextMenu (const bool select)
 
void setStateSavingDepth (const StateSavingDepth depth)
 
 ~AlbumSelectionTreeView () override
 

Protected Slots

void albumSettingsChanged ()
 
void slotCurrentChanged ()
 
virtual void slotRootAlbumAvailable ()
 
void slotSearchTextSettingsAboutToChange (bool searched, bool willSearch)
 
void slotSearchTextSettingsChanged (bool wasSearching, bool searching)
 
void slotSelectionChanged ()
 

Protected Member Functions

virtual void addCustomContextMenuActions (ContextMenuHelper &cmh, Album *album)
 
virtual QPixmap contextMenuIcon () const
 
virtual QString contextMenuTitle () const
 
void dragEnterEvent (QDragEnterEvent *e) override
 
void dragLeaveEvent (QDragLeaveEvent *e) override
 
void dragMoveEvent (QDragMoveEvent *e) override
 
void dropEvent (QDropEvent *e) override
 
QString entryName (const QString &base) const
 
KConfigGroup getConfigGroup () const
 
virtual void handleCustomContextMenuAction (QAction *action, const AlbumPointer< Album > &album)
 
void middleButtonPressed (Album *a) override
 
void mousePressEvent (QMouseEvent *e) override
 Other helper methods. More...
 
virtual QPixmap pixmapForDrag (const QStyleOptionViewItem &option, QList< QModelIndex > indexes)
 
void rowsAboutToBeRemoved (const QModelIndex &parent, int start, int end) override
 
void rowsInserted (const QModelIndex &parent, int start, int end) override
 
void setAlbumFilterModel (AlbumFilterModel *const filterModel)
 
void setAlbumModel (AbstractCountingAlbumModel *const model)
 
void setAlbumModel (AbstractSpecificAlbumModel *const model)
 
virtual bool showContextMenuAt (QContextMenuEvent *event, Album *albumForEvent)
 
void startDrag (Qt::DropActions supportedActions) override
 

Protected Attributes

AlbumFilterModel * m_albumFilterModel
 
AbstractSpecificAlbumModel * m_albumModel
 
bool m_checkOnMiddleClick
 
AlbumModelDragDropHandler * m_dragDropHandler
 
Flags m_flags
 
int m_lastScrollBarValue
 
bool m_restoreCheckState
 

Detailed Description

Album tree view used in the left sidebar to select PAlbums and perform operations on them via a context menu.

Author
jwienke

Member Enumeration Documentation

◆ Flag

enum Digikam::AbstractAlbumTreeView::Flag
inherited
Enumerator
CreateDefaultModel 

Create a default model. Not supported by abstract classes. Not part of default flags!

CreateDefaultFilterModel 

Create a default filter model.

CreateDefaultDelegate 

Create a delegate which paints according to settings. If not set, the Qt default delegate of the view is used.

ShowCountAccordingToSettings 

Show the count according to the settings. If not set, call setShowCount() on the model yourself.

AlwaysShowInclusiveCounts 

Always show the inclusive counts. Not part of default flags!

DefaultFlags 

◆ StateSavingDepth

enum Digikam::StateSavingObject::StateSavingDepth
inherited

This enum defines the "depth" of the StateSavingObject::loadState() and StateSavingObject::saveState() methods.

Enumerator
INSTANCE 

Only the instance the saving / restoring was invoked on is saved / restored.

DIRECT_CHILDREN 

The instance itself and all direct children of this instance implementing StateSavingObject are saved / restored.

RECURSIVE 

The instance and all children in the complete hierarchy are saved / restored.

Constructor & Destructor Documentation

◆ AlbumSelectionTreeView()

Digikam::AlbumSelectionTreeView::AlbumSelectionTreeView ( QWidget *const  parent,
AlbumModel *const  model,
AlbumModificationHelper *const  albumModificationHelper 
)

References Digikam::AbstractAlbumTreeView::addContextMenuElement(), Digikam::AlbumTreeView::setAlbumModel(), Digikam::AbstractAlbumTreeView::setContextMenuTitle(), Digikam::AbstractAlbumTreeView::setEnableContextMenu(), Digikam::AbstractAlbumTreeView::setSelectAlbumOnClick(), Digikam::AbstractAlbumTreeView::slotCollapseAllNodes(), Digikam::AbstractAlbumTreeView::slotCollapseNode(), and Digikam::AbstractAlbumTreeView::slotExpandNode().

◆ ~AlbumSelectionTreeView()

Digikam::AlbumSelectionTreeView::~AlbumSelectionTreeView ( )
override

Member Function Documentation

◆ adaptColumnsToContent

void Digikam::AbstractAlbumTreeView::adaptColumnsToContent ( )
slotinherited

Adapt the column sizes to the contents of the tree view.

Referenced by Digikam::AbstractAlbumTreeView::AbstractAlbumTreeView(), and Digikam::AbstractAlbumTreeView::setAlbumFilterModel().

◆ addContextMenuElement()

void Digikam::AbstractAlbumTreeView::addContextMenuElement ( ContextMenuElement *const  element)
inherited

References Digikam::AbstractAlbumTreeView::Private::contextMenuElements.

Referenced by Digikam::AbstractAlbumTreeViewSelectComboBox::addCheckUncheckContextMenuActions(), and AlbumSelectionTreeView().

◆ addCustomContextMenuActions()

void Digikam::AbstractAlbumTreeView::addCustomContextMenuActions ( ContextMenuHelper &  cmh,
Album *  album 
)
protectedvirtualinherited

Hook method to add custom actions to the generated context menu.

Parameters
cmhhelper object to create the context menu
albumtag on which the context menu will be created. May be null if it is requested on no tag entry

Reimplemented in Digikam::NormalSearchTreeView, Digikam::EditableSearchTreeView, Digikam::TagFolderView, Digikam::TagCheckView, Digikam::AlbumSelectTreeView, and Digikam::TagFilterView.

◆ albumFilterModel()

CheckableAlbumFilterModel * Digikam::AbstractCheckableAlbumTreeView::albumFilterModel ( ) const
inherited

References Digikam::AbstractAlbumTreeView::m_albumFilterModel.

Referenced by Digikam::AbstractCheckableAlbumTreeView::checkableAlbumFilterModel(), Digikam::TagFolderView::contextMenuEvent(), Digikam::FuzzySearchView::FuzzySearchView(), Digikam::SearchTreeView::SearchTreeView(), Digikam::SearchTreeView::setAlbumFilterModel(), Digikam::TagTreeView::setAlbumFilterModel(), Digikam::TagMngrTreeView::setAlbumFilterModel(), Digikam::TagMngrTreeView::TagMngrTreeView(), and Digikam::TagTreeView::TagTreeView().

◆ albumForIndex()

PAlbum * Digikam::AlbumTreeView::albumForIndex ( const QModelIndex &  index) const
inherited

References Digikam::AlbumFilterModel::albumForIndex(), and Digikam::AbstractAlbumTreeView::m_albumFilterModel.

◆ albumModel()

AlbumModel * Digikam::AlbumTreeView::albumModel ( ) const
inherited

References Digikam::AbstractAlbumTreeView::m_albumModel.

Referenced by Digikam::AlbumTreeView::setAlbumModel().

◆ albumSettingsChanged

void Digikam::AbstractAlbumTreeView::albumSettingsChanged ( )
protectedslotinherited

References Digikam::AbstractAlbumTreeView::Private::delegate, Digikam::ApplicationSettings::instance(), and Digikam::AlbumTreeViewDelegate::updateHeight().

Referenced by Digikam::AbstractAlbumTreeView::AbstractAlbumTreeView().

◆ checkableAlbumFilterModel()

CheckableAlbumFilterModel* Digikam::AbstractCheckableAlbumTreeView::checkableAlbumFilterModel ( ) const
inlineinherited

References Digikam::AbstractCheckableAlbumTreeView::albumFilterModel().

◆ checkableModel()

AbstractCheckableAlbumModel* Digikam::AbstractCheckableAlbumTreeView::checkableModel ( ) const
inlineinherited

References Digikam::AbstractCheckableAlbumTreeView::albumModel().

Referenced by Digikam::AbstractCheckableAlbumTreeView::doLoadState(), Digikam::AbstractCheckableAlbumTreeView::doSaveState(), and Digikam::AbstractCheckableAlbumTreeView::rowsInserted().

◆ contextMenuElements()

QList< AbstractAlbumTreeView::ContextMenuElement * > Digikam::AbstractAlbumTreeView::contextMenuElements ( ) const
inherited

References Digikam::AbstractAlbumTreeView::Private::contextMenuElements.

◆ contextMenuIcon()

QPixmap Digikam::AbstractAlbumTreeView::contextMenuIcon ( ) const
protectedvirtualinherited

Hook method that can be implemented to return a special icon used for the context menu.

Returns
the icon for the context menu

References Digikam::AbstractAlbumTreeView::Private::contextMenuIcon.

Referenced by Digikam::TagMngrTreeView::contextMenuEvent(), and Digikam::TagFolderView::contextMenuEvent().

◆ contextMenuTitle()

QString Digikam::AbstractAlbumTreeView::contextMenuTitle ( ) const
protectedvirtualinherited

Hook method to implement that returns the title for the context menu.

Returns
title for the context menu

Reimplemented in Digikam::EditableSearchTreeView, and Digikam::TagFolderView.

References Digikam::AbstractAlbumTreeView::Private::contextMenuTitle.

◆ currentAlbum()

PAlbum * Digikam::AlbumTreeView::currentAlbum ( ) const
inherited

References Digikam::AlbumFilterModel::albumForIndex(), and Digikam::AbstractAlbumTreeView::m_albumFilterModel.

Referenced by Digikam::AlbumSelectTreeView::slotNewAlbum().

◆ currentAlbumChanged

void Digikam::AbstractAlbumTreeView::currentAlbumChanged ( Album *  currentAlbum)
signalinherited

Emitted when the currently selected album changes

Referenced by Digikam::AbstractAlbumTreeView::AbstractAlbumTreeView(), Digikam::AddTagsLineEdit::setTagTreeView(), and Digikam::AbstractAlbumTreeView::slotCurrentChanged().

◆ currentAlbums()

template<class A >
QList< A * > Digikam::AbstractAlbumTreeView::currentAlbums
inherited

References Digikam::AlbumManager::currentAlbums(), and Digikam::AlbumManager::instance().

◆ doLoadState()

void Digikam::AbstractCheckableAlbumTreeView::doLoadState ( )
overridevirtualinherited

Implements state loading for the album tree view in a somewhat clumsy procedure because the model may not be fully loaded when this method is called. Therefore the config is first parsed into d->statesByAlbumId which holds the state of all tree view entries indexed by album id. Afterwards an initial sync run is done restoring the state of all model entries that are already present at this time. Every processed entry is removed from d->statesByAlbumId. If there are still entries left in this map we assume that the model is not fully loaded at the moment. Therefore the rowsInserted signal is connected to a slot that restores the state of new rows based on the remaining entries in d->statesByAlbumId.

Reimplemented from Digikam::AbstractAlbumTreeView.

Reimplemented in Digikam::TagCheckView.

References Digikam::AbstractCheckableAlbumTreeView::checkableModel(), Digikam::AbstractAlbumTreeView::doLoadState(), Digikam::StateSavingObject::entryName(), Digikam::StateSavingObject::getConfigGroup(), and Digikam::AbstractAlbumTreeView::m_restoreCheckState.

Referenced by Digikam::TagCheckView::doLoadState().

◆ doSaveState()

void Digikam::AbstractCheckableAlbumTreeView::doSaveState ( )
overridevirtualinherited

Implement this hook method for state saving. Use getConfigGroup() and entryName() for the implementation.

Reimplemented from Digikam::AbstractAlbumTreeView.

Reimplemented in Digikam::TagCheckView.

References Digikam::AbstractCheckableAlbumTreeView::checkableModel(), Digikam::AbstractCheckableAlbumModel::checkedAlbums(), Digikam::AbstractAlbumTreeView::doSaveState(), Digikam::StateSavingObject::entryName(), Digikam::StateSavingObject::getConfigGroup(), Digikam::Album::id(), Digikam::AbstractAlbumTreeView::m_restoreCheckState, and Digikam::AbstractCheckableAlbumModel::partiallyCheckedAlbums().

Referenced by Digikam::TagCheckView::doSaveState().

◆ dragEnterEvent()

void Digikam::AbstractAlbumTreeView::dragEnterEvent ( QDragEnterEvent *  e)
overrideprotectedinherited

References Digikam::AlbumModelDragDropHandler::acceptsMimeData(), Digikam::AbstractAlbumModel::dragDropHandler(), and Digikam::AbstractAlbumTreeView::m_albumModel.

◆ dragLeaveEvent()

void Digikam::AbstractAlbumTreeView::dragLeaveEvent ( QDragLeaveEvent *  e)
overrideprotectedinherited

◆ dragMoveEvent()

void Digikam::AbstractAlbumTreeView::dragMoveEvent ( QDragMoveEvent *  e)
overrideprotectedinherited

References Digikam::AlbumModelDragDropHandler::accepts(), Digikam::AbstractAlbumModel::dragDropHandler(), Digikam::AbstractAlbumTreeView::indexVisuallyAt(), Digikam::AbstractAlbumTreeView::m_albumFilterModel, Digikam::AbstractAlbumTreeView::m_albumModel, and Digikam::AlbumFilterModel::mapToSourceAlbumModel().

◆ dropEvent()

void Digikam::AbstractAlbumTreeView::dropEvent ( QDropEvent *  e)
overrideprotectedinherited

References Digikam::AbstractAlbumModel::dragDropHandler(), Digikam::AlbumModelDragDropHandler::dropEvent(), Digikam::AbstractAlbumTreeView::indexVisuallyAt(), Digikam::AbstractAlbumTreeView::m_albumFilterModel, Digikam::AbstractAlbumTreeView::m_albumModel, and Digikam::AlbumFilterModel::mapToSourceAlbumModel().

◆ entryName()

QString Digikam::StateSavingObject::entryName ( const QString &  base) const
protectedinherited

Always use this method to create config group entry names. This allows to manipulate the entry keys externally by eg. setting a prefix.

Parameters
baseoriginal name planned for the config group entry
Returns
entry name after manipulating it with externally set parameters

Referenced by Digikam::FilterSideBarWidget::doLoadState(), Digikam::AbstractAlbumTreeView::doLoadState(), Digikam::AbstractCheckableAlbumTreeView::doLoadState(), Digikam::LabelsTreeView::doLoadState(), Digikam::ImportItemPropertiesSideBarImport::doLoadState(), Digikam::ItemPropertiesSideBar::doLoadState(), Digikam::ItemPropertiesSideBarDB::doLoadState(), Digikam::TagCheckView::doLoadState(), Digikam::Sidebar::doLoadState(), Digikam::SearchTextBar::doLoadState(), ShowFoto::ShowfotoFolderViewSideBar::doLoadState(), ShowFoto::ShowfotoStackViewSideBar::doLoadState(), Digikam::FaceScanWidget::doLoadState(), Digikam::FuzzySearchView::doLoadState(), Digikam::GPSSearchView::doLoadState(), Digikam::FilterSideBarWidget::doSaveState(), Digikam::AbstractAlbumTreeView::doSaveState(), Digikam::AbstractCheckableAlbumTreeView::doSaveState(), Digikam::LabelsTreeView::doSaveState(), Digikam::ImportItemPropertiesSideBarImport::doSaveState(), Digikam::ItemPropertiesSideBar::doSaveState(), Digikam::ItemPropertiesSideBarDB::doSaveState(), Digikam::TagCheckView::doSaveState(), Digikam::Sidebar::doSaveState(), Digikam::SearchTextBar::doSaveState(), ShowFoto::ShowfotoFolderViewSideBar::doSaveState(), ShowFoto::ShowfotoStackViewSideBar::doSaveState(), Digikam::FaceScanWidget::doSaveState(), Digikam::FuzzySearchView::doSaveState(), and Digikam::GPSSearchView::doSaveState().

◆ expandEverything

void Digikam::AbstractAlbumTreeView::expandEverything ( const QModelIndex &  index)
slotinherited

Expands the complete tree under the given index.

Parameters
indexthe index to start expanding everything

References Digikam::AbstractAlbumTreeView::albumFilterModel().

◆ expandMatches()

bool Digikam::AbstractAlbumTreeView::expandMatches ( const QModelIndex &  index)
inherited

Ensures that every current match is visible by expanding all parent entries.

Parameters
indexthe index to start ensuring expansion state
Returns
true if there was a match under index. This return value can normally be ignored by the caller because it is only used for an internal recursion.

References Digikam::AlbumFilterModel::ChildMatch, Digikam::AlbumFilterModel::DirectMatch, Digikam::AbstractAlbumTreeView::m_albumFilterModel, Digikam::AlbumFilterModel::matchResult(), Digikam::AlbumFilterModel::NoMatch, Digikam::AlbumFilterModel::ParentMatch, and Digikam::AlbumFilterModel::SpecialMatch.

Referenced by Digikam::AbstractAlbumTreeView::slotSearchTextSettingsChanged().

◆ getConfigGroup()

KConfigGroup Digikam::StateSavingObject::getConfigGroup ( ) const
protectedinherited

Returns the config group that must be used for state saving and loading.

Returns
config group for state saving and loading

Referenced by Digikam::AlbumFolderViewSideBarWidget::AlbumFolderViewSideBarWidget(), Digikam::DateFolderViewSideBarWidget::DateFolderViewSideBarWidget(), Digikam::FilterSideBarWidget::doLoadState(), Digikam::TagViewSideBarWidget::doLoadState(), Digikam::TimelineSideBarWidget::doLoadState(), Digikam::MapWidgetView::doLoadState(), Digikam::TableView::doLoadState(), Digikam::AbstractAlbumTreeView::doLoadState(), Digikam::AbstractCheckableAlbumTreeView::doLoadState(), Digikam::LabelsTreeView::doLoadState(), Digikam::ImportItemPropertiesSideBarImport::doLoadState(), Digikam::ItemPropertiesSideBar::doLoadState(), Digikam::ItemPropertiesSideBarDB::doLoadState(), Digikam::TagsManager::doLoadState(), Digikam::TagCheckView::doLoadState(), Digikam::Sidebar::doLoadState(), Digikam::SearchTextBar::doLoadState(), ShowFoto::ShowfotoFolderViewSideBar::doLoadState(), ShowFoto::ShowfotoStackViewSideBar::doLoadState(), Digikam::FaceScanWidget::doLoadState(), Digikam::FuzzySearchView::doLoadState(), Digikam::GPSSearchView::doLoadState(), Digikam::FilterSideBarWidget::doSaveState(), Digikam::TagViewSideBarWidget::doSaveState(), Digikam::TimelineSideBarWidget::doSaveState(), Digikam::MapWidgetView::doSaveState(), Digikam::TableView::doSaveState(), Digikam::AbstractAlbumTreeView::doSaveState(), Digikam::AbstractCheckableAlbumTreeView::doSaveState(), Digikam::LabelsTreeView::doSaveState(), Digikam::ImportItemPropertiesSideBarImport::doSaveState(), Digikam::ItemPropertiesSideBar::doSaveState(), Digikam::ItemPropertiesSideBarDB::doSaveState(), Digikam::TagsManager::doSaveState(), Digikam::TagCheckView::doSaveState(), Digikam::Sidebar::doSaveState(), Digikam::SearchTextBar::doSaveState(), ShowFoto::ShowfotoFolderViewSideBar::doSaveState(), ShowFoto::ShowfotoStackViewSideBar::doSaveState(), Digikam::FaceScanWidget::doSaveState(), Digikam::FuzzySearchView::doSaveState(), Digikam::GPSSearchView::doSaveState(), Digikam::FuzzySearchSideBarWidget::FuzzySearchSideBarWidget(), Digikam::GPSSearchSideBarWidget::GPSSearchSideBarWidget(), Digikam::LabelsSideBarWidget::LabelsSideBarWidget(), Digikam::PeopleSideBarWidget::PeopleSideBarWidget(), Digikam::SearchSideBarWidget::SearchSideBarWidget(), Digikam::TagsManager::setupUi(), Digikam::TagViewSideBarWidget::TagViewSideBarWidget(), and Digikam::TimelineSideBarWidget::TimelineSideBarWidget().

◆ getStateSavingDepth()

StateSavingObject::StateSavingDepth Digikam::StateSavingObject::getStateSavingDepth ( ) const
inherited

Returns the depth used for state saving or loading. Default is StateSavingDepth::INSTANCE.

Returns
state saving / restoring depth

◆ handleCustomContextMenuAction()

void Digikam::AbstractAlbumTreeView::handleCustomContextMenuAction ( QAction *  action,
const AlbumPointer< Album > &  album 
)
protectedvirtualinherited

Hook method to handle the custom context menu actions that were added with addCustomContextMenuActions.

Parameters
actionthe action that was chosen by the user, may be null if none of the custom actions were selected
albumthe tag on which the context menu was requested. May be null if there was no

Reimplemented in Digikam::NormalSearchTreeView, Digikam::EditableSearchTreeView, Digikam::TagFolderView, Digikam::AlbumSelectTreeView, and Digikam::TagFilterView.

◆ indexVisuallyAt()

QModelIndex Digikam::AbstractAlbumTreeView::indexVisuallyAt ( const QPoint &  p)
inherited

This is a combination of indexAt() checked with visualRect(). p must be in the viewport currently. Decoration will not be included. Suitable for mouse click positions.

Referenced by Digikam::AbstractAlbumTreeView::dragMoveEvent(), Digikam::AbstractAlbumTreeView::dropEvent(), and Digikam::AbstractAlbumTreeView::mousePressEvent().

◆ isRestoreCheckState()

bool Digikam::AbstractCheckableAlbumTreeView::isRestoreCheckState ( ) const
inherited

Tells if the check state is restored while loading / saving state.

Returns
true if restoring check state is active

References Digikam::AbstractAlbumTreeView::m_restoreCheckState.

Referenced by Digikam::TagFilterView::addCustomContextMenuActions().

◆ loadState()

void Digikam::StateSavingObject::loadState ( )
inherited

Invokes loading the class' state.

References Digikam::StateSavingObject::doLoadState().

Referenced by Digikam::FuzzySearchView::doLoadState(), Digikam::SearchTextBar::SearchTextBar(), ShowFoto::Showfoto::Showfoto(), and Digikam::TagsManager::TagsManager().

◆ middleButtonPressed()

void Digikam::AbstractCheckableAlbumTreeView::middleButtonPressed ( Album *  a)
overrideprotectedvirtualinherited

Reimplemented from Digikam::AbstractAlbumTreeView.

References Digikam::AbstractCheckableAlbumModel::checkState(), Digikam::AbstractCheckableAlbumModel::isCheckable(), Digikam::AbstractCheckableAlbumModel::isTristate(), Digikam::AbstractAlbumTreeView::m_albumModel, Digikam::AbstractCheckableAlbumModel::setCheckState(), and Digikam::AbstractCheckableAlbumModel::toggleChecked().

◆ mousePressEvent()

void Digikam::AbstractAlbumTreeView::mousePressEvent ( QMouseEvent *  e)
overrideprotectedinherited

Other helper methods.

References Digikam::AlbumFilterModel::albumForIndex(), Digikam::AbstractAlbumTreeView::Private::expandNewCurrent, Digikam::AbstractAlbumTreeView::Private::expandOnSingleClick, Digikam::AbstractAlbumTreeView::indexVisuallyAt(), Digikam::AbstractAlbumTreeView::m_albumFilterModel, Digikam::AbstractAlbumTreeView::m_checkOnMiddleClick, and Digikam::AbstractAlbumTreeView::middleButtonPressed().

◆ pixmapForDrag()

QPixmap Digikam::AbstractAlbumTreeView::pixmapForDrag ( const QStyleOptionViewItem &  option,
QList< QModelIndex >  indexes 
)
protectedvirtualinherited

TODO: Move to delegate, when we have one. Copy code from image delegate for creating icons when dragging multiple items

Referenced by Digikam::AbstractAlbumTreeView::startDrag().

◆ removeContextMenuElement()

void Digikam::AbstractAlbumTreeView::removeContextMenuElement ( ContextMenuElement *const  element)
inherited

References Digikam::AbstractAlbumTreeView::Private::contextMenuElements.

◆ rowsAboutToBeRemoved()

void Digikam::AbstractAlbumTreeView::rowsAboutToBeRemoved ( const QModelIndex &  parent,
int  start,
int  end 
)
overrideprotectedinherited

References Digikam::AbstractAlbumModel::albumForIndex(), Digikam::AbstractAlbumTreeView::albumModel(), Digikam::Album::id(), and Digikam::AbstractAlbumTreeView::Private::statesByAlbumId.

◆ rowsInserted()

void Digikam::AbstractCheckableAlbumTreeView::rowsInserted ( const QModelIndex &  parent,
int  start,
int  end 
)
overrideprotectedinherited

References Digikam::AbstractCheckableAlbumTreeView::checkableModel(), Digikam::AbstractAlbumModel::index(), and Digikam::AbstractCountingAlbumTreeView::rowsInserted().

◆ saveState()

void Digikam::StateSavingObject::saveState ( )
inherited

Invokes saving the class' state.

References Digikam::StateSavingObject::doSaveState().

Referenced by Digikam::ImageWindow::closeEvent(), Digikam::FuzzySearchView::doSaveState(), Digikam::DateFolderView::~DateFolderView(), Digikam::SearchTextBar::~SearchTextBar(), Digikam::Sidebar::~Sidebar(), and Digikam::TagsManager::~TagsManager().

◆ scrollToSelectedAlbum

void Digikam::AbstractAlbumTreeView::scrollToSelectedAlbum ( )
slotinherited

Scrolls to the first selected album if there is one.

Referenced by Digikam::AbstractAlbumTreeView::doLoadState().

◆ selectedAlbumsChanged

void Digikam::AbstractAlbumTreeView::selectedAlbumsChanged ( const QList< Album * > &  selectedAlbums)
signalinherited

Emitted when the current selection changes. Use currentChanged unless in multi-selection mode.

◆ selectedItems()

QList< Album * > Digikam::AbstractAlbumTreeView::selectedItems ( )
inherited

selectedItems() -

References Digikam::AbstractAlbumTreeView::m_albumFilterModel.

Referenced by Digikam::TagMngrTreeView::contextMenuEvent(), Digikam::TagFolderView::contextMenuEvent(), and Digikam::TagDragDropHandler::dropEvent().

◆ setAlbumFilterModel() [1/2]

void Digikam::AbstractCountingAlbumTreeView::setAlbumFilterModel ( AlbumFilterModel *const  filterModel)
protectedinherited

References Digikam::AbstractAlbumTreeView::setAlbumFilterModel().

Referenced by Digikam::AbstractCheckableAlbumTreeView::AbstractCheckableAlbumTreeView(), Digikam::AbstractCountingAlbumTreeView::AbstractCountingAlbumTreeView(), Digikam::DateTreeView::setAlbumFilterModel(), Digikam::AlbumTreeView::setAlbumFilterModel(), Digikam::SearchTreeView::setAlbumFilterModel(), and Digikam::TagTreeView::setAlbumFilterModel().

◆ setAlbumFilterModel() [2/2]

void Digikam::AlbumTreeView::setAlbumFilterModel ( CheckableAlbumFilterModel *const  filterModel)
inherited

References Digikam::AbstractCountingAlbumTreeView::setAlbumFilterModel().

Referenced by Digikam::AlbumTreeViewSelectComboBox::setAlbumModels().

◆ setAlbumManagerCurrentAlbum()

void Digikam::AbstractAlbumTreeView::setAlbumManagerCurrentAlbum ( const bool  setCurrentAlbum)
inherited

Some treeviews shall control the global current album kept by AlbumManager. Other treeview are self-contained and shall not change the current album. Default: false

References Digikam::AbstractAlbumTreeView::Private::setInAlbumManager.

Referenced by Digikam::FuzzySearchView::FuzzySearchView().

◆ setAlbumModel() [1/3]

void Digikam::AbstractCountingAlbumTreeView::setAlbumModel ( AbstractCountingAlbumModel *const  model)
protectedinherited

References Digikam::AbstractAlbumTreeView::m_flags, Digikam::AbstractAlbumTreeView::setAlbumModel(), and Digikam::AbstractAlbumTreeView::ShowCountAccordingToSettings.

Referenced by Digikam::AlbumTreeView::setAlbumModel(), Digikam::DateTreeView::setAlbumModel(), Digikam::SearchTreeView::setAlbumModel(), and Digikam::TagTreeView::setAlbumModel().

◆ setAlbumModel() [2/3]

void Digikam::AbstractAlbumTreeView::setAlbumModel ( AbstractSpecificAlbumModel *const  model)
protectedinherited

References Digikam::AbstractAlbumTreeView::m_albumFilterModel, Digikam::AbstractAlbumTreeView::m_albumModel, Digikam::AbstractAlbumModel::rootAlbum(), Digikam::AlbumFilterModel::rootAlbumIndex(), Digikam::AlbumFilterModel::setSourceAlbumModel(), and Digikam::AbstractAlbumTreeView::slotRootAlbumAvailable().

Referenced by Digikam::AbstractCountingAlbumTreeView::setAlbumModel().

◆ setAlbumModel() [3/3]

void Digikam::AlbumTreeView::setAlbumModel ( AlbumModel *const  model)
inherited

References Digikam::AlbumTreeView::albumModel(), Digikam::AbstractAlbumModel::dragDropHandler(), Digikam::AbstractAlbumTreeView::m_albumModel, Digikam::AbstractAlbumTreeView::m_dragDropHandler, Digikam::AbstractCountingAlbumTreeView::setAlbumModel(), and Digikam::AbstractAlbumModel::setDragDropHandler().

Referenced by AlbumSelectionTreeView(), Digikam::AlbumSelectTreeView::AlbumSelectTreeView(), Digikam::AlbumTreeView::AlbumTreeView(), and Digikam::AlbumTreeViewSelectComboBox::setAlbumModels().

◆ setCheckOnMiddleClick()

void Digikam::AbstractCheckableAlbumTreeView::setCheckOnMiddleClick ( bool  doThat)
inherited

Enable checking on middle mouse button click (default: on)

References Digikam::AbstractAlbumTreeView::m_checkOnMiddleClick.

◆ setConfigGroup()

void Digikam::StateSavingObject::setConfigGroup ( const KConfigGroup &  group)
virtualinherited

Sets a dedicated config group that will be used to store and reload the state from. If this method is not called, a group based on the object name is used.

You can re-implement this method to pass the group set here to child objects. Don't forget to call this method in your implementation.

Parameters
groupconfig group to use for state saving and restoring

Reimplemented in Digikam::GPSSearchView, Digikam::FuzzySearchView, Digikam::FilterSideBarWidget, and Digikam::DateFolderView.

Referenced by Digikam::ImageWindow::closeEvent(), Digikam::DateFolderView::setConfigGroup(), Digikam::FilterSideBarWidget::setConfigGroup(), Digikam::FuzzySearchView::setConfigGroup(), and Digikam::GPSSearchView::setConfigGroup().

◆ setContextMenuIcon()

void Digikam::AbstractAlbumTreeView::setContextMenuIcon ( const QPixmap &  pixmap)
inherited

Set the context menu title and icon. This is used by the default implementation of contextMenuIcon() and contextMenuTitle(). You can alternatively reimplement these methods.

References Digikam::AbstractAlbumTreeView::Private::contextMenuIcon.

◆ setContextMenuTitle()

void Digikam::AbstractAlbumTreeView::setContextMenuTitle ( const QString &  title)
inherited

References Digikam::AbstractAlbumTreeView::Private::contextMenuTitle.

Referenced by AlbumSelectionTreeView().

◆ setCurrentAlbum

void Digikam::AlbumTreeView::setCurrentAlbum ( int  albumId,
bool  selectInAlbumManager = true 
)
slotinherited

References Digikam::AlbumManager::findPAlbum(), Digikam::AlbumManager::instance(), and Digikam::AlbumTreeView::setCurrentAlbums().

◆ setCurrentAlbums

void Digikam::AlbumTreeView::setCurrentAlbums ( const QList< Album * > &  albums,
bool  selectInAlbumManager = true 
)
slotinherited

References Digikam::AbstractAlbumTreeView::setCurrentAlbums().

Referenced by Digikam::AlbumTreeView::setCurrentAlbum(), and Digikam::AlbumSelectTreeView::slotNewAlbum().

◆ setEnableContextMenu()

void Digikam::AbstractAlbumTreeView::setEnableContextMenu ( const bool  enable)
inherited

Determines the global decision to show a popup menu or not. More detailed decision at which position a menu can be shown and where not can be made by implementing showContextMenuAt.

Parameters
enableif true, a context menu can be shown

References Digikam::AbstractAlbumTreeView::Private::enableContextMenu.

Referenced by Digikam::AbstractAlbumTreeViewSelectComboBox::addCheckUncheckContextMenuActions(), AlbumSelectionTreeView(), Digikam::EditableSearchTreeView::EditableSearchTreeView(), and Digikam::TagFolderView::TagFolderView().

◆ setEnableToolTips()

void Digikam::AlbumSelectionTreeView::setEnableToolTips ( bool  enable)

Sets whether this widget shall display tool tips or not.

◆ setEntryPrefix()

void Digikam::StateSavingObject::setEntryPrefix ( const QString &  prefix)
virtualinherited

Define a prefix that will be used for every entry in the config group. The default prefix is empty.

You can re-implement this method to pass the prefix set here to child objects. Don't forget to call this method in your implementation.

Parameters
prefixthe prefix to use for the config entries

References prefix.

◆ setExpandNewCurrentItem()

void Digikam::AbstractAlbumTreeView::setExpandNewCurrentItem ( const bool  doThat)
inherited

Expand an item when making it the new current item

References Digikam::AbstractAlbumTreeView::Private::expandNewCurrent.

◆ setExpandOnSingleClick()

void Digikam::AbstractAlbumTreeView::setExpandOnSingleClick ( const bool  doThat)
inherited

Enable expanding of tree items on single click on the item (default: off)

References Digikam::AbstractAlbumTreeView::Private::expandOnSingleClick.

Referenced by Digikam::TagCheckView::TagCheckView().

◆ setRestoreCheckState()

void Digikam::AbstractCheckableAlbumTreeView::setRestoreCheckState ( bool  restore)
inherited

Set whether to restore check state or not.

Parameters
restoreif true, restore check state

References Digikam::AbstractAlbumTreeView::m_restoreCheckState.

Referenced by Digikam::TagFilterView::handleCustomContextMenuAction().

◆ setSearchTextSettings

void Digikam::AbstractAlbumTreeView::setSearchTextSettings ( const SearchTextSettings &  settings)
slotinherited

References Digikam::AbstractAlbumTreeView::m_albumFilterModel, and Digikam::AlbumFilterModel::setSearchTextSettings().

◆ setSelectAlbumOnClick()

void Digikam::AbstractAlbumTreeView::setSelectAlbumOnClick ( const bool  selectOnClick)
inherited

Sets whether to select an album on click via the album manager or not.

Parameters
selectOnClickif true, a click on an item automatically sets this item as the current album in the album manager

References Digikam::AbstractAlbumTreeView::Private::selectAlbumOnClick.

Referenced by AlbumSelectionTreeView(), Digikam::EditableSearchTreeView::EditableSearchTreeView(), Digikam::TagCheckView::TagCheckView(), Digikam::TagFolderView::TagFolderView(), and Digikam::TagMngrTreeView::TagMngrTreeView().

◆ setSelectOnContextMenu()

void Digikam::AbstractAlbumTreeView::setSelectOnContextMenu ( const bool  select)
inherited

Sets whether to select the album under the mouse cursor on a context menu request (so that the album is shown using the album manager) or not

Defaults to true.

Parameters
selecttrue if a context menu request shall select the album

References Digikam::AbstractAlbumTreeView::Private::selectOnContextMenu.

Referenced by Digikam::TagCheckView::TagCheckView().

◆ setStateSavingDepth()

void Digikam::StateSavingObject::setStateSavingDepth ( const StateSavingDepth  depth)
inherited

Sets the depth used for state saving or loading.

Parameters
depthnew depth to use

◆ showContextMenuAt()

bool Digikam::AbstractAlbumTreeView::showContextMenuAt ( QContextMenuEvent *  event,
Album *  albumForEvent 
)
protectedvirtualinherited

Hook method to implement that determines if a context menu shall be displayed for the given event at the position coded in the event.

Parameters
eventcontext menu event to react on
albumForEventthe album at the mouse position or null if there is no album at that position
Returns
true if a context menu shall be displayed at the event coordinates, else false

Referenced by Digikam::TagFolderView::contextMenuEvent().

◆ signalFindDuplicates

void Digikam::AlbumSelectionTreeView::signalFindDuplicates ( const QList< PAlbum * > &  albums)
signal

Emitted if a find duplicates search shall be invoked on the given album.

Parameters
albumthe album to find duplicates in

◆ slotCollapseAllNodes

void Digikam::AbstractAlbumTreeView::slotCollapseAllNodes ( )
slotinherited

slotCollapseAllNodes - collapse all nodes without root node

References Digikam::AbstractAlbumTreeView::m_albumFilterModel, and Digikam::AlbumFilterModel::rootAlbumIndex().

Referenced by Digikam::TagFolderView::addCustomContextMenuActions(), AlbumSelectionTreeView(), and Digikam::TagMngrTreeView::setContexMenuItems().

◆ slotCollapseNode

void Digikam::AbstractAlbumTreeView::slotCollapseNode ( )
slotinherited

slotCollapseNode - collapse recursively selected nodes

Referenced by Digikam::TagFolderView::addCustomContextMenuActions(), AlbumSelectionTreeView(), and Digikam::TagFolderView::setContexMenuItems().

◆ slotCurrentChanged

void Digikam::AbstractAlbumTreeView::slotCurrentChanged ( )
protectedslotinherited

References Digikam::AlbumFilterModel::albumForIndex(), Digikam::AbstractAlbumTreeView::currentAlbumChanged(), and Digikam::AbstractAlbumTreeView::m_albumFilterModel.

Referenced by Digikam::AbstractAlbumTreeView::setAlbumFilterModel().

◆ slotExpandNode

void Digikam::AbstractAlbumTreeView::slotExpandNode ( )
slotinherited

slotExpandNode - expands recursively selected nodes

Referenced by Digikam::TagFolderView::addCustomContextMenuActions(), AlbumSelectionTreeView(), Digikam::TagFolderView::setContexMenuItems(), and Digikam::TagMngrTreeView::setContexMenuItems().

◆ slotRootAlbumAvailable

void Digikam::AbstractAlbumTreeView::slotRootAlbumAvailable ( )
protectedvirtualslotinherited

override if implemented behavior is not as intended

References Digikam::AbstractAlbumTreeView::m_albumFilterModel, and Digikam::AlbumFilterModel::rootAlbumIndex().

Referenced by Digikam::AbstractAlbumTreeView::setAlbumModel().

◆ slotSearchTextSettingsAboutToChange

void Digikam::AbstractAlbumTreeView::slotSearchTextSettingsAboutToChange ( bool  searched,
bool  willSearch 
)
protectedslotinherited

References Digikam::AbstractAlbumTreeView::Private::lastSelectedAlbum, Digikam::AbstractAlbumTreeView::m_albumFilterModel, and Digikam::AbstractAlbumTreeView::Private::searchBackup.

Referenced by Digikam::AbstractAlbumTreeView::setAlbumFilterModel().

◆ slotSearchTextSettingsChanged

void Digikam::AbstractAlbumTreeView::slotSearchTextSettingsChanged ( bool  wasSearching,
bool  searching 
)
protectedslotinherited

References Digikam::AbstractAlbumTreeView::expandMatches(), Digikam::AlbumFilterModel::indexForAlbum(), Digikam::AbstractAlbumTreeView::Private::lastSelectedAlbum, Digikam::AbstractAlbumTreeView::m_albumFilterModel, Digikam::AbstractAlbumTreeView::Private::searchBackup, and Digikam::AbstractAlbumTreeView::setCurrentAlbums().

Referenced by Digikam::AbstractAlbumTreeView::setAlbumFilterModel().

◆ slotSelectionChanged

void Digikam::AbstractAlbumTreeView::slotSelectionChanged ( )
protectedslotinherited

References Digikam::AlbumManager::instance(), Digikam::AbstractAlbumTreeView::m_albumFilterModel, Digikam::AbstractAlbumTreeView::Private::selectAlbumOnClick, and Digikam::AlbumManager::setCurrentAlbums().

Referenced by Digikam::AbstractAlbumTreeView::setAlbumFilterModel().

◆ startDrag()

void Digikam::AbstractAlbumTreeView::startDrag ( Qt::DropActions  supportedActions)
overrideprotectedinherited

References Digikam::CopyAction, Digikam::AbstractAlbumTreeView::m_albumFilterModel, and Digikam::AbstractAlbumTreeView::pixmapForDrag().

Member Data Documentation

◆ m_albumFilterModel

AlbumFilterModel* Digikam::AbstractAlbumTreeView::m_albumFilterModel
protectedinherited

Referenced by Digikam::AbstractAlbumTreeView::albumFilterModel(), Digikam::AbstractCheckableAlbumTreeView::albumFilterModel(), Digikam::AlbumTreeView::albumForIndex(), Digikam::DateTreeView::albumForIndex(), Digikam::TagTreeView::albumForIndex(), Digikam::AlbumTreeView::currentAlbum(), Digikam::DateTreeView::currentAlbum(), Digikam::SearchTreeView::currentAlbum(), Digikam::TagTreeView::currentAlbum(), Digikam::AbstractAlbumTreeView::dragMoveEvent(), Digikam::AbstractAlbumTreeView::dropEvent(), Digikam::AbstractAlbumTreeView::expandMatches(), Digikam::AbstractAlbumTreeView::mousePressEvent(), Digikam::AbstractCountingAlbumTreeView::rowsInserted(), Digikam::AbstractAlbumTreeView::selectedItems(), Digikam::AbstractAlbumTreeView::setAlbumFilterModel(), Digikam::AbstractAlbumTreeView::setAlbumModel(), Digikam::TagTreeView::setAlbumModel(), Digikam::AbstractAlbumTreeView::setSearchTextSettings(), Digikam::AbstractAlbumTreeView::slotCollapseAllNodes(), Digikam::AbstractAlbumTreeView::slotCurrentChanged(), Digikam::AbstractAlbumTreeView::slotRootAlbumAvailable(), Digikam::AbstractAlbumTreeView::slotSearchTextSettingsAboutToChange(), Digikam::AbstractAlbumTreeView::slotSearchTextSettingsChanged(), Digikam::AbstractAlbumTreeView::slotSelectionChanged(), and Digikam::AbstractAlbumTreeView::startDrag().

◆ m_albumModel

AbstractSpecificAlbumModel* Digikam::AbstractAlbumTreeView::m_albumModel
protectedinherited

Referenced by Digikam::AbstractAlbumTreeView::albumModel(), Digikam::AbstractCheckableAlbumTreeView::albumModel(), Digikam::AlbumTreeView::albumModel(), Digikam::DateTreeView::albumModel(), Digikam::SearchTreeView::albumModel(), Digikam::TagTreeView::albumModel(), Digikam::AbstractAlbumTreeView::dragEnterEvent(), Digikam::AbstractAlbumTreeView::dragMoveEvent(), Digikam::AbstractAlbumTreeView::dropEvent(), Digikam::AbstractCheckableAlbumTreeView::middleButtonPressed(), Digikam::AbstractAlbumTreeView::setAlbumFilterModel(), Digikam::AbstractAlbumTreeView::setAlbumModel(), Digikam::AlbumTreeView::setAlbumModel(), and Digikam::TagTreeView::setAlbumModel().

◆ m_checkOnMiddleClick

bool Digikam::AbstractAlbumTreeView::m_checkOnMiddleClick
protectedinherited

Referenced by Digikam::AbstractCheckableAlbumTreeView::AbstractCheckableAlbumTreeView(), Digikam::AbstractAlbumTreeView::mousePressEvent(), and Digikam::AbstractCheckableAlbumTreeView::setCheckOnMiddleClick().

◆ m_dragDropHandler

AlbumModelDragDropHandler* Digikam::AbstractAlbumTreeView::m_dragDropHandler
protectedinherited

Referenced by Digikam::AlbumTreeView::setAlbumModel(), and Digikam::TagTreeView::setAlbumModel().

◆ m_flags

Flags Digikam::AbstractAlbumTreeView::m_flags
protectedinherited

Referenced by Digikam::AbstractCountingAlbumTreeView::setAlbumModel().

◆ m_lastScrollBarValue

int Digikam::AbstractAlbumTreeView::m_lastScrollBarValue
protectedinherited

◆ m_restoreCheckState

bool Digikam::AbstractAlbumTreeView::m_restoreCheckState
protectedinherited

Referenced by Digikam::AbstractCheckableAlbumTreeView::AbstractCheckableAlbumTreeView(), Digikam::AbstractCheckableAlbumTreeView::doLoadState(), Digikam::AbstractCheckableAlbumTreeView::doSaveState(), Digikam::AbstractCheckableAlbumTreeView::isRestoreCheckState(), and Digikam::AbstractCheckableAlbumTreeView::setRestoreCheckState().

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