Digikam::TableView Class Reference

Inheritance diagram for Digikam::TableView:

Public Types
enum	StateSavingDepth { INSTANCE , DIRECT_CHILDREN , RECURSIVE }

Public Slots
void	rename ()
void	slotAwayFromSelection ()
	Unselects the current selection and changes the current item. More...
void	slotDeleteSelected (const ItemViewUtilities::DeleteMode deleteMode=ItemViewUtilities::DeleteUseTrash)
void	slotDeleteSelectedWithoutConfirmation (const ItemViewUtilities::DeleteMode deleteMode=ItemViewUtilities::DeleteUseTrash)
void	slotGoToRow (const int rowNumber, const bool relativeMove)
void	slotPaste ()
void	slotSetActive (const bool isActive)
void	slotSetCurrentUrlWhenAvailable (const QUrl &url)
void	slotSetCurrentWhenAvailable (const qlonglong id)

Signals
void	signalInsertSelectedToExistingQueue (int queue)
void	signalItemsChanged ()
void	signalPopupTagsView ()
void	signalPreviewRequested (const ItemInfo &info)
void	signalShowContextMenu (QContextMenuEvent *event, const QList< QAction * > &actions)
void	signalShowContextMenuOnInfo (QContextMenuEvent *event, const ItemInfo &info, const QList< QAction * > &actions, ItemFilterModel *filterModel=nullptr)
void	signalZoomInStep ()
void	signalZoomOutStep ()

Public Member Functions
ItemInfoList	allItemInfos (bool grouping=false) const
bool	allNeedGroupResolving (const ApplicationSettings::OperationType type) const
void	clearSelection ()
Album *	currentAlbum () const
ItemInfo	currentInfo () const
ItemInfo	deepRowItemInfo (const int rowNumber, const bool relative) const
StateSavingDepth	getStateSavingDepth () const
ThumbnailSize	getThumbnailSize () const
void	invertSelection ()
void	loadState ()
ItemInfo	nextInfo () const
int	numberOfSelectedItems () const
ItemInfo	previousInfo () const
void	saveState ()
void	selectAll ()
ItemInfoList	selectedItemInfos (bool grouping=false) const
ItemInfoList	selectedItemInfosCurrentFirst (bool grouping=false) const
bool	selectedNeedGroupResolving (const ApplicationSettings::OperationType type) const
virtual void	setConfigGroup (const KConfigGroup &group)
virtual void	setEntryPrefix (const QString &prefix)
void	setStateSavingDepth (const StateSavingDepth depth)
void	setThumbnailSize (const ThumbnailSize &size)
	TableView (QItemSelectionModel *const selectionModel, DCategorizedSortFilterProxyModel *const imageFilterModel, QWidget *const parent)
	~TableView () override

Protected Slots
void	slotGroupingModeActionTriggered ()
void	slotItemActivated (const QModelIndex &tableViewIndex)

Protected Member Functions
void	doLoadState () override
void	doSaveState () override
QString	entryName (const QString &base) const
bool	eventFilter (QObject *watched, QEvent *event) override
KConfigGroup	getConfigGroup () const
QList< QAction * >	getExtraGroupingActions ()

Member Enumeration Documentation

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

TableView()

Digikam::TableView::TableView ( QItemSelectionModel *const  selectionModel, DCategorizedSortFilterProxyModel *const  imageFilterModel, QWidget *const  parent  )

explicit

References signalItemsChanged(), signalZoomInStep(), signalZoomOutStep(), and slotItemActivated().

~TableView()

Digikam::TableView::~TableView ( )

override

Member Function Documentation

allItemInfos()

ItemInfoList Digikam::TableView::allItemInfos

(

bool

grouping = false

)

const

Referenced by Digikam::ItemIconView::allInfo(), allNeedGroupResolving(), slotItemActivated(), and slotSetCurrentUrlWhenAvailable().

allNeedGroupResolving()

bool Digikam::TableView::allNeedGroupResolving

(

const ApplicationSettings::OperationType

type

)

const

References allItemInfos().

Referenced by Digikam::ItemIconView::allNeedGroupResolving().

clearSelection()

void Digikam::TableView::clearSelection

(

)

Referenced by Digikam::ItemIconView::slotSelectNone().

