digiKam
Classes | Public Slots | Public Member Functions | Protected Slots | Protected Member Functions | List of all members
Digikam::DCategorizedView Class Reference

Item view for listing items. More...

+ Inheritance diagram for Digikam::DCategorizedView:

Classes

class  Private
 

Public Slots

void reset () override
 

Public Member Functions

virtual QModelIndexList categorizedIndexesIn (const QRect &rect) const
 
virtual QModelIndex categoryAt (const QPoint &point) const
 
DCategoryDrawer * categoryDrawer () const
 
virtual QItemSelectionRange categoryRange (const QModelIndex &index) const
 
virtual QRect categoryVisualRect (const QModelIndex &index) const
 
 DCategorizedView (QWidget *const parent=nullptr)
 
QModelIndex indexAt (const QPoint &point) const override
 
void setCategoryDrawer (DCategoryDrawer *categoryDrawer)
 
void setDrawDraggedItems (bool drawDraggedItems)
 
void setGridSize (const QSize &size)
 
void setModel (QAbstractItemModel *model) override
 
QRect visualRect (const QModelIndex &index) const override
 
 ~DCategorizedView () override
 

Protected Slots

void currentChanged (const QModelIndex &current, const QModelIndex &previous) override
 
void rowsInserted (const QModelIndex &parent, int start, int end) override
 
virtual void rowsInsertedArtifficial (const QModelIndex &parent, int start, int end)
 
virtual void rowsRemoved (const QModelIndex &parent, int start, int end)
 
virtual void slotLayoutChanged ()
 
void updateGeometries () override
 

Protected Member Functions

void dragLeaveEvent (QDragLeaveEvent *event) override
 
void dragMoveEvent (QDragMoveEvent *event) override
 
void dropEvent (QDropEvent *event) override
 
void leaveEvent (QEvent *event) override
 
void mouseMoveEvent (QMouseEvent *event) override
 
void mousePressEvent (QMouseEvent *event) override
 
void mouseReleaseEvent (QMouseEvent *event) override
 
QModelIndex moveCursor (CursorAction cursorAction, Qt::KeyboardModifiers modifiers) override
 
void paintEvent (QPaintEvent *event) override
 
void resizeEvent (QResizeEvent *event) override
 
void setSelection (const QRect &rect, QItemSelectionModel::SelectionFlags flags) override
 
void startDrag (Qt::DropActions supportedActions) override
 

Detailed Description

Item view for listing items.

DCategorizedView allows you to use it as it were a QListView. Subclass DCategorizedSortFilterProxyModel to provide category information for items.

Constructor & Destructor Documentation

◆ DCategorizedView()

Digikam::DCategorizedView::DCategorizedView ( QWidget *const  parent = nullptr)
explicit

◆ ~DCategorizedView()

Digikam::DCategorizedView::~DCategorizedView ( )
override

Member Function Documentation

◆ categorizedIndexesIn()

QModelIndexList Digikam::DCategorizedView::categorizedIndexesIn ( const QRect &  rect) const
virtual

This method will return all indexes whose visual rect intersects rect.

Parameters
rectrectangle to test intersection with
Note
Returns an empty list if the view is not categorized.

References Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedView::Private::intersectionSet(), Digikam::DCategorizedSortFilterProxyModel::isCategorizedModel(), and Digikam::DCategorizedView::Private::proxyModel.

◆ categoryAt()

QModelIndex Digikam::DCategorizedView::categoryAt ( const QPoint &  point) const
virtual

This method will return the first index of the category in the region of which point is found.

Note
Returns QModelIndex() if the view is not categorized.

References Digikam::DCategorizedView::Private::categories, Digikam::DCategorizedView::Private::categoriesIndexes, Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedView::Private::categoryVisualRect(), Digikam::DCategorizedSortFilterProxyModel::isCategorizedModel(), Digikam::DCategorizedView::Private::proxyModel, and Digikam::DCategorizedSortFilterProxyModel::sortColumn().

Referenced by Digikam::ItemViewCategorized::indexForCategoryAt().

◆ categoryDrawer()

DCategoryDrawer * Digikam::DCategorizedView::categoryDrawer ( ) const

References Digikam::DCategorizedView::Private::categoryDrawer.

Referenced by Digikam::DCategorizedView::Private::drawNewCategory(), setCategoryDrawer(), Digikam::DCategorizedView::Private::visualCategoryRectInViewport(), and Digikam::DCategorizedView::Private::visualRectInViewport().

