KCheckAccelerators Class Reference

#include <kcheckaccelerators.h>

Inheritance diagram for KCheckAccelerators:

Public Member Functions
bool	eventFilter (QObject *, QEvent *e)

Static Public Member Functions
static void	initiateIfNeeded (QObject *parent)

Detailed Description

This class allows translators (and application developers) to check for accelerator conflicts in menu and widgets. Put the following in your kdeglobals (or the config file for the application you're testing):

[Development]
CheckAccelerators=F12
AutoCheckAccelerators=false
AlwaysShowCheckAccelerators=false

The checking can be either manual or automatic. To perform manual check, press the keyboard shortcut set to 'CheckAccelerators' (here F12). If automatic checking is enabled by setting 'AutoCheckAccelerators' to true, check will be performed every time the GUI changes. It's possible that in certain cases the check will be done also when no visible changes in the GUI happen or the check won't be done even if the GUI changed (in the latter case, use manual check ). Automatic checks can be anytime disabled by the checkbox in the dialog presenting the results of the check. If you set 'AlwaysShowCheckAccelerators' to true, the dialog will be shown even if the automatic check didn't find any conflicts, and all submenus will be shown, even those without conflicts.

The dialog first lists the name of the window, then all results for all menus (if the window has a menubar) and then result for all controls in the active window (if there are any checkboxes etc.). For every submenu and all controls there are shown all conflicts grouped by accelerator, and a list of all used accelerators.

COPY WIDGET TEXT:

You can copy widgets' texts to find them in translation files faster by middle-clicking them. Put the following lines in ~/.kde4/share/config/kdeglobals (or in rc file for specific app):

[Development]
CopyWidgetText=true
CopyWidgetTextCommand=find_in_po_script "%1" "%2"

Where %1 gets replaced with program name and %2 - with text. CopyWidgetTextCommand may be empty, in which case the text gets copied to clipboard. Press Ctrl+MMB to get widget text w/o accelerator mark (&)

Definition at line 84 of file kcheckaccelerators.h.

Member Function Documentation

bool KCheckAccelerators::eventFilter	(	QObject *	obj,
		QEvent *	e
	)

Re-implemented to filter the parent's events.

Definition at line 93 of file kcheckaccelerators.cpp.

void KCheckAccelerators::initiateIfNeeded ( QObject *  parent )

static

Creates a KCheckAccelerators instance for the given object if this feature is enabled in kdeglobals.

Parameters

parent

the parent to check

Definition at line 56 of file kcheckaccelerators.cpp.

---

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

• kcheckaccelerators.h
• kcheckaccelerators.cpp