#ifndef _KVI_TAL_FILEDIALOG_H_ #define _KVI_TAL_FILEDIALOG_H_ //============================================================================= // // File : KviTalFileDialog.h // Creation date : Thu Sep 11 2003 04:41:08 by Szymon Stefanek // // This file is part of the KVIrc IRC client distribution // Copyright (C) 2003-2010 Szymon Stefanek (pragma at kvirc dot net) // // 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 // of the License, 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. // // You should have received a copy of the GNU General Public License // along with this program. If not, write to the Free Software Foundation, // Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. // //============================================================================= /** * \file KviTalFileDialog.h * \author Szymon Stefanek * \brief Toolkit Abstraction Layer class */ #include "kvi_settings.h" #ifdef None #undef None #endif // otherwise gcc freaks out somewhere inside the include chain of KFileDialog /** * \class KviTalFileDialog * \brief Toolkit Abstraction Layer: filedialog class */ #include class KVILIB_API KviTalFileDialog : public QFileDialog { Q_OBJECT public: /** * \brief Constructs the filedialog object * \param szDirName The initial directory to display * \param szFilter The filter to use to display * \param pParent The parent object * \param pcName The caption name of the dialog * \param bModal Whether the dialog is modal * \return KviTalFileDialog */ KviTalFileDialog(const QString & szDirName, const QString & szFilter = QString(), QWidget * pParent = nullptr, const char * pcName = nullptr, bool bModal = false); /** * \brief Destroys the filedialog object */ ~KviTalFileDialog(); public: /** * \enum FileMode * \brief Indicate what the user may select in the file dialog */ enum FileMode { AnyFile, /**< The name of a file, whether it exists or not */ ExistingFile, /**< The name of a single existing file */ ExistingFiles, /**< The names of zero or more existing files */ Directory, /**< The name of a directory. Both files and directories are displayed */ DirectoryOnly /**< The name of a directory. The file dialog will only display directories */ }; /** * \brief Sets the file mode * \param m The mode :) * \return void */ void setFileMode(FileMode m); /** * \brief Returns an existing directory selected by the user * \param szDir The directory to display * \param szCaption The caption of the dialog * \param pParent The parent object * \return QString */ static QString getExistingDirectoryPath(const QString & szDir = QString(), const QString & szCaption = QString(), QWidget * pParent = nullptr) { return getExistingDirectory(pParent, szCaption, szDir); }; }; #endif // _KVI_TAL_FILEDIALOG_H_