File indexing completed on 2025-04-27 03:58:32

0001 /* ============================================================
0002  *
0003  * This file is a part of digiKam project
0004  * https://www.digikam.org
0005  *
0006  * Date        : 2007-04-15
0007  * Description : a zoom bar used in status bar.
0008  *
0009  * SPDX-FileCopyrightText: 2007-2024 by Gilles Caulier <caulier dot gilles at gmail dot com>
0010  *
0011  * SPDX-License-Identifier: GPL-2.0-or-later
0012  *
0013  * ============================================================ */
0014 
0015 #ifndef DIGIKAM_DZOOM_BAR_H
0016 #define DIGIKAM_DZOOM_BAR_H
0017 
0018 // Qt includes
0019 
0020 #include <QString>
0021 
0022 // Local includes
0023 
0024 #include "dlayoutbox.h"
0025 #include "digikam_export.h"
0026 
0027 class QAction;
0028 
0029 namespace Digikam
0030 {
0031 
0032 class DIGIKAM_EXPORT DZoomBar : public DHBox
0033 {
0034     Q_OBJECT
0035 
0036 public:
0037 
0038     enum BarMode
0039     {
0040         PreviewZoomCtrl = 0,      ///< Preview Zoom controller.
0041         ThumbsSizeCtrl,           ///< Thumb Size controller. Preview zoom controller still visible but disabled.
0042         NoPreviewZoomCtrl         ///< Thumb Size controller alone. Preview Zoom controller is hidden.
0043     };
0044 
0045 public:
0046 
0047     explicit DZoomBar(QWidget* const parent = nullptr);
0048     ~DZoomBar() override;
0049 
0050     void setBarMode(BarMode mode);
0051     void setZoom(double zoom, double zmin, double zmax);
0052     void setThumbsSize(int size);
0053 
0054     void setZoomToFitAction(QAction* const action);
0055     void setZoomTo100Action(QAction* const action);
0056     void setZoomPlusAction(QAction* const action);
0057     void setZoomMinusAction(QAction* const action);
0058 
0059     void triggerZoomTrackerToolTip();
0060 
0061     static int    sizeFromZoom(double zoom, double zmin, double zmax);
0062     static double zoomFromSize(int size, double zmin, double zmax);
0063 
0064 Q_SIGNALS:
0065 
0066     void signalZoomSliderChanged(int);
0067     void signalDelayedZoomSliderChanged(int);
0068     void signalZoomSliderReleased(int);
0069     void signalZoomValueEdited(double);
0070 
0071 public Q_SLOTS:
0072 
0073     void slotUpdateTrackerPos();
0074 
0075 private Q_SLOTS:
0076 
0077     void slotZoomSliderChanged(int);
0078     void slotDelayedZoomSliderChanged();
0079     void slotZoomSliderReleased();
0080     void slotZoomSelected(int);
0081     void slotZoomTextChanged();
0082 
0083 private:
0084 
0085     class Private;
0086     Private* const d;
0087 };
0088 
0089 } // namespace Digikam
0090 
0091 #endif // DIGIKAM_DZOOM_BAR_H