◆ categoryRange()

QItemSelectionRange Digikam::DCategorizedView::categoryRange ( const QModelIndex &  index) const
virtual

This method returns the range of indexes contained in the category in which index is sorted.

Note
Returns an empty range if the view is no categorized.

References Digikam::DCategorizedView::Private::categoriesIndexes, Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedView::Private::elementsInfo, Digikam::DCategorizedSortFilterProxyModel::isCategorizedModel(), Digikam::DCategorizedView::Private::proxyModel, and Digikam::DCategorizedSortFilterProxyModel::sortColumn().

◆ categoryVisualRect()

QRect Digikam::DCategorizedView::categoryVisualRect ( const QModelIndex &  index) const
virtual

This method will return the visual rect of the header of the category in which index is sorted.

Note
Returns QRect() if the view is not categorized.

References Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedView::Private::categoryVisualRect(), Digikam::DCategorizedView::Private::elementsInfo, Digikam::DCategorizedSortFilterProxyModel::isCategorizedModel(), and Digikam::DCategorizedView::Private::proxyModel.

◆ currentChanged

void Digikam::DCategorizedView::currentChanged ( const QModelIndex &  current,
const QModelIndex &  previous 
)
overrideprotectedslot

References Digikam::DCategorizedView::Private::biggestItemSize, Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedView::Private::elementsInfo, Digikam::DCategorizedView::Private::forcedSelectionPosition, Digikam::DCategorizedSortFilterProxyModel::isCategorizedModel(), and Digikam::DCategorizedView::Private::proxyModel.

Referenced by Digikam::ItemCategorizedView::currentChanged(), and Digikam::ImportCategorizedView::currentChanged().

◆ dragLeaveEvent()

void Digikam::DCategorizedView::dragLeaveEvent ( QDragLeaveEvent *  event)
overrideprotected

References Digikam::DCategorizedView::Private::dragLeftViewport.

◆ dragMoveEvent()

void Digikam::DCategorizedView::dragMoveEvent ( QDragMoveEvent *  event)
overrideprotected

References Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedView::Private::dragLeftViewport, Digikam::DCategorizedView::Private::drawDraggedItems(), Digikam::DCategorizedView::Private::hovered, indexAt(), Digikam::DCategorizedSortFilterProxyModel::isCategorizedModel(), Digikam::DCategorizedView::Private::mousePosition, and Digikam::DCategorizedView::Private::proxyModel.

◆ dropEvent()

void Digikam::DCategorizedView::dropEvent ( QDropEvent *  event)
overrideprotected

◆ indexAt()

QModelIndex Digikam::DCategorizedView::indexAt ( const QPoint &  point) const
override

References Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedView::Private::intersectionSet(), Digikam::DCategorizedSortFilterProxyModel::isCategorizedModel(), and Digikam::DCategorizedView::Private::proxyModel.

Referenced by Digikam::ItemViewCategorized::contextMenuEvent(), dragMoveEvent(), Digikam::ItemViewCategorized::mouseMoveEvent(), Digikam::ItemViewCategorized::mousePressEvent(), and Digikam::ItemViewCategorized::viewportEvent().

◆ leaveEvent()

void Digikam::DCategorizedView::leaveEvent ( QEvent *  event)
overrideprotected

References Digikam::DCategorizedView::Private::forcedSelectionPosition, Digikam::DCategorizedView::Private::hovered, Digikam::DCategorizedView::Private::hoveredCategory, and Digikam::DCategorizedView::Private::mouseButtonPressed.

Referenced by Digikam::ActionCategorizedView::leaveEvent(), and Digikam::ItemViewCategorized::leaveEvent().

◆ mouseMoveEvent()

void Digikam::DCategorizedView::mouseMoveEvent ( QMouseEvent *  event)
overrideprotected

References Digikam::DCategorizedView::Private::categories, Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedView::Private::categoryVisualRect(), Digikam::DCategorizedView::Private::drawItemsWhileDragging, Digikam::DCategorizedView::Private::hovered, Digikam::DCategorizedView::Private::hoveredCategory, Digikam::DCategorizedView::Private::initialPressPosition, Digikam::DCategorizedView::Private::intersectionSet(), Digikam::DCategorizedSortFilterProxyModel::isCategorizedModel(), Digikam::DCategorizedView::Private::lastDraggedItemsRect, Digikam::DCategorizedView::Private::mouseButtonPressed, Digikam::DCategorizedView::Private::mousePosition, Digikam::DCategorizedView::Private::proxyModel, and Digikam::DCategorizedView::Private::rightMouseButtonPressed.

