importcategorizedview.h

Go to the documentation of this file.

/* ============================================================
 *
 * This file is a part of digiKam project
 * https://www.digikam.org
 *
 * Date        : 2012-07-13
 * Description : Qt categorized item view for camera items
 *
 * Copyright (C) 2012 by Islam Wazery <wazery at ubuntu dot com>
 *
 * This program is free software; you can redistribute it
 * and/or modify it under the terms of the GNU General
 * Public License as published by the Free Software Foundation;
 * either version 2, or (at your option)
 * any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * ============================================================ */
 
#ifndef DIGIKAM_IMPORT_CATEGORIZED_VIEW_H
#define DIGIKAM_IMPORT_CATEGORIZED_VIEW_H
 
// Local includes
 
#include "itemviewcategorized.h"
#include "importimagemodel.h"
#include "importfiltermodel.h"
#include "importthumbnailmodel.h"
#include "itemdelegateoverlay.h"
#include "camiteminfo.h"
#include "digikam_export.h"
 
namespace Digikam
{
 
class ImportDelegate;
class ICCSettingsContainer;
 
class DIGIKAM_GUI_EXPORT ImportCategorizedView : public ItemViewCategorized
{
    Q_OBJECT
 
public:
 
    explicit ImportCategorizedView(QWidget* const parent = nullptr);
    ~ImportCategorizedView() override;
 
    void setModels(ImportItemModel* model,
                   ImportSortFilterModel* filterModel);
 
    ImportItemModel*       importItemModel()                  const;
    ImportSortFilterModel* importSortFilterModel()            const;
 
    QItemSelectionModel*   getSelectionModel()                const;
 
    ImportFilterModel*     importFilterModel()                const;
 
    ImportThumbnailModel*  importThumbnailModel()             const;
 
    ImportDelegate*        delegate()                         const;
 
    CamItemInfo            currentInfo()                      const;
    QUrl                   currentUrl()                       const;
 
    QList<CamItemInfo>     selectedCamItemInfos()             const;
    QList<CamItemInfo>     selectedCamItemInfosCurrentFirst() const;
    QList<QUrl>            selectedUrls()                     const;
 
    QList<CamItemInfo>     camItemInfos()                     const;
    QList<QUrl>            urls()                             const;
 
    void toIndex(const QUrl& url);
 
    CamItemInfo nextInOrder(const CamItemInfo& startingPoint, int nth);
 
    CamItemInfo previousInfo(const CamItemInfo& info)
    {
        return nextInOrder(info, -1);
    }
 
    CamItemInfo nextInfo(const CamItemInfo& info)
    {
        return nextInOrder(info, 1);
    }
 
    void addOverlay(ItemDelegateOverlay* overlay, ImportDelegate* delegate = nullptr);
    void removeOverlay(ItemDelegateOverlay* overlay);
 
    void addSelectionOverlay(ImportDelegate* delegate = nullptr);
 
    ThumbnailSize thumbnailSize()                             const;
 
    virtual void setThumbnailSize(const ThumbnailSize& size);
 
public Q_SLOTS:
 
    void setThumbnailSize(int size);
 
    void setCurrentWhenAvailable(qlonglong camItemId);
 
    void setCurrentUrl(const QUrl& url);
 
    void setCurrentInfo(const CamItemInfo& info);
 
    void setSelectedUrls(const QList<QUrl>& urlList);
 
    void setSelectedCamItemInfos(const QList<CamItemInfo>& infos);
 
    void hintAt(const CamItemInfo& info);
 
Q_SIGNALS:
 
    void currentChanged(const CamItemInfo& info);
 
    void selected(const QList<CamItemInfo>& newSelectedInfos);
 
    void deselected(const QList<CamItemInfo>& nowDeselectedInfos);
 
    void camItemInfoActivated(const CamItemInfo& info);
 
    void modelChanged();
 
protected Q_SLOTS:
 
    void slotCamItemInfosAdded();
 
protected:
 
    QSortFilterProxyModel*       filterModel()                                                                       const override;
    AbstractItemDragDropHandler* dragDropHandler()                                                                   const override;
    QModelIndex                  nextIndexHint(const QModelIndex& indexToAnchor, const QItemSelectionRange& removed) const override;
 
    void setItemDelegate(ImportDelegate* delegate);
    void indexActivated(const QModelIndex& index, Qt::KeyboardModifiers modifiers)                                         override;
    void currentChanged(const QModelIndex& index, const QModelIndex& previous)                                             override;
    void paintEvent(QPaintEvent* e)                                                                                        override;
    void selectionChanged(const QItemSelection&, const QItemSelection&)                                                    override;
    void updateGeometries()                                                                                                override;
 
    virtual void activated(const CamItemInfo& info, Qt::KeyboardModifiers modifiers);
    virtual void showContextMenuOnInfo(QContextMenuEvent* event, const CamItemInfo& info);
    void showContextMenuOnIndex(QContextMenuEvent* event, const QModelIndex& index)                                        override;
 
private Q_SLOTS:
 
    void slotFileChanged(const QString& filePath);
    void slotDelayedEnter();
    void slotIccSettingsChanged(const ICCSettingsContainer&, const ICCSettingsContainer&);
 
private:
 
    void scrollToStoredItem();
 
private:
 
    // Disable
    ImportCategorizedView(const ImportCategorizedView&)            = delete;
    ImportCategorizedView& operator=(const ImportCategorizedView&) = delete;
 
private:
 
    class Private;
    Private* const d;
};
 
} // namespace Digikam
 
#endif // DIGIKAM_IMPORT_CATEGORIZED_VIEW_H