DynamicShortcutsWidget Class Reference

Widget for displaying and editing shortcuts. More...

#include <dynamicshortcutswidget.h>

Collaboration diagram for DynamicShortcutsWidget:

Public Member Functions
	DynamicShortcutsWidget (QWidget *parent=0)
	Constructor. More...
virtual	~DynamicShortcutsWidget ()
	Destructor.
void	updateShortcuts ()
	Updates shortcuts of all actions according to changes. More...
bool	areShortcutsUnique ()
	Checks whether set shortcuts are unique. More...
void	populate (const QList< QAction * > actions)
	Populates this widget with shortcut widgets for given actions. More...

Detailed Description

Widget for displaying and editing shortcuts.

Definition at line 44 of file dynamicshortcutswidget.h.

Constructor & Destructor Documentation

DynamicShortcutsWidget::DynamicShortcutsWidget ( QWidget *  parent = 0 )

explicit

Constructor.

Parameters

parent

Pointer to parent object.

Definition at line 44 of file dynamicshortcutswidget.cpp.

                                                              : QWidget(parent) {
  // Create layout for this control and set is as active.
  m_layout = new QGridLayout(this);
  m_layout->setMargin(0);

  setLayout(m_layout);
}

Member Function Documentation

bool DynamicShortcutsWidget::areShortcutsUnique

(

)

Checks whether set shortcuts are unique.

Returns

Returns true if all shortcuts are unique, otherwise false.

Definition at line 56 of file dynamicshortcutswidget.cpp.

                                                {
  QList<QKeySequence> all_shortcuts;

  // Obtain all shortcuts.
  foreach (const ActionBinding &binding, m_actionBindings) {
    QKeySequence new_shortcut = binding.second->shortcut();

    if (!new_shortcut.isEmpty() && all_shortcuts.contains(new_shortcut)) {
      // Problem, two identical non-empty shortcuts found.
      return false;
    }
    else {
      all_shortcuts.append(binding.second->shortcut());
    }
  }

  return true;
}

void DynamicShortcutsWidget::populate

(

const QList< QAction * >

actions

)

Populates this widget with shortcut widgets for given actions.

This gets initial shortcut for each action from its properties, NOT from the application settings, so shortcuts from settings need to be assigned to actions before calling this method.

Definition at line 81 of file dynamicshortcutswidget.cpp.

                                                                   {
  m_actionBindings.clear();

  int row_id = 0;

  foreach (QAction *action, actions) {
    // Create shortcut catcher for this action and set default shortcut.
    ShortcutCatcher *catcher = new ShortcutCatcher(this);
    catcher->setDefaultShortcut(action->shortcut());

    // Store information for re-initialization of shortcuts
    // of actions when widget gets "confirmed".
    QPair<QAction*,ShortcutCatcher*> new_binding;
    new_binding.first = action;
    new_binding.second = catcher;

    m_actionBindings << new_binding;

    // Add new catcher to our control.
    QLabel *action_label = new QLabel(this);
    action_label->setText(action->text().remove('&'));
    action_label->setToolTip(action->toolTip());
    action_label->setSizePolicy(QSizePolicy::Minimum, QSizePolicy::Preferred);

    QLabel *action_icon = new QLabel(this);
    action_icon->setPixmap(action->icon().pixmap(ICON_SIZE_SETTINGS, ICON_SIZE_SETTINGS));
    action_icon->setToolTip(action->toolTip());

    m_layout->addWidget(action_icon, row_id, 0);
    m_layout->addWidget(action_label, row_id, 1);
    m_layout->addWidget(catcher, row_id, 2);

    row_id++;
  }

  // Make sure that "spacer" is added.
  m_layout->setRowStretch(row_id, 1);
  m_layout->setColumnStretch(1, 1);
}

Here is the call graph for this function:

void DynamicShortcutsWidget::updateShortcuts

(

)

Updates shortcuts of all actions according to changes.

No access to settings is done here. Shortcuts are fetched from settings when applications starts and stored back to settings when application quits.

Definition at line 75 of file dynamicshortcutswidget.cpp.

                                             {
  foreach (const ActionBinding &binding, m_actionBindings) {
    binding.first->setShortcut(binding.second->shortcut());
  }
}

---

The documentation for this class was generated from the following files:

• dynamicshortcutswidget.h
• dynamicshortcutswidget.cpp