Referenced by Digikam::ActionCategorizedView::mouseMoveEvent(), and Digikam::ItemViewCategorized::mouseMoveEvent().

◆ mousePressEvent()

void Digikam::DCategorizedView::mousePressEvent ( QMouseEvent *  event)
overrideprotected

References Digikam::DCategorizedView::Private::categoryVisualRect(), Digikam::DCategorizedView::Private::dragLeftViewport, Digikam::DCategorizedView::Private::hoveredCategory, Digikam::DCategorizedView::Private::initialPressPosition, Digikam::DCategorizedView::Private::lastSelection, Digikam::DCategorizedView::Private::mouseButtonPressed, and Digikam::DCategorizedView::Private::rightMouseButtonPressed.

Referenced by Digikam::ItemViewCategorized::mousePressEvent().

◆ mouseReleaseEvent()

void Digikam::DCategorizedView::mouseReleaseEvent ( QMouseEvent *  event)
overrideprotected

References Digikam::DCategorizedView::Private::categories, Digikam::DCategorizedView::Private::categoriesIndexes, Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedView::Private::categoryVisualRect(), Digikam::DCategorizedView::Private::hovered, Digikam::DCategorizedView::Private::hoveredCategory, Digikam::DCategorizedView::Private::initialPressPosition, Digikam::DCategorizedSortFilterProxyModel::isCategorizedModel(), Digikam::DCategorizedView::Private::mouseButtonPressed, Digikam::DCategorizedView::Private::mousePosition, Digikam::DCategorizedView::Private::proxyModel, Digikam::DCategorizedView::Private::rightMouseButtonPressed, and visualRect().

Referenced by Digikam::ItemViewCategorized::mouseReleaseEvent().

◆ moveCursor()

QModelIndex Digikam::DCategorizedView::moveCursor ( CursorAction  cursorAction,
Qt::KeyboardModifiers  modifiers 
)
overrideprotected

References Digikam::DCategorizedView::Private::biggestItemSize, Digikam::DCategorizedView::Private::categories, Digikam::DCategorizedView::Private::categoriesIndexes, Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedView::Private::elementsInfo, Digikam::DCategorizedView::Private::forcedSelectionPosition, Digikam::DCategorizedView::Private::intersectionSet(), Digikam::DCategorizedSortFilterProxyModel::isCategorizedModel(), and Digikam::DCategorizedView::Private::proxyModel.

Referenced by Digikam::ItemViewCategorized::moveCursor().

◆ paintEvent()

void Digikam::DCategorizedView::paintEvent ( QPaintEvent *  event)
overrideprotected

References Digikam::DCategorizedView::Private::categories, Digikam::DCategorizedView::Private::categoriesIndexes, Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedView::Private::categoryVisualRect(), Digikam::DCategorizedView::Private::dragLeftViewport, Digikam::DCategorizedView::Private::drawDraggedItems(), Digikam::DCategorizedView::Private::drawItemsWhileDragging, Digikam::DCategorizedView::Private::drawNewCategory(), Digikam::DCategorizedView::Private::hovered, Digikam::DCategorizedView::Private::initialPressPosition, Digikam::DCategorizedView::Private::intersectionSet(), Digikam::DCategorizedSortFilterProxyModel::isCategorizedModel(), Digikam::DCategorizedView::Private::mouseButtonPressed, Digikam::DCategorizedView::Private::mousePosition, Digikam::DCategorizedView::Private::proxyModel, Digikam::DCategorizedSortFilterProxyModel::sortColumn(), and visualRect().

Referenced by Digikam::ImportCategorizedView::paintEvent().

◆ reset

void Digikam::DCategorizedView::reset ( )
overrideslot

References Digikam::DCategorizedView::Private::biggestItemSize, Digikam::DCategorizedView::Private::categories, Digikam::DCategorizedView::Private::categoriesIndexes, Digikam::DCategorizedView::Private::categoriesPosition, Digikam::DCategorizedView::Private::elementsInfo, Digikam::DCategorizedView::Private::elementsPosition, Digikam::DCategorizedView::Private::forcedSelectionPosition, Digikam::DCategorizedView::Private::hovered, Digikam::DCategorizedView::Private::intersectedIndexes, Digikam::DCategorizedView::Private::lastSelection, Digikam::DCategorizedView::Private::mouseButtonPressed, and Digikam::DCategorizedView::Private::rightMouseButtonPressed.

