ground/gcs/src/libs/utils/filewizardpage.h

   1 /**
   2  ******************************************************************************
   3  *
   4  * @file       filewizardpage.h
   5  * @author     The OpenPilot Team, http://www.openpilot.org Copyright (C) 2010.
   6  *             Parts by Nokia Corporation (qt-info@nokia.com) Copyright (C) 2009.
   7  * @brief
   8  * @see        The GNU Public License (GPL) Version 3
   9  * @defgroup
  10  * @{
  11  *
  12  *****************************************************************************/
  13 /*
  14  * This program is free software; you can redistribute it and/or modify
  15  * it under the terms of the GNU General Public License as published by
  16  * the Free Software Foundation; either version 3 of the License, or
  17  * (at your option) any later version.
  18  *
  19  * This program is distributed in the hope that it will be useful, but
  20  * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  21  * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
  22  * for more details.
  23  *
  24  * You should have received a copy of the GNU General Public License along
  25  * with this program; if not, write to the Free Software Foundation, Inc.,
  26  * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  27  */
  28
  29 #ifndef FILEWIZARDPAGE_H
  30 #define FILEWIZARDPAGE_H
  31
  32 #include "utils_global.h"
  33
  34 #include <QWizardPage>
  35
  36 namespace Utils {
  37 struct FileWizardPagePrivate;
  38
  39 /**
  40  * Standard wizard page for a single file letting the user choose name
  41  * and path. Sets the "FileNames" QWizard field.
  42  *
  43  * The name and path labels can be changed. By default they are simply "Name:"
  44  * and "Path:".
  45  */
  46 class QTCREATOR_UTILS_EXPORT FileWizardPage : public QWizardPage {
  47     Q_OBJECT Q_DISABLE_COPY(FileWizardPage)
  48     Q_PROPERTY(QString path READ path WRITE setPath DESIGNABLE true)
  49     Q_PROPERTY(QString name READ name WRITE setName DESIGNABLE true)
  50 public:
  51     explicit FileWizardPage(QWidget *parent = 0);
  52     virtual ~FileWizardPage();
  53
  54     QString name() const;
  55     QString path() const;
  56
  57     virtual bool isComplete() const;
  58
  59     void setNameLabel(const QString &label);
  60     void setPathLabel(const QString &label);
  61
  62     // Validate a base name entry field (potentially containing extension)
  63     static bool validateBaseName(const QString &name, QString *errorMessage = 0);
  64
  65 signals:
  66     void activated();
  67     void pathChanged();
  68
  69 public slots:
  70     void setPath(const QString &path);
  71     void setName(const QString &name);
  72
  73 private slots:
  74     void slotValidChanged();
  75     void slotActivated();
  76
  77 protected:
  78     virtual void changeEvent(QEvent *e);
  79
  80 private:
  81     FileWizardPagePrivate *m_d;
  82 };
  83 } // namespace Utils
  84
  85 #endif // FILEWIZARDPAGE_H