xca/widgets/Help.cpp
Christian Hohnstaedt ff7704ff0b Add context sensitive documentation
All dialogs get the "Qt::WindowModal" modality to
operate the Help window in parallel
while also blocking the dialog parent windows.

The manageRevocations() moved from model to view

The Details dialogs become more self-sufficient.
There is a statc start method that shows the dialog and
updates name and comment after accept().
This allows recursive starts of certificate details and
independence of mainwin.
It is necessary to set the current toplevel widget as parent
for the next dialog to not block the application.
2021-04-23 15:50:13 +02:00

93 lines
2.0 KiB
C++

/* vi: set sw=4 ts=4:
*
* Copyright (C) 2001 - 2012 Christian Hohnstaedt.
*
* All rights reserved.
*/
#include "Help.h"
#include "lib/func.h"
#include <QDebug>
#include <QDialog>
#include <QHelpEngine>
#include <QDialogButtonBox>
Help::Help() : QWidget(NULL)
{
setupUi(this);
setWindowTitle(XCA_TITLE);
textbox->setSearchPaths(QStringList(getDocDir()));
textbox->setOpenExternalLinks(true);
textbox->clearHistory();
helpengine = new QHelpEngineCore(getDocDir() + "/xca.qhc");
}
Help::~Help()
{
delete helpengine;
}
void Help::display(const QUrl &url)
{
#if QT_VERSION < 0x050000
QString path = url.path();
int pos = path.lastIndexOf("/");
if (pos != -1)
path = path.mid(pos+1);
textbox->setSource(QUrl(path));
#else
textbox->setSource(QUrl(url.fileName()));
#endif
textbox->scrollToAnchor(url.fragment());
show();
}
void Help::content()
{
display(QUrl("qthelp://org.sphinx.xca/doc/index.html"));
}
QMap<QString, QUrl> Help::url_by_ctx(const QString &ctx) const
{
return helpengine->linksForIdentifier(QString("%1.%1").arg(ctx));
}
void Help::contexthelp(const QString &context)
{
QMap<QString, QUrl> helpctx = url_by_ctx(context);
if (helpctx.count())
display(helpctx.constBegin().value());
}
void Help::contexthelp()
{
QObject *o = sender();
if (!o)
return;
QString ctx = o->property("help_ctx").toString();
if (ctx.isEmpty())
return;
contexthelp(ctx);
}
void Help::register_ctxhelp_button(QDialog *dlg, const QString &help_ctx) const
{
QDialogButtonBox *buttonBox =
dlg->findChild<QDialogButtonBox*>("buttonBox");
if (!buttonBox || help_ctx.isEmpty())
return;
dlg->setWindowModality(Qt::WindowModal);
buttonBox->addButton(QDialogButtonBox::Help);
buttonBox->setProperty("help_ctx", QVariant(help_ctx));
connect(buttonBox, SIGNAL(helpRequested()), this, SLOT(contexthelp()));
if (url_by_ctx(help_ctx).count() == 0) {
qWarning() << "Unknown help context: " << help_ctx;
buttonBox->button(QDialogButtonBox::Help)->setEnabled(false);
}
}