src/Interview.h

   1 /*
   2  * This file is part of the vng project
   3  * Copyright (C) 2008 Thomas Zander <tzander@trolltech.com>
   4  *
   5  * This program is free software: you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation, either version 3 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  17  */
  18
  19 #ifndef INTERVIEW_H
  20 #define INTERVIEW_H
  21
  22 #include <QString>
  23
  24 class InterviewCursor;
  25
  26 /**
  27  * Command line interview handler.
  28  */
  29 class Interview
  30 {
  31 public:
  32     Interview(InterviewCursor &cursor, const QString &prompt);
  33
  34     /// returns false if the user cancelled the interaction.
  35     bool start();
  36
  37     static QChar askSingleChar(const QString &prompt, const QString &allowedCharacters = QString());
  38     static QString ask(const QString &prompt);
  39
  40     void setUsePager(bool on) { m_usePager = on; }
  41     bool usePager() const { return m_usePager; }
  42
  43 private:
  44     InterviewCursor &m_cursor;
  45     QString m_prompt;
  46     bool m_usePager;
  47 };
  48
  49 #endif
  50