currentAlbum()

Album * Digikam::TableView::currentAlbum

(

)

const

References Digikam::ItemAlbumModel::currentAlbums().

Referenced by Digikam::ItemIconView::currentAlbum(), and slotItemActivated().

currentInfo()

ItemInfo Digikam::TableView::currentInfo

(

)

const

Referenced by Digikam::ItemIconView::currentInfo().

deepRowItemInfo()

ItemInfo Digikam::TableView::deepRowItemInfo	(	const int	rowNumber,
		const bool	relative
	)		const

doLoadState()

void Digikam::TableView::doLoadState ( )

overrideprotectedvirtual

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

Implements Digikam::StateSavingObject.

References Digikam::StateSavingObject::getConfigGroup(), Digikam::TableViewModel::GroupingShowSubItems, Digikam::TableViewColumnProfile::headerState, and Digikam::TableViewColumnProfile::loadSettings().

doSaveState()

void Digikam::TableView::doSaveState ( )

overrideprotectedvirtual

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

Implements Digikam::StateSavingObject.

References Digikam::StateSavingObject::getConfigGroup(), Digikam::TableViewColumnProfile::headerState, and Digikam::TableViewColumnProfile::saveSettings().

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

base	original 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().

eventFilter()

bool Digikam::TableView::eventFilter ( QObject *  watched, QEvent *  event  )

overrideprotected

References getExtraGroupingActions(), signalShowContextMenu(), and signalShowContextMenuOnInfo().

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(), 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(), 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().

getExtraGroupingActions()

QList< QAction * > Digikam::TableView::getExtraGroupingActions ( )

protected

References Digikam::TableViewModel::GroupingHideGrouped, Digikam::TableViewModel::GroupingIgnoreGrouping, Digikam::TableViewModel::GroupingShowSubItems, and slotGroupingModeActionTriggered().

Referenced by eventFilter().

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

getThumbnailSize()

ThumbnailSize Digikam::TableView::getThumbnailSize

(

)

const

invertSelection()

void Digikam::TableView::invertSelection

(

)

Referenced by Digikam::ItemIconView::slotSelectInvert().

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().

nextInfo()

ItemInfo Digikam::TableView::nextInfo

(

)

const

numberOfSelectedItems()

int Digikam::TableView::numberOfSelectedItems

(

)

const

previousInfo()

ItemInfo Digikam::TableView::previousInfo

(

)

const

rename

void Digikam::TableView::rename ( )

slot

References Digikam::ApplicationSettings::Rename, selectedItemInfos(), slotAwayFromSelection(), and Digikam::ItemInfoList::toImageUrlList().

Referenced by Digikam::ItemIconView::slotImageRename().

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().

selectAll()

void Digikam::TableView::selectAll

(

)

Referenced by Digikam::ItemIconView::slotSelectAll().

selectedItemInfos()

ItemInfoList Digikam::TableView::selectedItemInfos

(

bool

grouping = false

)

const

Referenced by rename(), Digikam::ItemIconView::selectedInfoList(), selectedNeedGroupResolving(), slotDeleteSelected(), and slotDeleteSelectedWithoutConfirmation().

selectedItemInfosCurrentFirst()

ItemInfoList Digikam::TableView::selectedItemInfosCurrentFirst

(

bool

grouping = false

)

const

Referenced by Digikam::ItemIconView::selectedInfoList().

selectedNeedGroupResolving()

bool Digikam::TableView::selectedNeedGroupResolving

(

const ApplicationSettings::OperationType

type

)

const

References selectedItemInfos().

Referenced by Digikam::ItemIconView::selectedNeedGroupResolving().

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

group

config 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().

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

prefix

the prefix to use for the config entries

References prefix.

setStateSavingDepth()

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

inherited

Sets the depth used for state saving or loading.

Parameters

depth

new depth to use

setThumbnailSize()

void Digikam::TableView::setThumbnailSize

(

const ThumbnailSize &

size

)

References Digikam::TableViewColumn::updateThumbnailSize().

signalInsertSelectedToExistingQueue

void Digikam::TableView::signalInsertSelectedToExistingQueue ( int  queue )

signal

signalItemsChanged

void Digikam::TableView::signalItemsChanged ( )

