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

0001 /* ============================================================
0002  *
0003  * This file is a part of digiKam project
0004  * https://www.digikam.org
0005  *
0006  * date        : 2014-09-12
0007  * Description : a file or folder selector widget
0008  *
0009  * SPDX-FileCopyrightText: 2014-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_DFILE_SELECTOR_H
0016 #define DIGIKAM_DFILE_SELECTOR_H
0017 
0018 // Qt includes
0019 
0020 #include <QUrl>
0021 #include <QString>
0022 #include <QLineEdit>
0023 #include <QPushButton>
0024 
0025 // Local includes
0026 
0027 #include "dlayoutbox.h"
0028 #include "dfiledialog.h"
0029 #include "digikam_export.h"
0030 
0031 namespace Digikam
0032 {
0033 
0034 /**
0035  * A widget to chosse a single local file or path.
0036  * Use line edit and file dialog properties to customize operation modes.
0037  */
0038 class DIGIKAM_EXPORT DFileSelector : public DHBox
0039 {
0040     Q_OBJECT
0041 
0042 public:
0043 
0044     explicit DFileSelector(QWidget* const parent = nullptr);
0045     ~DFileSelector() override;
0046 
0047     QLineEdit* lineEdit() const;
0048 
0049     void setFileDlgPath(const QString& path);
0050     QString fileDlgPath() const;
0051 
0052     void setFileDlgMode(QFileDialog::FileMode mode);
0053     void setFileDlgFilter(const QString& filter);
0054     void setFileDlgTitle(const QString& title);
0055     void setFileDlgOptions(QFileDialog::Options opts);
0056 
0057 Q_SIGNALS:
0058 
0059     void signalOpenFileDialog();
0060     void signalUrlSelected(const QUrl&);
0061 
0062 private Q_SLOTS:
0063 
0064     void slotBtnClicked();
0065 
0066 private:
0067 
0068     class Private;
0069     Private* const d;
0070 };
0071 
0072 } // namespace Digikam
0073 
0074 #endif // DIGIKAM_DFILE_SELECTOR_H