squeezedcombobox.h

Go to the documentation of this file.

/* ============================================================
 *
 * This file is a part of digiKam project
 * https://www.digikam.org
 *
 * Date        : 2008-08-21
 * Description : a combo box with a width not depending of text
 *               content size
 *
 * Copyright (C) 2006-2022 by Gilles Caulier <caulier dot gilles at gmail dot com>
 * Copyright (C)      2008 by Andi Clemens <andi dot clemens at googlemail dot com>
 * Copyright (C)      2005 by Tom Albers <tomalbers at kde dot nl>
 *
 * 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_SQUEEZED_COMBOBOX_H
#define DIGIKAM_SQUEEZED_COMBOBOX_H
 
// Qt includes
 
#include <QComboBox>
 
// Local includes
 
#include "digikam_export.h"
 
namespace Digikam
{
 
class DIGIKAM_EXPORT SqueezedComboBox : public QComboBox
{
    Q_OBJECT
 
public:
 
    explicit SqueezedComboBox(QWidget* const parent = nullptr, const char* name = nullptr);
 
    ~SqueezedComboBox()                                   override;
 
    bool contains(const QString& text)                               const;
 
    int findOriginalText(const QString& text,
                         Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 
    void insertSqueezedItem(const QString& newItem, int index,
                            const QVariant& userData = QVariant());
 
    void insertSqueezedList(const QStringList& newItems, int index);
 
    void addSqueezedItem(const QString& newItem,
                         const QVariant& userData = QVariant());
 
    void setCurrent(const QString& itemText);
 
    QString itemHighlighted()                                        const;
 
    QString item(int index)                                          const;
 
    QSize sizeHint()                                                 const override;
 
private Q_SLOTS:
 
    void slotTimeOut();
    void slotUpdateToolTip(int index);
 
private:
 
    void    resizeEvent(QResizeEvent*)                                     override;
    QString squeezeText(const QString& original)                     const;
 
    QString currentText()                                            const;
    void    setCurrentText(const QString& itemText);
    void    insertItem(const QString& text);
    void    insertItem(qint32 index, const QString& text);
    void    insertItem(int index,
                       const QIcon& icon,
                       const QString& text,
                       const QVariant& userData = QVariant());
    void    insertItems(int index, const QStringList& list);
    void    addItem(const QString& text);
    void    addItem(const QIcon& icon,
                    const QString& text,
                    const QVariant& userData = QVariant());
    void    addItems(const QStringList& texts);
    QString itemText(int index)                                      const;
 
private:
 
    class Private;
    Private* const d;
};
 
} // namespace Digikam
 
#endif // DIGIKAM_SQUEEZED_COMBOBOX_H