signal

Referenced by TableView().

signalPopupTagsView

void Digikam::TableView::signalPopupTagsView ( )

signal

signalPreviewRequested

void Digikam::TableView::signalPreviewRequested ( const ItemInfo &  info )

signal

Referenced by slotItemActivated().

signalShowContextMenu

void Digikam::TableView::signalShowContextMenu ( QContextMenuEvent *  event, const QList< QAction * > &  actions  )

signal

Referenced by eventFilter().

signalShowContextMenuOnInfo

void Digikam::TableView::signalShowContextMenuOnInfo ( QContextMenuEvent *  event, const ItemInfo &  info, const QList< QAction * > &  actions, ItemFilterModel *  filterModel = nullptr  )

signal

Referenced by eventFilter().

signalZoomInStep

void Digikam::TableView::signalZoomInStep ( )

signal

Referenced by TableView().

signalZoomOutStep

void Digikam::TableView::signalZoomOutStep ( )

signal

Referenced by TableView().

slotAwayFromSelection

void Digikam::TableView::slotAwayFromSelection ( )

slot

Unselects the current selection and changes the current item.

Referenced by rename(), slotDeleteSelected(), and slotDeleteSelectedWithoutConfirmation().

slotDeleteSelected

void Digikam::TableView::slotDeleteSelected ( const ItemViewUtilities::DeleteMode  deleteMode = ItemViewUtilities::DeleteUseTrash )

slot

References Digikam::ApplicationSettings::getAllGroupsOpen(), Digikam::ApplicationSettings::instance(), selectedItemInfos(), and slotAwayFromSelection().

Referenced by Digikam::ItemIconView::slotImageDelete(), and Digikam::ItemIconView::slotImageDeletePermanently().

slotDeleteSelectedWithoutConfirmation

void Digikam::TableView::slotDeleteSelectedWithoutConfirmation ( const ItemViewUtilities::DeleteMode  deleteMode = ItemViewUtilities::DeleteUseTrash )

slot

References Digikam::ApplicationSettings::getAllGroupsOpen(), Digikam::ApplicationSettings::instance(), selectedItemInfos(), and slotAwayFromSelection().

Referenced by Digikam::ItemIconView::slotImageDeletePermanentlyDirectly(), and Digikam::ItemIconView::slotImageTrashDirectly().

slotGoToRow

void Digikam::TableView::slotGoToRow ( const int  rowNumber, const bool  relativeMove  )

slot

slotGroupingModeActionTriggered

void Digikam::TableView::slotGroupingModeActionTriggered ( )

protectedslot

Referenced by getExtraGroupingActions().

slotItemActivated

void Digikam::TableView::slotItemActivated ( const QModelIndex &  tableViewIndex )

protectedslot

References allItemInfos(), currentAlbum(), Digikam::ApplicationSettings::getItemLeftClickAction(), Digikam::ApplicationSettings::instance(), Digikam::ItemInfo::isNull(), Digikam::ApplicationSettings::ShowOnTable, Digikam::ApplicationSettings::ShowPreview, signalPreviewRequested(), and Digikam::ApplicationSettings::StartEditor.

Referenced by TableView().

slotPaste

void Digikam::TableView::slotPaste ( )

slot

References Digikam::DragDropViewImplementation::paste().

Referenced by Digikam::ItemIconView::slotImagePaste().

slotSetActive

void Digikam::TableView::slotSetActive ( const bool  isActive )

slot

slotSetCurrentUrlWhenAvailable

void Digikam::TableView::slotSetCurrentUrlWhenAvailable ( const QUrl &  url )

slot

References allItemInfos(), Digikam::ItemInfo::fileUrl(), Digikam::ItemInfo::id(), and slotSetCurrentWhenAvailable().

Referenced by Digikam::ItemIconView::slotSetCurrentUrlWhenAvailable().

slotSetCurrentWhenAvailable

void Digikam::TableView::slotSetCurrentWhenAvailable ( const qlonglong  id )

slot

Referenced by slotSetCurrentUrlWhenAvailable(), and Digikam::ItemIconView::slotSetCurrentWhenAvailable().

---

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

• core/app/views/tableview/tableview.h
• core/app/views/tableview/tableview.cpp