Referenced by Digikam::ItemViewCategorized::reset().

◆ resizeEvent()

void Digikam::DCategorizedView::resizeEvent ( QResizeEvent *  event)
overrideprotected

References Digikam::DCategorizedView::Private::categoriesPosition, Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedView::Private::elementsPosition, Digikam::DCategorizedView::Private::forcedSelectionPosition, Digikam::DCategorizedSortFilterProxyModel::isCategorizedModel(), Digikam::DCategorizedView::Private::proxyModel, and Digikam::DCategorizedView::Private::updateScrollbars().

Referenced by Digikam::ItemViewCategorized::resizeEvent().

◆ rowsInserted

void Digikam::DCategorizedView::rowsInserted ( const QModelIndex &  parent,
int  start,
int  end 
)
overrideprotectedslot

References Digikam::DCategorizedView::Private::biggestItemSize, Digikam::DCategorizedView::Private::categories, Digikam::DCategorizedView::Private::categoriesIndexes, Digikam::DCategorizedView::Private::categoriesPosition, Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedView::Private::elementsInfo, Digikam::DCategorizedView::Private::elementsPosition, Digikam::DCategorizedView::Private::forcedSelectionPosition, Digikam::DCategorizedView::Private::hovered, Digikam::DCategorizedView::Private::intersectedIndexes, Digikam::DCategorizedSortFilterProxyModel::isCategorizedModel(), Digikam::DCategorizedView::Private::mouseButtonPressed, Digikam::DCategorizedView::Private::proxyModel, Digikam::DCategorizedView::Private::rightMouseButtonPressed, and rowsInsertedArtifficial().

Referenced by Digikam::ItemViewCategorized::rowsInserted().

◆ rowsInsertedArtifficial

void Digikam::DCategorizedView::rowsInsertedArtifficial ( const QModelIndex &  parent,
int  start,
int  end 
)
protectedvirtualslot

References Digikam::DCategorizedView::Private::biggestItemSize, Digikam::DCategorizedView::Private::categories, Digikam::DCategorizedView::Private::categoriesIndexes, Digikam::DCategorizedView::Private::categoriesPosition, Digikam::DCategorizedView::Private::ElementInfo::category, Digikam::DCategorizedSortFilterProxyModel::CategoryDisplayRole, Digikam::DCategorizedView::Private::categoryUpperBound(), Digikam::DCategorizedView::Private::elementsInfo, Digikam::DCategorizedView::Private::elementsPosition, Digikam::DCategorizedView::Private::forcedSelectionPosition, Digikam::DCategorizedView::Private::hovered, Digikam::DCategorizedView::Private::intersectedIndexes, Digikam::DCategorizedView::Private::mouseButtonPressed, Digikam::DCategorizedView::Private::proxyModel, Digikam::DCategorizedView::Private::ElementInfo::relativeOffsetToCategory, Digikam::DCategorizedView::Private::rightMouseButtonPressed, Digikam::DCategorizedSortFilterProxyModel::sortColumn(), and Digikam::DCategorizedView::Private::updateScrollbars().

Referenced by rowsInserted(), rowsRemoved(), and slotLayoutChanged().

◆ rowsRemoved

void Digikam::DCategorizedView::rowsRemoved ( const QModelIndex &  parent,
int  start,
int  end 
)
protectedvirtualslot

Reimplemented in Digikam::ItemViewCategorized.

References Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedSortFilterProxyModel::isCategorizedModel(), Digikam::DCategorizedView::Private::proxyModel, and rowsInsertedArtifficial().

Referenced by Digikam::ItemViewCategorized::rowsRemoved(), and setModel().

◆ setCategoryDrawer()

void Digikam::DCategorizedView::setCategoryDrawer ( DCategoryDrawer *  categoryDrawer)

References Digikam::DCategorizedView::Private::categories, Digikam::DCategorizedView::Private::categoriesIndexes, Digikam::DCategorizedView::Private::categoriesPosition, categoryDrawer(), Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedView::Private::elementsInfo, Digikam::DCategorizedView::Private::elementsPosition, Digikam::DCategorizedView::Private::forcedSelectionPosition, Digikam::DCategorizedView::Private::hovered, Digikam::DCategorizedView::Private::intersectedIndexes, Digikam::DCategorizedView::Private::lastSelection, Digikam::DCategorizedView::Private::mouseButtonPressed, Digikam::DCategorizedView::Private::proxyModel, Digikam::DCategorizedView::Private::rightMouseButtonPressed, slotLayoutChanged(), and updateGeometries().

