examples/help/simpletextviewer/assistant.cpp

   1 /****************************************************************************
   2 **
   3 ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
   4 ** All rights reserved.
   5 ** Contact: Nokia Corporation (qt-info@nokia.com)
   6 **
   7 ** This file is part of the examples of the Qt Toolkit.
   8 **
   9 ** $QT_BEGIN_LICENSE:LGPL$
  10 ** No Commercial Usage
  11 ** This file contains pre-release code and may not be distributed.
  12 ** You may use this file in accordance with the terms and conditions
  13 ** contained in the Technology Preview License Agreement accompanying
  14 ** this package.
  15 **
  16 ** GNU Lesser General Public License Usage
  17 ** Alternatively, this file may be used under the terms of the GNU Lesser
  18 ** General Public License version 2.1 as published by the Free Software
  19 ** Foundation and appearing in the file LICENSE.LGPL included in the
  20 ** packaging of this file.  Please review the following information to
  21 ** ensure the GNU Lesser General Public License version 2.1 requirements
  22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
  23 **
  24 ** In addition, as a special exception, Nokia gives you certain additional
  25 ** rights.  These rights are described in the Nokia Qt LGPL Exception
  26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
  27 **
  28 ** If you have questions regarding the use of this file, please contact
  29 ** Nokia at qt-info@nokia.com.
  30 **
  31 **
  32 **
  33 **
  34 **
  35 **
  36 **
  37 **
  38 ** $QT_END_LICENSE$
  39 **
  40 ****************************************************************************/
  41
  42 #include <QtCore/QByteArray>
  43 #include <QtCore/QDir>
  44 #include <QtCore/QLibraryInfo>
  45 #include <QtCore/QProcess>
  46
  47 #include <QtGui/QMessageBox>
  48
  49 #include "assistant.h"
  50
  51 Assistant::Assistant()
  52     : proc(0)
  53 {
  54 }
  55
  56 //! [0]
  57 Assistant::~Assistant()
  58 {
  59     if (proc && proc->state() == QProcess::Running) {
  60         proc->terminate();
  61         proc->waitForFinished(3000);
  62     }
  63     delete proc;
  64 }
  65 //! [0]
  66
  67 //! [1]
  68 void Assistant::showDocumentation(const QString &page)
  69 {
  70     if (!startAssistant())
  71         return;
  72
  73     QByteArray ba("SetSource ");
  74     ba.append("qthelp://com.trolltech.examples.simpletextviewer/doc/");
  75
  76     proc->write(ba + page.toLocal8Bit() + '\0');
  77 }
  78 //! [1]
  79
  80 //! [2]
  81 bool Assistant::startAssistant()
  82 {
  83     if (!proc)
  84         proc = new QProcess();
  85
  86     if (proc->state() != QProcess::Running) {
  87         QString app = QLibraryInfo::location(QLibraryInfo::BinariesPath) + QDir::separator();
  88 #if !defined(Q_OS_MAC)
  89         app += QLatin1String("assistant");
  90 #else
  91         app += QLatin1String("Assistant.app/Contents/MacOS/Assistant");
  92 #endif
  93
  94         QStringList args;
  95         args << QLatin1String("-collectionFile")
  96             << QLibraryInfo::location(QLibraryInfo::ExamplesPath)
  97             + QLatin1String("/help/simpletextviewer/documentation/simpletextviewer.qhc")
  98             << QLatin1String("-enableRemoteControl");
  99
 100         proc->start(app, args);
 101
 102         if (!proc->waitForStarted()) {
 103             QMessageBox::critical(0, QObject::tr("Simple Text Viewer"),
 104                 QObject::tr("Unable to launch Qt Assistant (%1)").arg(app));
 105             return false;
 106         }
 107     }
 108     return true;
 109 }
 110 //! [2]