camitemsortsettings.h

Go to the documentation of this file.

/* ============================================================
 *
 * This file is a part of digiKam project
 * https://www.digikam.org
 *
 * Date        : 2012-23-06
 * Description : Sort settings for camera item infos
 *
 * 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_CAMITEM_SORT_SETTINGS_H
#define DIGIKAM_CAMITEM_SORT_SETTINGS_H
 
// Qt includes
 
#include <QString>
#include <QVariant>
 
// Local includes
 
#include "itemsortcollator.h"
 
namespace Digikam
{
 
class CamItemInfo;
 
class CamItemSortSettings
{
public:
 
    enum SortOrder
    {
        AscendingOrder  = Qt::AscendingOrder,
        DescendingOrder = Qt::DescendingOrder,
        DefaultOrder    
    };
 
    enum CategorizationMode
    {
        NoCategories,
        CategoryByFolder,
        CategoryByFormat,
        CategoryByDate
    };
 
    enum SortRole
    {
        SortByFileName,
        SortByFilePath,
        SortByCreationDate,
        SortByFileSize,
        SortByDownloadState,
        SortByRating
    };
 
public:
 
    CamItemSortSettings();
    ~CamItemSortSettings();
 
    bool operator==(const CamItemSortSettings& other) const;
 
    int compareCategories(const CamItemInfo& left, const CamItemInfo& right) const;
 
    bool lessThan(const CamItemInfo& left, const CamItemInfo& right) const;
 
    bool lessThan(const QVariant& left, const QVariant& right) const;
 
    int compare(const CamItemInfo& left, const CamItemInfo& right) const;
 
    void setCategorizationMode(CategorizationMode mode);
    void setCategorizationSortOrder(SortOrder order);
 
    bool isCategorized() const { return categorizationMode >= CategoryByFolder; }
 
    void setSortRole(SortRole role);
    void setSortOrder(SortOrder order);
    void setStringTypeNatural(bool natural);
 
    int compare(const CamItemInfo& left, const CamItemInfo& right, SortRole sortRole) const;
 
    static Qt::SortOrder defaultSortOrderForCategorizationMode(CategorizationMode mode);
    static Qt::SortOrder defaultSortOrderForSortRole(SortRole role);
 
    template <typename T>
    static inline bool lessThanByOrder(const T& a, const T& b, Qt::SortOrder sortOrder)
    {
        if (sortOrder == Qt::AscendingOrder)
        {
            return (a < b);
        }
 
        return (b < a);
    }
 
    template <typename T>
    static inline int compareValue(const T& a, const T &b)
    {
        if (a == b)
        {
            return 0;
        }
 
        if (a > b)
        {
            return 1;
        }
 
        return (-1);
    }
 
    static inline int compareByOrder(int compareResult,  Qt::SortOrder sortOrder)
    {
        if (sortOrder == Qt::AscendingOrder)
        {
            return compareResult;
        }
 
        return (- compareResult);
    }
 
    template <typename T>
    static inline int compareByOrder(const T& a, const T& b, Qt::SortOrder sortOrder)
    {
        return compareByOrder(compareValue(a, b), sortOrder);
    }
 
    static inline int naturalCompare(const QString& a, const QString& b, Qt::SortOrder sortOrder,
                                     Qt::CaseSensitivity caseSensitive = Qt::CaseSensitive,
                                     bool natural = true)
    {
        ItemSortCollator* const sorter = ItemSortCollator::instance();
 
        return compareByOrder(sorter->itemCompare(a, b, caseSensitive, natural), sortOrder);
    }
 
public:
 
    CategorizationMode   categorizationMode;
    SortOrder            categorizationSortOrder;
 
    Qt::SortOrder        currentCategorizationSortOrder;
    Qt::CaseSensitivity  categorizationCaseSensitivity;
 
    SortOrder            sortOrder;
    SortRole             sortRole;
    bool                 strTypeNatural;
 
    Qt::SortOrder        currentSortOrder;
    Qt::CaseSensitivity  sortCaseSensitivity;
};
 
} // namespace Digikam
 
#endif // DIGIKAM_CAMITEM_SORT_SETTINGS_H