forked from qt-creator/qt-creator
Fixes: move all files in shared/* to src/shared/*
This commit is contained in:
531
src/shared/help/helpviewer.cpp
Normal file
531
src/shared/help/helpviewer.cpp
Normal file
@@ -0,0 +1,531 @@
|
||||
/***************************************************************************
|
||||
**
|
||||
** This file is part of Qt Creator
|
||||
**
|
||||
** Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).
|
||||
**
|
||||
** Contact: Qt Software Information (qt-info@nokia.com)
|
||||
**
|
||||
**
|
||||
** Non-Open Source Usage
|
||||
**
|
||||
** Licensees may use this file in accordance with the Qt Beta Version
|
||||
** License Agreement, Agreement version 2.2 provided with the Software or,
|
||||
** alternatively, in accordance with the terms contained in a written
|
||||
** agreement between you and Nokia.
|
||||
**
|
||||
** GNU General Public License Usage
|
||||
**
|
||||
** Alternatively, this file may be used under the terms of the GNU General
|
||||
** Public License versions 2.0 or 3.0 as published by the Free Software
|
||||
** Foundation and appearing in the file LICENSE.GPL included in the packaging
|
||||
** of this file. Please review the following information to ensure GNU
|
||||
** General Public Licensing requirements will be met:
|
||||
**
|
||||
** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
|
||||
** http://www.gnu.org/copyleft/gpl.html.
|
||||
**
|
||||
** In addition, as a special exception, Nokia gives you certain additional
|
||||
** rights. These rights are described in the Nokia Qt GPL Exception
|
||||
** version 1.3, included in the file GPL_EXCEPTION.txt in this package.
|
||||
**
|
||||
***************************************************************************/
|
||||
|
||||
#include "helpviewer.h"
|
||||
#include "centralwidget.h"
|
||||
|
||||
#include <QtCore/QDir>
|
||||
#include <QtCore/QEvent>
|
||||
#include <QtCore/QVariant>
|
||||
#include <QtCore/QByteArray>
|
||||
#include <QtCore/QTimer>
|
||||
|
||||
#include <QtGui/QMenu>
|
||||
#include <QtGui/QKeyEvent>
|
||||
#include <QtGui/QClipboard>
|
||||
#include <QtGui/QApplication>
|
||||
#include <QtGui/QMessageBox>
|
||||
#include <QtGui/QDesktopServices>
|
||||
|
||||
#include <QtHelp/QHelpEngine>
|
||||
|
||||
#include <QNetworkAccessManager>
|
||||
#include <QNetworkReply>
|
||||
#include <QNetworkRequest>
|
||||
|
||||
QT_BEGIN_NAMESPACE
|
||||
|
||||
#if !defined(QT_NO_WEBKIT)
|
||||
|
||||
class HelpNetworkReply : public QNetworkReply
|
||||
{
|
||||
public:
|
||||
HelpNetworkReply(const QNetworkRequest &request, const QByteArray &fileData,
|
||||
const QString &mimeType);
|
||||
|
||||
virtual void abort();
|
||||
|
||||
virtual qint64 bytesAvailable() const
|
||||
{ return data.length() + QNetworkReply::bytesAvailable(); }
|
||||
|
||||
protected:
|
||||
virtual qint64 readData(char *data, qint64 maxlen);
|
||||
|
||||
private:
|
||||
QByteArray data;
|
||||
qint64 origLen;
|
||||
};
|
||||
|
||||
HelpNetworkReply::HelpNetworkReply(const QNetworkRequest &request,
|
||||
const QByteArray &fileData, const QString &mimeType)
|
||||
: data(fileData), origLen(fileData.length())
|
||||
{
|
||||
setRequest(request);
|
||||
setOpenMode(QIODevice::ReadOnly);
|
||||
|
||||
setHeader(QNetworkRequest::ContentTypeHeader, mimeType);
|
||||
setHeader(QNetworkRequest::ContentLengthHeader, QByteArray::number(origLen));
|
||||
QTimer::singleShot(0, this, SIGNAL(metaDataChanged()));
|
||||
QTimer::singleShot(0, this, SIGNAL(readyRead()));
|
||||
}
|
||||
|
||||
void HelpNetworkReply::abort()
|
||||
{
|
||||
// nothing to do
|
||||
}
|
||||
|
||||
qint64 HelpNetworkReply::readData(char *buffer, qint64 maxlen)
|
||||
{
|
||||
qint64 len = qMin(qint64(data.length()), maxlen);
|
||||
if (len) {
|
||||
qMemCopy(buffer, data.constData(), len);
|
||||
data.remove(0, len);
|
||||
}
|
||||
if (!data.length())
|
||||
QTimer::singleShot(0, this, SIGNAL(finished()));
|
||||
return len;
|
||||
}
|
||||
|
||||
class HelpNetworkAccessManager : public QNetworkAccessManager
|
||||
{
|
||||
public:
|
||||
HelpNetworkAccessManager(QHelpEngine *engine, QObject *parent);
|
||||
|
||||
protected:
|
||||
virtual QNetworkReply *createRequest(Operation op,
|
||||
const QNetworkRequest &request, QIODevice *outgoingData = 0);
|
||||
|
||||
private:
|
||||
QHelpEngine *helpEngine;
|
||||
};
|
||||
|
||||
HelpNetworkAccessManager::HelpNetworkAccessManager(QHelpEngine *engine,
|
||||
QObject *parent)
|
||||
: QNetworkAccessManager(parent), helpEngine(engine)
|
||||
{
|
||||
}
|
||||
|
||||
QNetworkReply *HelpNetworkAccessManager::createRequest(Operation op,
|
||||
const QNetworkRequest &request, QIODevice *outgoingData)
|
||||
{
|
||||
const QString& scheme = request.url().scheme();
|
||||
if (scheme == QLatin1String("qthelp") || scheme == QLatin1String("about")) {
|
||||
const QUrl& url = request.url();
|
||||
QString mimeType = url.toString();
|
||||
if (mimeType.endsWith(QLatin1String(".svg"))
|
||||
|| mimeType.endsWith(QLatin1String(".svgz"))) {
|
||||
mimeType = QLatin1String("image/svg+xml");
|
||||
}
|
||||
else if (mimeType.endsWith(QLatin1String(".css"))) {
|
||||
mimeType = QLatin1String("text/css");
|
||||
}
|
||||
else if (mimeType.endsWith(QLatin1String(".js"))) {
|
||||
mimeType = QLatin1String("text/javascript");
|
||||
} else {
|
||||
mimeType = QLatin1String("text/html");
|
||||
}
|
||||
return new HelpNetworkReply(request, helpEngine->fileData(url), mimeType);
|
||||
}
|
||||
return QNetworkAccessManager::createRequest(op, request, outgoingData);
|
||||
}
|
||||
|
||||
class HelpPage : public QWebPage
|
||||
{
|
||||
public:
|
||||
HelpPage(CentralWidget *central, QHelpEngine *engine, QObject *parent);
|
||||
|
||||
protected:
|
||||
virtual QWebPage *createWindow(QWebPage::WebWindowType);
|
||||
|
||||
virtual bool acceptNavigationRequest(QWebFrame *frame,
|
||||
const QNetworkRequest &request, NavigationType type);
|
||||
|
||||
private:
|
||||
CentralWidget *centralWidget;
|
||||
QHelpEngine *helpEngine;
|
||||
};
|
||||
|
||||
HelpPage::HelpPage(CentralWidget *central, QHelpEngine *engine, QObject *parent)
|
||||
: QWebPage(parent), centralWidget(central), helpEngine(engine)
|
||||
{
|
||||
}
|
||||
|
||||
QWebPage *HelpPage::createWindow(QWebPage::WebWindowType)
|
||||
{
|
||||
return centralWidget->newEmptyTab()->page();
|
||||
}
|
||||
|
||||
static bool isLocalUrl(const QUrl &url)
|
||||
{
|
||||
const QString scheme = url.scheme();
|
||||
if (scheme.isEmpty()
|
||||
|| scheme == QLatin1String("file")
|
||||
|| scheme == QLatin1String("qrc")
|
||||
|| scheme == QLatin1String("data")
|
||||
|| scheme == QLatin1String("qthelp")
|
||||
|| scheme == QLatin1String("about"))
|
||||
return true;
|
||||
return false;
|
||||
}
|
||||
|
||||
bool HelpPage::acceptNavigationRequest(QWebFrame *,
|
||||
const QNetworkRequest &request, QWebPage::NavigationType)
|
||||
{
|
||||
const QUrl &url = request.url();
|
||||
if (isLocalUrl(url)) {
|
||||
if (url.path().endsWith(QLatin1String("pdf"))) {
|
||||
QString fileName = url.toString();
|
||||
fileName = QDir::tempPath() + QDir::separator() + fileName.right
|
||||
(fileName.length() - fileName.lastIndexOf(QChar('/')));
|
||||
|
||||
QFile tmpFile(QDir::cleanPath(fileName));
|
||||
if (tmpFile.open(QIODevice::ReadWrite)) {
|
||||
tmpFile.write(helpEngine->fileData(url));
|
||||
tmpFile.close();
|
||||
}
|
||||
QDesktopServices::openUrl(QUrl(tmpFile.fileName()));
|
||||
return false;
|
||||
}
|
||||
return true;
|
||||
}
|
||||
|
||||
QDesktopServices::openUrl(url);
|
||||
return false;
|
||||
}
|
||||
|
||||
HelpViewer::HelpViewer(QHelpEngine *engine, CentralWidget *parent)
|
||||
: QWebView(parent), helpEngine(engine), parentWidget(parent)
|
||||
{
|
||||
setPage(new HelpPage(parent, helpEngine, this));
|
||||
|
||||
page()->setNetworkAccessManager(new HelpNetworkAccessManager(engine, this));
|
||||
|
||||
QAction* action = pageAction(QWebPage::OpenLinkInNewWindow);
|
||||
action->setText(tr("Open Link in New Tab"));
|
||||
if (!parent)
|
||||
action->setVisible(false);
|
||||
|
||||
pageAction(QWebPage::DownloadLinkToDisk)->setVisible(false);
|
||||
pageAction(QWebPage::DownloadImageToDisk)->setVisible(false);
|
||||
pageAction(QWebPage::OpenImageInNewWindow)->setVisible(false);
|
||||
|
||||
connect(pageAction(QWebPage::Copy), SIGNAL(changed()), this,
|
||||
SLOT(actionChanged()));
|
||||
connect(pageAction(QWebPage::Back), SIGNAL(changed()), this,
|
||||
SLOT(actionChanged()));
|
||||
connect(pageAction(QWebPage::Forward), SIGNAL(changed()), this,
|
||||
SLOT(actionChanged()));
|
||||
connect(page(), SIGNAL(linkHovered(QString, QString, QString)), this,
|
||||
SIGNAL(highlighted(QString)));
|
||||
connect(this, SIGNAL(urlChanged(QUrl)), this, SIGNAL(sourceChanged(QUrl)));
|
||||
}
|
||||
|
||||
void HelpViewer::setSource(const QUrl &url)
|
||||
{
|
||||
if (!homeUrl.isValid())
|
||||
homeUrl = url;
|
||||
load(url);
|
||||
}
|
||||
|
||||
void HelpViewer::resetZoom()
|
||||
{
|
||||
setTextSizeMultiplier(1.0);
|
||||
}
|
||||
|
||||
void HelpViewer::zoomIn(qreal range)
|
||||
{
|
||||
setTextSizeMultiplier(textSizeMultiplier() + range / 10.0);
|
||||
}
|
||||
|
||||
void HelpViewer::zoomOut(qreal range)
|
||||
{
|
||||
setTextSizeMultiplier(qMax(0.0, textSizeMultiplier() - range / 10.0));
|
||||
}
|
||||
|
||||
void HelpViewer::home()
|
||||
{
|
||||
if (homeUrl.isValid())
|
||||
setSource(homeUrl);
|
||||
}
|
||||
|
||||
void HelpViewer::wheelEvent(QWheelEvent *e)
|
||||
{
|
||||
if (e->modifiers() & Qt::ControlModifier) {
|
||||
const int delta = e->delta();
|
||||
if (delta > 0)
|
||||
zoomIn(delta / 120);
|
||||
else if (delta < 0)
|
||||
zoomOut(-delta / 120);
|
||||
e->accept();
|
||||
return;
|
||||
}
|
||||
QWebView::wheelEvent(e);
|
||||
}
|
||||
|
||||
void HelpViewer::mouseReleaseEvent(QMouseEvent *e)
|
||||
{
|
||||
if (e->button() == Qt::XButton1) {
|
||||
triggerPageAction(QWebPage::Back);
|
||||
return;
|
||||
}
|
||||
|
||||
if (e->button() == Qt::XButton2) {
|
||||
triggerPageAction(QWebPage::Forward);
|
||||
return;
|
||||
}
|
||||
|
||||
QWebView::mouseReleaseEvent(e);
|
||||
}
|
||||
|
||||
void HelpViewer::actionChanged()
|
||||
{
|
||||
QAction *a = qobject_cast<QAction *>(sender());
|
||||
if (a == pageAction(QWebPage::Copy))
|
||||
emit copyAvailable(a->isEnabled());
|
||||
else if (a == pageAction(QWebPage::Back))
|
||||
emit backwardAvailable(a->isEnabled());
|
||||
else if (a == pageAction(QWebPage::Forward))
|
||||
emit forwardAvailable(a->isEnabled());
|
||||
}
|
||||
|
||||
#else // !defined(QT_NO_WEBKIT)
|
||||
|
||||
HelpViewer::HelpViewer(QHelpEngine *engine, CentralWidget *parent)
|
||||
: QTextBrowser(parent)
|
||||
, zoomCount(0)
|
||||
, controlPressed(false)
|
||||
, lastAnchor(QString())
|
||||
, helpEngine(engine)
|
||||
, parentWidget(parent)
|
||||
{
|
||||
document()->setDocumentMargin(8);
|
||||
}
|
||||
|
||||
void HelpViewer::setSource(const QUrl &url)
|
||||
{
|
||||
bool help = url.toString() == QLatin1String("help");
|
||||
if (url.isValid() && !help) {
|
||||
if (launchedWithExternalApp(url))
|
||||
return;
|
||||
|
||||
QUrl u = helpEngine->findFile(url);
|
||||
if (u.isValid()) {
|
||||
if (!homeUrl.isValid())
|
||||
homeUrl = url;
|
||||
QTextBrowser::setSource(u);
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
if (help) {
|
||||
QTextBrowser::setSource(QUrl(QLatin1String("qthelp://com.trolltech.com."
|
||||
"assistantinternal_1.0.0/assistant/assistant.html")));
|
||||
} else {
|
||||
QTextBrowser::setSource(url);
|
||||
setHtml(tr("<title>Error 404...</title><div align=\"center\"><br><br>"
|
||||
"<h1>The page could not be found</h1><br><h3>'%1'</h3></div>")
|
||||
.arg(url.toString()));
|
||||
emit sourceChanged(url);
|
||||
}
|
||||
}
|
||||
|
||||
void HelpViewer::resetZoom()
|
||||
{
|
||||
if (zoomCount == 0)
|
||||
return;
|
||||
|
||||
QTextBrowser::zoomOut(zoomCount);
|
||||
zoomCount = 0;
|
||||
}
|
||||
|
||||
void HelpViewer::zoomIn(int range)
|
||||
{
|
||||
if (zoomCount == 10)
|
||||
return;
|
||||
|
||||
QTextBrowser::zoomIn(range);
|
||||
zoomCount++;
|
||||
}
|
||||
|
||||
void HelpViewer::zoomOut(int range)
|
||||
{
|
||||
if (zoomCount == -5)
|
||||
return;
|
||||
|
||||
QTextBrowser::zoomOut(range);
|
||||
zoomCount--;
|
||||
}
|
||||
|
||||
bool HelpViewer::launchedWithExternalApp(const QUrl &url)
|
||||
{
|
||||
bool isPdf = url.path().endsWith(QLatin1String("pdf"));
|
||||
if (url.scheme() == QLatin1String("http")
|
||||
|| url.scheme() == QLatin1String("ftp")
|
||||
|| url.scheme() == QLatin1String("mailto") || isPdf) {
|
||||
bool launched = false;
|
||||
if (isPdf && url.scheme() == QLatin1String("qthelp")) {
|
||||
QString fileName = url.toString();
|
||||
fileName = QDir::tempPath() + QDir::separator() + fileName.right
|
||||
(fileName.length() - fileName.lastIndexOf(QChar('/')));
|
||||
|
||||
QFile tmpFile(QDir::cleanPath(fileName));
|
||||
if (tmpFile.open(QIODevice::ReadWrite)) {
|
||||
tmpFile.write(helpEngine->fileData(url));
|
||||
tmpFile.close();
|
||||
}
|
||||
launched = QDesktopServices::openUrl(QUrl(tmpFile.fileName()));
|
||||
} else {
|
||||
launched = QDesktopServices::openUrl(url);
|
||||
}
|
||||
|
||||
if (!launched) {
|
||||
QMessageBox::information(this, tr("Help"),
|
||||
tr("Unable to launch external application.\n"), tr("OK"));
|
||||
}
|
||||
return true;
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
QVariant HelpViewer::loadResource(int type, const QUrl &name)
|
||||
{
|
||||
QByteArray ba;
|
||||
if (type < 4) {
|
||||
ba = helpEngine->fileData(name);
|
||||
if (name.toString().endsWith(QLatin1String(".svg"), Qt::CaseInsensitive)) {
|
||||
QImage image;
|
||||
image.loadFromData(ba, "svg");
|
||||
if (!image.isNull())
|
||||
return image;
|
||||
}
|
||||
}
|
||||
return ba;
|
||||
}
|
||||
|
||||
void HelpViewer::openLinkInNewTab()
|
||||
{
|
||||
if (lastAnchor.isEmpty())
|
||||
return;
|
||||
|
||||
parentWidget->setSourceInNewTab(QUrl(lastAnchor));
|
||||
lastAnchor.clear();
|
||||
}
|
||||
|
||||
void HelpViewer::openLinkInNewTab(const QString &link)
|
||||
{
|
||||
lastAnchor = link;
|
||||
openLinkInNewTab();
|
||||
}
|
||||
|
||||
bool HelpViewer::hasAnchorAt(const QPoint& pos)
|
||||
{
|
||||
lastAnchor = anchorAt(pos);
|
||||
if (lastAnchor.isEmpty())
|
||||
return false;
|
||||
|
||||
lastAnchor = source().resolved(lastAnchor).toString();
|
||||
if (lastAnchor.at(0) == QLatin1Char('#')) {
|
||||
QString src = source().toString();
|
||||
int hsh = src.indexOf(QLatin1Char('#'));
|
||||
lastAnchor = (hsh>=0 ? src.left(hsh) : src) + lastAnchor;
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
void HelpViewer::contextMenuEvent(QContextMenuEvent *e)
|
||||
{
|
||||
QMenu menu(QLatin1String(""), 0);
|
||||
|
||||
QUrl link;
|
||||
QAction *copyAnchorAction = 0;
|
||||
if (hasAnchorAt(e->pos())) {
|
||||
link = anchorAt(e->pos());
|
||||
if (link.isRelative())
|
||||
link = source().resolved(link);
|
||||
copyAnchorAction = menu.addAction(tr("Copy &Link Location"));
|
||||
copyAnchorAction->setEnabled(!link.isEmpty() && link.isValid());
|
||||
|
||||
menu.addAction(tr("Open Link in New Tab\tCtrl+LMB"), this,
|
||||
SLOT(openLinkInNewTab()));
|
||||
menu.addSeparator();
|
||||
}
|
||||
menu.addActions(parentWidget->globalActions());
|
||||
QAction *action = menu.exec(e->globalPos());
|
||||
if (action == copyAnchorAction)
|
||||
QApplication::clipboard()->setText(link.toString());
|
||||
}
|
||||
|
||||
void HelpViewer::mouseReleaseEvent(QMouseEvent *e)
|
||||
{
|
||||
if (e->button() == Qt::XButton1) {
|
||||
QTextBrowser::backward();
|
||||
return;
|
||||
}
|
||||
|
||||
if (e->button() == Qt::XButton2) {
|
||||
QTextBrowser::forward();
|
||||
return;
|
||||
}
|
||||
|
||||
controlPressed = e->modifiers() & Qt::ControlModifier;
|
||||
if ((controlPressed && hasAnchorAt(e->pos())) ||
|
||||
(e->button() == Qt::MidButton && hasAnchorAt(e->pos()))) {
|
||||
openLinkInNewTab();
|
||||
return;
|
||||
}
|
||||
|
||||
QTextBrowser::mouseReleaseEvent(e);
|
||||
}
|
||||
|
||||
void HelpViewer::keyPressEvent(QKeyEvent *e)
|
||||
{
|
||||
if ((e->key() == Qt::Key_Home && e->modifiers() != Qt::NoModifier)
|
||||
|| (e->key() == Qt::Key_End && e->modifiers() != Qt::NoModifier)) {
|
||||
QKeyEvent* event = new QKeyEvent(e->type(), e->key(), Qt::NoModifier,
|
||||
e->text(), e->isAutoRepeat(), e->count());
|
||||
e = event;
|
||||
}
|
||||
QTextBrowser::keyPressEvent(e);
|
||||
}
|
||||
|
||||
void HelpViewer::home()
|
||||
{
|
||||
if (homeUrl.isValid())
|
||||
setSource(homeUrl);
|
||||
}
|
||||
|
||||
void HelpViewer::wheelEvent(QWheelEvent *e)
|
||||
{
|
||||
if (e->modifiers() == Qt::CTRL) {
|
||||
e->accept();
|
||||
(e->delta() > 0) ? zoomIn() : zoomOut();
|
||||
} else {
|
||||
e->ignore();
|
||||
QTextBrowser::wheelEvent(e);
|
||||
}
|
||||
}
|
||||
|
||||
#endif // !defined(QT_NO_WEBKIT)
|
||||
|
||||
QT_END_NAMESPACE
|
||||
Reference in New Issue
Block a user