qgsconfigureshortcutsdialog.cpp

Go to the documentation of this file.

/***************************************************************************
    qgsconfigureshortcutsdialog.cpp
    -------------------------------
    begin                : May 2009
    copyright            : (C) 2009 by Martin Dobias
    email                : wonder dot sk at gmail dot com
 ***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
 
#include "qgsconfigureshortcutsdialog.h"
 
#include "qgsapplication.h"
#include "qgsgui.h"
#include "qgslogger.h"
#include "qgsprojectversion.h"
#include "qgssettings.h"
#include "qgsshortcutsmanager.h"
 
#include <QAction>
#include <QDomDocument>
#include <QFileDialog>
#include <QKeyEvent>
#include <QKeySequence>
#include <QMenu>
#include <QMessageBox>
#include <QPdfWriter>
#include <QShortcut>
#include <QString>
#include <QTextCharFormat>
#include <QTextCursor>
#include <QTextDocument>
#include <QTextStream>
#include <QTextTable>
#include <QTextTableCellFormat>
#include <QTextTableFormat>
 
#include "moc_qgsconfigureshortcutsdialog.cpp"
 
using namespace Qt::StringLiterals;
 
QgsConfigureShortcutsDialog::QgsConfigureShortcutsDialog( QWidget *parent, QgsShortcutsManager *manager )
  : QDialog( parent )
  , mManager( manager )
{
  setupUi( this );
  QgsGui::enableAutoGeometryRestore( this );
 
  mSaveMenu = new QMenu( this );
  mSaveUserShortcuts = new QAction( tr( "Save User Shortcuts…" ), this );
  mSaveMenu->addAction( mSaveUserShortcuts );
  connect( mSaveUserShortcuts, &QAction::triggered, this, [this] { saveShortcuts( false ); } );
 
  mSaveAllShortcuts = new QAction( tr( "Save All Shortcuts…" ), this );
  mSaveMenu->addAction( mSaveAllShortcuts );
  connect( mSaveAllShortcuts, &QAction::triggered, this, [this] { saveShortcuts(); } );
 
  mSaveAsPdf = new QAction( tr( "Save as PDF…" ), this );
  mSaveMenu->addAction( mSaveAsPdf );
  connect( mSaveAsPdf, &QAction::triggered, this, &QgsConfigureShortcutsDialog::saveShortcutsPdf );
 
  btnSaveShortcuts->setMenu( mSaveMenu );
 
  connect( mLeFilter, &QgsFilterLineEdit::textChanged, this, &QgsConfigureShortcutsDialog::mLeFilter_textChanged );
 
  if ( !mManager )
    mManager = QgsGui::shortcutsManager();
 
  connect( buttonBox, &QDialogButtonBox::helpRequested, this, &QgsConfigureShortcutsDialog::showHelp ); // Vérifier nommage des boutons
  connect( btnChangeShortcut, &QAbstractButton::clicked, this, &QgsConfigureShortcutsDialog::changeShortcut );
  connect( btnResetShortcut, &QAbstractButton::clicked, this, &QgsConfigureShortcutsDialog::resetShortcut );
  connect( btnSetNoShortcut, &QAbstractButton::clicked, this, &QgsConfigureShortcutsDialog::setNoShortcut );
  connect( btnLoadShortcuts, &QAbstractButton::clicked, this, &QgsConfigureShortcutsDialog::loadShortcuts );
 
  connect( treeActions, &QTreeWidget::currentItemChanged, this, &QgsConfigureShortcutsDialog::actionChanged );
 
  populateActions();
}
 
void QgsConfigureShortcutsDialog::populateActions()
{
  const QList<QObject *> objects = mManager->listAll();
 
  QList<QTreeWidgetItem *> items;
  items.reserve( objects.count() );
  const auto constObjects = objects;
  for ( QObject *obj : constObjects )
  {
    QString actionText;
    QString sequence;
    QIcon icon;
    const QString settingKey = mManager->objectSettingKey( obj );
 
    if ( QAction *action = qobject_cast<QAction *>( obj ) )
    {
      actionText = action->text();
      actionText.remove( '&' ); // remove the accelerator
      sequence = action->shortcut().toString( QKeySequence::NativeText );
      icon = action->icon();
    }
    else if ( QShortcut *shortcut = qobject_cast<QShortcut *>( obj ) )
    {
      actionText = shortcut->whatsThis();
      sequence = shortcut->key().toString( QKeySequence::NativeText );
      icon = shortcut->property( "Icon" ).value<QIcon>();
    }
    else
    {
      continue;
    }
 
    if ( actionText.isEmpty() )
    {
      continue;
    }
 
    QStringList lst;
    lst << actionText << sequence;
    QTreeWidgetItem *item = new QTreeWidgetItem( lst );
    item->setIcon( 0, icon );
    item->setData( 0, Qt::UserRole, QVariant::fromValue( obj ) );
    item->setToolTip( 0, settingKey );
    items.append( item );
  }
 
  treeActions->addTopLevelItems( items );
 
  // make sure everything's visible and sorted
  treeActions->resizeColumnToContents( 0 );
  treeActions->sortItems( 0, Qt::AscendingOrder );
 
  actionChanged( treeActions->currentItem(), nullptr );
}
 
void QgsConfigureShortcutsDialog::saveShortcuts( bool saveAll )
{
  QString fileName = QFileDialog::getSaveFileName( this, tr( "Save Shortcuts" ), QDir::homePath(), tr( "XML file" ) + " (*.xml);;" + tr( "All files" ) + " (*)" );
  // return dialog focus on Mac
  activateWindow();
  raise();
 
  if ( fileName.isEmpty() )
    return;
 
  // ensure the user never omitted the extension from the file name
  if ( !fileName.endsWith( ".xml"_L1, Qt::CaseInsensitive ) )
  {
    fileName += ".xml"_L1;
  }
 
  QFile file( fileName );
  if ( !file.open( QIODevice::WriteOnly | QIODevice::Text | QIODevice::Truncate ) )
  {
    QMessageBox::warning( this, tr( "Saving Shortcuts" ), tr( "Cannot write file %1:\n%2." ).arg( fileName, file.errorString() ) );
    return;
  }
 
  QgsSettings settings;
 
  QDomDocument doc( u"shortcuts"_s );
  QDomElement root = doc.createElement( u"qgsshortcuts"_s );
  root.setAttribute( u"version"_s, u"1.1"_s );
  root.setAttribute( u"locale"_s, settings.value( QgsApplication::settingsLocaleUserLocale->key(), "en_US" ).toString() );
  doc.appendChild( root );
 
  const QList<QObject *> objects = mManager->listAll();
  for ( QObject *obj : objects )
  {
    QString actionText;
    QString actionShortcut;
    QString actionSettingKey;
    QKeySequence sequence;
 
    if ( QAction *action = qobject_cast<QAction *>( obj ) )
    {
      actionText = action->text().remove( '&' );
      actionShortcut = action->shortcut().toString( QKeySequence::NativeText );
      sequence = mManager->defaultKeySequence( action );
    }
    else if ( QShortcut *shortcut = qobject_cast<QShortcut *>( obj ) )
    {
      actionText = shortcut->whatsThis();
      actionShortcut = shortcut->key().toString( QKeySequence::NativeText );
      sequence = mManager->defaultKeySequence( shortcut );
    }
    else
    {
      continue;
    }
 
    actionSettingKey = mManager->objectSettingKey( obj );
 
    if ( actionSettingKey.isEmpty() )
    {
      continue;
    }
 
    // skip unchanged shortcuts if only user-definied were requested
    if ( !saveAll && sequence == QKeySequence( actionShortcut ) )
    {
      continue;
    }
 
    QDomElement el = doc.createElement( u"action"_s );
    el.setAttribute( u"name"_s, actionText );
    el.setAttribute( u"shortcut"_s, actionShortcut );
    el.setAttribute( u"setting"_s, actionSettingKey );
    root.appendChild( el );
  }
 
  QTextStream out( &file );
  doc.save( out, 4 );
}
 
void QgsConfigureShortcutsDialog::loadShortcuts()
{
  const QString fileName = QFileDialog::getOpenFileName( this, tr( "Load Shortcuts" ), QDir::homePath(), tr( "XML file" ) + " (*.xml);;" + tr( "All files" ) + " (*)" );
 
  if ( fileName.isEmpty() )
  {
    return;
  }
 
  QFile file( fileName );
  if ( !file.open( QIODevice::ReadOnly | QIODevice::Text ) )
  {
    QMessageBox::warning( this, tr( "Loading Shortcuts" ), tr( "Cannot read file %1:\n%2." ).arg( fileName, file.errorString() ) );
    return;
  }
 
  QDomDocument doc;
  QString errorStr;
  int errorLine;
  int errorColumn;
 
  if ( !doc.setContent( &file, true, &errorStr, &errorLine, &errorColumn ) )
  {
    QMessageBox::information( this, tr( "Loading Shortcuts" ), tr( "Parse error at line %1, column %2:\n%3" ).arg( errorLine ).arg( errorColumn ).arg( errorStr ) );
    return;
  }
 
  const QDomElement root = doc.documentElement();
  if ( root.tagName() != "qgsshortcuts"_L1 )
  {
    QMessageBox::information( this, tr( "Loading Shortcuts" ), tr( "The file is not an shortcuts exchange file." ) );
    return;
  }
 
  QString currentLocale;
 
  const bool localeOverrideFlag = QgsApplication::settingsLocaleOverrideFlag->value();
  if ( localeOverrideFlag )
  {
    currentLocale = QgsApplication::settingsLocaleUserLocale->valueWithDefaultOverride( "en_US" );
  }
  else // use QGIS locale
  {
    currentLocale = QLocale().name();
  }
 
  const QString versionStr = root.attribute( u"version"_s );
  const QgsProjectVersion version( versionStr );
 
  if ( root.attribute( u"locale"_s ) != currentLocale )
  {
    if ( version < QgsProjectVersion( u"1.1"_s ) )
    {
      QMessageBox::information( this, tr( "Loading Shortcuts" ), tr( "The file contains shortcuts created with different locale, so you can't use it." ) );
      return;
    }
    else // From version 1.1, if objectName is not empty, it is used as key.
    {
      QMessageBox::information( this, tr( "Loading Shortcuts" ), tr( "The file contains shortcuts created with different locale, so some shortcuts may not work." ) );
    }
  }
 
  QString actionName;
  QString actionShortcut;
  QString actionSettingKey;
 
  QDomElement child = root.firstChildElement();
  ActionOnExisting actionOnExisting = ActionOnExisting::Ask;
  while ( !child.isNull() )
  {
    actionShortcut = child.attribute( u"shortcut"_s );
    QKeySequence actionShortcutSequence( actionShortcut );
    QString previousText;
 
    if ( version < QgsProjectVersion( u"1.1"_s ) )
    {
      actionName = child.attribute( u"name"_s );
      QShortcut *previousShortcut = mManager->shortcutForSequence( actionShortcutSequence );
      QAction *previousAction = mManager->actionForSequence( actionShortcutSequence );
      if ( previousShortcut && previousShortcut->objectName() != actionName )
      {
        previousText = previousShortcut->whatsThis();
      }
      else if ( previousAction && previousAction->objectName() != actionName )
      {
        previousText = previousAction->text().remove( '&' );
      }
      if ( !previousText.isEmpty() )
      {
        QString text;
        if ( QAction *action = mManager->actionByName( actionName ) )
        {
          text = action->text().remove( '&' );
        }
        else if ( QShortcut *shortcut = mManager->shortcutByName( actionName ) )
        {
          text = shortcut->whatsThis();
        }
 
        if ( actionOnExisting == ActionOnExisting::Ask )
        {
          const int res = QMessageBox::
            question( this, tr( "Load Shortcut" ), tr( "Shortcut %1 is already assigned to action %2. Reassign to %3?" ).arg( actionShortcut, previousText, text ), QMessageBox::YesToAll | QMessageBox::Yes | QMessageBox::No | QMessageBox::NoToAll );
          if ( res == QMessageBox::No || res == QMessageBox::NoToAll )
          {
            if ( res == QMessageBox::NoToAll )
            {
              actionOnExisting = ActionOnExisting::SkipAll;
            }
            child = child.nextSiblingElement();
            continue;
          }
          if ( res == QMessageBox::YesToAll )
          {
            actionOnExisting = ActionOnExisting::ReassignAll;
          }
        }
        else if ( actionOnExisting == ActionOnExisting::SkipAll )
        {
          child = child.nextSiblingElement();
          continue;
        }
        mManager->setObjectKeySequence( previousAction ? qobject_cast<QObject *>( previousAction ) : qobject_cast<QObject *>( previousShortcut ), QString() );
      }
      mManager->setKeySequence( actionName, actionShortcut );
    }
    else
    {
      actionSettingKey = child.attribute( u"setting"_s );
      QObject *obj = mManager->objectForSettingKey( actionSettingKey );
      if ( obj )
      {
        QObject *previousObj = mManager->objectForSequence( actionShortcutSequence );
        if ( previousObj && previousObj != obj )
        {
          if ( QAction *previousAction = qobject_cast<QAction *>( previousObj ) )
          {
            previousText = previousAction->text().remove( '&' );
          }
          else if ( QShortcut *previousShortcut = qobject_cast<QShortcut *>( previousObj ) )
          {
            previousText = previousShortcut->whatsThis();
          }
        }
 
        if ( !previousText.isEmpty() )
        {
          QString text;
          if ( QAction *action = qobject_cast<QAction *>( obj ) )
          {
            text = action->text().remove( '&' );
          }
          else if ( QShortcut *shortcut = qobject_cast<QShortcut *>( obj ) )
          {
            text = shortcut->whatsThis();
          }
 
          if ( actionOnExisting == ActionOnExisting::Ask )
          {
            const int res = QMessageBox::
              question( this, tr( "Load Shortcut" ), tr( "Shortcut %1 is already assigned to action %2. Reassign to %3?" ).arg( actionShortcut, previousText, text ), QMessageBox::YesToAll | QMessageBox::Yes | QMessageBox::No | QMessageBox::NoToAll );
            if ( res == QMessageBox::No || res == QMessageBox::NoToAll )
            {
              if ( res == QMessageBox::NoToAll )
              {
                actionOnExisting = ActionOnExisting::SkipAll;
              }
              child = child.nextSiblingElement();
              continue;
            }
            if ( res == QMessageBox::YesToAll )
            {
              actionOnExisting = ActionOnExisting::ReassignAll;
            }
          }
          else if ( actionOnExisting == ActionOnExisting::SkipAll )
          {
            child = child.nextSiblingElement();
            continue;
          }
          mManager->setObjectKeySequence( previousObj, QString() );
        }
        mManager->setObjectKeySequence( obj, actionShortcut );
      }
    }
 
    child = child.nextSiblingElement();
  }
 
  treeActions->clear();
  populateActions();
}
 
void QgsConfigureShortcutsDialog::changeShortcut()
{
  setFocus(); // make sure we have focus
  setGettingShortcut( true );
}
 
void QgsConfigureShortcutsDialog::resetShortcut()
{
  QObject *object = currentObject();
  const QString sequence = mManager->objectDefaultKeySequence( object );
  setCurrentActionShortcut( sequence );
}
 
void QgsConfigureShortcutsDialog::setNoShortcut()
{
  setCurrentActionShortcut( QKeySequence() );
}
 
QAction *QgsConfigureShortcutsDialog::currentAction()
{
  return qobject_cast<QAction *>( currentObject() );
}
 
QShortcut *QgsConfigureShortcutsDialog::currentShortcut()
{
  return qobject_cast<QShortcut *>( currentObject() );
}
 
void QgsConfigureShortcutsDialog::actionChanged( QTreeWidgetItem *current, QTreeWidgetItem *previous )
{
  Q_UNUSED( current )
  Q_UNUSED( previous )
  // cancel previous shortcut setting (if any)
  setGettingShortcut( false );
 
  QString shortcut;
  QKeySequence sequence;
  if ( QAction *action = currentAction() )
  {
    // show which one is the default action
    shortcut = mManager->defaultKeySequence( action );
    sequence = action->shortcut();
  }
  else if ( QShortcut *object = currentShortcut() )
  {
    // show which one is the default action
    shortcut = mManager->defaultKeySequence( object );
    sequence = object->key();
  }
  else
  {
    return;
  }
 
  if ( shortcut.isEmpty() )
    shortcut = tr( "None" );
  btnResetShortcut->setText( tr( "Set default (%1)" ).arg( shortcut ) );
 
  // if there's no shortcut, disable set none
  btnSetNoShortcut->setEnabled( !sequence.isEmpty() );
  // if the shortcut is default, disable set default
  btnResetShortcut->setEnabled( sequence != QKeySequence( shortcut ) );
}
 
void QgsConfigureShortcutsDialog::keyPressEvent( QKeyEvent *event )
{
  if ( !mGettingShortcut )
  {
    QDialog::keyPressEvent( event );
    return;
  }
 
  const int key = event->key();
  switch ( key )
  {
    // modifiers
    case Qt::Key_Meta:
      mModifiers |= Qt::META;
      updateShortcutText();
      break;
    case Qt::Key_Alt:
      mModifiers |= Qt::ALT;
      updateShortcutText();
      break;
    case Qt::Key_Control:
      mModifiers |= Qt::CTRL;
      updateShortcutText();
      break;
    case Qt::Key_Shift:
      mModifiers |= Qt::SHIFT;
      updateShortcutText();
      break;
 
    // escape aborts the acquisition of shortcut
    case Qt::Key_Escape:
      setGettingShortcut( false );
      break;
 
    default:
      mKey = key;
      updateShortcutText();
  }
}
 
void QgsConfigureShortcutsDialog::keyReleaseEvent( QKeyEvent *event )
{
  if ( !mGettingShortcut )
  {
    QDialog::keyReleaseEvent( event );
    return;
  }
 
  const int key = event->key();
  switch ( key )
  {
    // modifiers
    case Qt::Key_Meta:
      mModifiers &= ~Qt::META;
      updateShortcutText();
      break;
    case Qt::Key_Alt:
      mModifiers &= ~Qt::ALT;
      updateShortcutText();
      break;
    case Qt::Key_Control:
      mModifiers &= ~Qt::CTRL;
      updateShortcutText();
      break;
    case Qt::Key_Shift:
      mModifiers &= ~Qt::SHIFT;
      updateShortcutText();
      break;
 
    case Qt::Key_Escape:
      break;
 
    default:
    {
      // an ordinary key - set it with modifiers as a shortcut
      setCurrentActionShortcut( QKeySequence( mModifiers + mKey ) );
      setGettingShortcut( false );
    }
  }
}
 
QObject *QgsConfigureShortcutsDialog::currentObject()
{
  if ( !treeActions->currentItem() )
    return nullptr;
 
  QObject *object = treeActions->currentItem()->data( 0, Qt::UserRole ).value<QObject *>();
  return object;
}
 
void QgsConfigureShortcutsDialog::updateShortcutText()
{
  // update text of the button so that user can see what has typed already
  const QKeySequence s( mModifiers + mKey );
  btnChangeShortcut->setText( tr( "Input: " ) + s.toString( QKeySequence::NativeText ) );
}
 
void QgsConfigureShortcutsDialog::setGettingShortcut( bool getting )
{
  mModifiers = 0;
  mKey = 0;
  mGettingShortcut = getting;
  if ( !getting )
  {
    btnChangeShortcut->setChecked( false );
    btnChangeShortcut->setText( tr( "Change" ) );
  }
  else
  {
    updateShortcutText();
  }
}
 
void QgsConfigureShortcutsDialog::setCurrentActionShortcut( const QKeySequence &s )
{
  QObject *object = currentObject();
  if ( !object )
    return;
 
  // first check whether this action is not taken already
  QObject *otherObject = mManager->objectForSequence( s );
  if ( otherObject == object )
    return;
 
  if ( otherObject )
  {
    QString otherText;
    if ( QAction *otherAction = qobject_cast<QAction *>( otherObject ) )
    {
      otherText = otherAction->text();
      otherText.remove( '&' ); // remove the accelerator
    }
    else if ( QShortcut *otherShortcut = qobject_cast<QShortcut *>( otherObject ) )
    {
      otherText = otherShortcut->whatsThis();
    }
 
    const int res = QMessageBox::question( this, tr( "Change Shortcut" ), tr( "This shortcut is already assigned to action %1. Reassign?" ).arg( otherText ), QMessageBox::Yes | QMessageBox::No );
 
    if ( res != QMessageBox::Yes )
      return;
 
    // reset action of the conflicting other action!
    mManager->setObjectKeySequence( otherObject, QString() );
    QList<QTreeWidgetItem *> items = treeActions->findItems( otherText, Qt::MatchExactly );
    if ( !items.isEmpty() ) // there should be exactly one
      items[0]->setText( 1, QString() );
  }
 
  // update manager
  mManager->setObjectKeySequence( object, s.toString( QKeySequence::NativeText ) );
 
  // update gui
  treeActions->currentItem()->setText( 1, s.toString( QKeySequence::NativeText ) );
 
  actionChanged( treeActions->currentItem(), nullptr );
}
 
void QgsConfigureShortcutsDialog::mLeFilter_textChanged( const QString &text )
{
  for ( int i = 0; i < treeActions->topLevelItemCount(); i++ )
  {
    QTreeWidgetItem *item = treeActions->topLevelItem( i );
    if ( !item->text( 0 ).contains( text, Qt::CaseInsensitive ) && !item->text( 1 ).contains( text, Qt::CaseInsensitive ) )
    {
      item->setHidden( true );
    }
    else
    {
      item->setHidden( false );
    }
  }
}
 
void QgsConfigureShortcutsDialog::showHelp()
{
  QgsHelp::openHelp( u"introduction/qgis_configuration.html#shortcuts"_s );
}
 
void QgsConfigureShortcutsDialog::saveShortcutsPdf()
{
  QString fileName = QFileDialog::getSaveFileName( this, tr( "Save Shortcuts" ), QDir::homePath(), tr( "PDF file" ) + " (*.pdf);;" + tr( "All files" ) + " (*)" );
  // return dialog focus on Mac
  activateWindow();
  raise();
 
  if ( fileName.isEmpty() )
    return;
 
  if ( !fileName.endsWith( ".pdf"_L1, Qt::CaseInsensitive ) )
  {
    fileName += ".pdf"_L1;
  }
 
  QTextDocument *document = new QTextDocument;
  QTextCursor cursor( document );
 
  QTextTableFormat tableFormat;
  tableFormat.setBorder( 0 );
  tableFormat.setCellSpacing( 0 );
  tableFormat.setCellPadding( 4 );
  tableFormat.setHeaderRowCount( 1 );
 
  QVector<QTextLength> constraints;
  constraints << QTextLength( QTextLength::PercentageLength, 5 );
  constraints << QTextLength( QTextLength::PercentageLength, 80 );
  constraints << QTextLength( QTextLength::PercentageLength, 15 );
  tableFormat.setColumnWidthConstraints( constraints );
 
  QTextTableCellFormat headerFormat;
  headerFormat.setFontWeight( QFont::Bold );
  headerFormat.setBottomPadding( 4 );
 
  QTextCharFormat rowFormat;
  rowFormat.setVerticalAlignment( QTextCharFormat::AlignMiddle );
 
  QTextCharFormat altRowFormat;
  altRowFormat.setBackground( QBrush( QColor( 238, 238, 236 ) ) );
  altRowFormat.setVerticalAlignment( QTextCharFormat::AlignMiddle );
 
  int row = 0;
  QTextTable *table = cursor.insertTable( 1, 3, tableFormat );
  table->mergeCells( 0, 0, 1, 2 );
  QTextCursor c = table->cellAt( row, 0 ).firstCursorPosition();
  c.setCharFormat( headerFormat );
  c.insertText( tr( "Action" ) );
  c = table->cellAt( row, 2 ).firstCursorPosition();
  c.setCharFormat( headerFormat );
  c.insertText( tr( "Shortcut" ) );
 
  const QList<QObject *> objects = mManager->listAll();
  for ( QObject *obj : objects )
  {
    QString actionText;
    QString sequence;
    QIcon icon;
 
    if ( QAction *action = qobject_cast<QAction *>( obj ) )
    {
      actionText = action->text().remove( '&' );
      sequence = action->shortcut().toString( QKeySequence::NativeText );
      icon = action->icon();
    }
    else if ( QShortcut *shortcut = qobject_cast<QShortcut *>( obj ) )
    {
      actionText = shortcut->whatsThis();
      sequence = shortcut->key().toString( QKeySequence::NativeText );
      icon = shortcut->property( "Icon" ).value<QIcon>();
    }
    else
    {
      continue;
    }
 
    // skip actions without shortcut and name
    if ( actionText.isEmpty() || sequence.isEmpty() )
    {
      continue;
    }
 
    row += 1;
    table->appendRows( 1 );
 
    if ( row % 2 )
    {
      table->cellAt( row, 0 ).setFormat( altRowFormat );
      table->cellAt( row, 1 ).setFormat( altRowFormat );
      table->cellAt( row, 2 ).setFormat( altRowFormat );
    }
    else
    {
      table->cellAt( row, 0 ).setFormat( rowFormat );
      table->cellAt( row, 1 ).setFormat( rowFormat );
      table->cellAt( row, 2 ).setFormat( rowFormat );
    }
 
    if ( !icon.isNull() )
    {
      c = table->cellAt( row, 0 ).firstCursorPosition();
      c.insertImage( icon.pixmap( QSize( 24, 24 ) ).toImage() );
    }
    table->cellAt( row, 1 ).firstCursorPosition().insertText( actionText );
    table->cellAt( row, 2 ).firstCursorPosition().insertText( sequence );
  }
 
  QPdfWriter pdfWriter( fileName );
  pdfWriter.setPageLayout( QPageLayout( QPageSize( QPageSize::A4 ), QPageLayout::Portrait, QMarginsF( 20, 10, 10, 10 ) ) );
  document->setPageSize( QSizeF( pdfWriter.pageLayout().fullRect( QPageLayout::Point ).size() ) );
  document->print( &pdfWriter );
}