Referenced by Digikam::ImportCategorizedView::setItemDelegate(), Digikam::ItemCategorizedView::setItemDelegate(), and Digikam::ActionCategorizedView::setupIconMode().

◆ setDrawDraggedItems()

void Digikam::DCategorizedView::setDrawDraggedItems ( bool  drawDraggedItems)

Switch on drawing of dragged items. Default: on. While dragging over the view, dragged items will be drawn transparently following the mouse cursor.

Parameters
drawDraggedItemsif true, dragged items will be drawn

References Digikam::DCategorizedView::Private::drawItemsWhileDragging.

Referenced by Digikam::ItemViewCategorized::ItemViewCategorized().

◆ setGridSize()

void Digikam::DCategorizedView::setGridSize ( const QSize &  size)

References slotLayoutChanged().

Referenced by Digikam::ActionCategorizedView::adjustGridSize().

◆ setModel()

void Digikam::DCategorizedView::setModel ( QAbstractItemModel *  model)
override

References Digikam::DCategorizedView::Private::categories, Digikam::DCategorizedView::Private::categoriesIndexes, Digikam::DCategorizedView::Private::categoriesPosition, Digikam::DCategorizedView::Private::elementsInfo, Digikam::DCategorizedView::Private::elementsPosition, Digikam::DCategorizedView::Private::forcedSelectionPosition, Digikam::DCategorizedView::Private::hovered, Digikam::DCategorizedView::Private::intersectedIndexes, Digikam::DCategorizedView::Private::lastSelection, Digikam::DCategorizedView::Private::mouseButtonPressed, Digikam::DCategorizedView::Private::proxyModel, Digikam::DCategorizedView::Private::rightMouseButtonPressed, rowsRemoved(), and slotLayoutChanged().

Referenced by Digikam::ImportCategorizedView::setModels(), Digikam::ItemCategorizedView::setModels(), ShowFoto::ShowfotoCategorizedView::setModels(), and Digikam::EditorWindow::setupSelectToolsAction().

◆ setSelection()

void Digikam::DCategorizedView::setSelection ( const QRect &  rect,
QItemSelectionModel::SelectionFlags  flags 
)
overrideprotected

References Digikam::DCategorizedView::Private::cachedRectIndex(), Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedView::Private::contentsSize(), Digikam::DCategorizedView::Private::intersectionSet(), Digikam::DCategorizedSortFilterProxyModel::isCategorizedModel(), Digikam::DCategorizedView::Private::proxyModel, and Digikam::DCategorizedView::Private::selectionForRect().

◆ slotLayoutChanged

void Digikam::DCategorizedView::slotLayoutChanged ( )
protectedvirtualslot

References Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedSortFilterProxyModel::isCategorizedModel(), Digikam::DCategorizedView::Private::proxyModel, and rowsInsertedArtifficial().

Referenced by setCategoryDrawer(), setGridSize(), and setModel().

◆ startDrag()

void Digikam::DCategorizedView::startDrag ( Qt::DropActions  supportedActions)
overrideprotected

◆ updateGeometries

void Digikam::DCategorizedView::updateGeometries ( )
overrideprotectedslot

References Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedSortFilterProxyModel::isCategorizedModel(), and Digikam::DCategorizedView::Private::proxyModel.

Referenced by setCategoryDrawer(), Digikam::ItemCategorizedView::updateGeometries(), and Digikam::ImportCategorizedView::updateGeometries().

◆ visualRect()

QRect Digikam::DCategorizedView::visualRect ( const QModelIndex &  index) const
override

References Digikam::DCategorizedView::Private::categoryDrawer, Digikam::DCategorizedSortFilterProxyModel::isCategorizedModel(), Digikam::DCategorizedView::Private::proxyModel, and Digikam::DCategorizedView::Private::visualRect().

Referenced by Digikam::DCategorizedView::Private::drawDraggedItems(), Digikam::DCategorizedView::Private::intersectionSet(), Digikam::ItemViewCategorized::mouseMoveEvent(), mouseReleaseEvent(), paintEvent(), Digikam::ItemViewCategorized::scrollToRelaxed(), Digikam::ItemViewCategorized::showIndexNotification(), Digikam::ItemViewCategorized::slotActivated(), and Digikam::ItemViewCategorized::viewportEvent().

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