Référence de la classe KKbdAccessExtensions

#include <kkbdaccessextensions.h>

Graphe de collaboration de KKbdAccessExtensions:

[légende]Liste de tous les membres

Fonctions membres publiques
	KKbdAccessExtensions (KMainWindow *parent, const char *name=0)
virtual	~KKbdAccessExtensions ()
int	stepSize () const
void	setStepSize (int s)
Fonctions membres protégées
bool	eventFilter (QObject *o, QEvent *e)
QWidgetList *	getAllPanels ()
void	nextHandle ()
void	prevHandle ()
void	exitSizing ()
void	resizePanelFromKey (int key, int state)
void	resizePanel (int dx, int dy, int state)
void	showIcon ()
void	hideIcon ()
void	displayAccessKeys ()
bool	handleAccessKey (const QKeyEvent *ev)
Attributs privés
KKbdAccessExtensionsPrivate *	d

---

Description détaillée

KKbdAccessExtensions is an object that improves accessibility for motor impaired users who may not be able to easily use a mouse. It adds two new capabilities using the keyboard:

• Resizing and positioning of panel widgets derived from QSplitter and QDockWindow.
• Setting focus to any widget that accepts focus.

Sizing Mode

Users may press F8 or Shift-F8 (defaults) to enter sizing mode. A sizing icon appears on the first QSplitter or QDockWindow handle found in the application (F8) or the last such handle (Shift+F8). (A "handle" is the divider bar that appears to the left, right, above, or below each panel of a QSplitter or QDockArea.)

Once in sizing mode, the following functions are available via the keyboard:

• F8 Moves to the next sizing handle. After the last handle, exits sizing mode.
• Shift+F8 Moves to the previous sizing handle. After the first handle, exits sizing mode.
• Esc Exits sizing mode.
• LeftArrow When on a vertical sizing handle, moves the handle to the left. When on a horizontal sizing handle, moves the handle up.
• RightArrow When on a vertical sizing handle, moves the handle to the right. When on a horizontal sizing handle, moves the handle down.
• UpArrow When on a vertical sizing handle, moves the handle to the left. When on a horizontal sizing handle, moves the handle up.
• DownArrow When on a vertical sizing handle, moves the handle to the right. When on a horizontal sizing handle, moves the handle down.
• PgUp Like LeftArrow or UpArrow, but moves the handle 5X farther to the left or up.
• PgDn Like RightArrow or DownArrow, but moves the handle 5X farther to the right or down.
• Enter (On numeric keypad). When on the handle of a QDockWindow, undocks or docks the widget. Ignored when on the handle of a QSplitter.

The default step size for each arrow key press is 10 pixels.

When a QDockWindow is undocked, the sizing icon appears in the center of the window. The arrow keys and PgUp/PgDn move the undocked window on the screen. Shifted arrow keys and PgUp/PgDn decrease/increase the size of the undocked window.

When the sizing icon is on a sizing handle, the mouse may also be used to move the handle without having to click and drag. When moving the mouse while sizing icon is on an undocked QDockWindow, the window moves with the mouse. Holding Shift down while moving the mouse sizes the QDockWindow.

Note:

Users can also move and size undocked windows using the Window Operations Menu (Alt+F3).

Clicking any mouse button exits sizing mode.

When entering sizing mode, the position of the mouse cursor is saved and restored when exiting sizing mode.

For a QSplitter or QDockWindow to be found, it must be in the kapp::allWidgets() list.

Focus Setting

Users can press Alt-F8. A small box appears in the upperleft corner of each visible widget on the screen that can accept focus. Each box is assigned a single letter or digit. User can press the corresponding key to set focus to the widget.

At most 36 such shortcuts are possible. If any application shortcuts are single letters or digits, those shortcuts are not in any of the boxes.

Clicking any mouse button exits Focus Setting mode.

Notes

The F8, Shift+F8, and Alt+F8 keys are KShortcuts and therefore user may choose different keys in the application's Configure Shortcuts dialog.

Note:

At present, these shortcuts may not be multi-key. If user sets multi-key shortcuts, they will not work.

F8/Shift+F8 are the default shortcuts because these are the keys used for similar functionality in GNOME and Java SWT.

Définition à la ligne 112 du fichier kkbdaccessextensions.h.

---

Documentation des contructeurs et destructeur

KKbdAccessExtensions::KKbdAccessExtensions	(	KMainWindow *	parent,
		const char *	name = 0
	)

Constructor.

Paramètres:

	parent	KMainWindow of the application. Required.
	name	(optional) Name of this object.

Définition à la ligne 169 du fichier kkbdaccessextensions.cpp.

Références KKbdAccessExtensionsPrivate::accessKeysAction, d, KKbdAccessExtensionsPrivate::fwdAction, KKbdAccessExtensionsPrivate::icon, KKbdAccessExtensionsPrivate::mainWindow, et KKbdAccessExtensionsPrivate::revAction.

KKbdAccessExtensions::~KKbdAccessExtensions

(

)

[virtual]

Destructor.

Définition à la ligne 192 du fichier kkbdaccessextensions.cpp.

Références d, exitSizing(), et KKbdAccessExtensionsPrivate::panel.

Voici le graphe d'appel pour cette fonction :

---

Documentation des fonctions membres

int KKbdAccessExtensions::stepSize

(

)

const

Returns number of pixels panel is sized for each arrow key pressed. Default is 10.

Définition à la ligne 199 du fichier kkbdaccessextensions.cpp.

Références d, et KKbdAccessExtensionsPrivate::stepSize.

Référencé par resizePanelFromKey().

Voici le graphe d'appel pour cette fonction :

void KKbdAccessExtensions::setStepSize

(

int

s

)

Sets number of pixels panel is sized for each arrow key pressed.

Définition à la ligne 201 du fichier kkbdaccessextensions.cpp.

Références d, et KKbdAccessExtensionsPrivate::stepSize.

bool KKbdAccessExtensions::eventFilter	(	QObject *	o,
		QEvent *	e
	)			[protected]

Event filter installed on kapp object.

Définition à la ligne 203 du fichier kkbdaccessextensions.cpp.

Références KKbdAccessExtensionsPrivate::accessKeyLabels, KKbdAccessExtensionsPrivate::accessKeysAction, d, KPanelKbdSizerIcon::delta(), displayAccessKeys(), exitSizing(), KKbdAccessExtensionsPrivate::fwdAction, handleAccessKey(), KKbdAccessExtensionsPrivate::icon, KPanelKbdSizerIcon::isActive, nextHandle(), KKbdAccessExtensionsPrivate::panel, prevHandle(), resizePanel(), resizePanelFromKey(), KKbdAccessExtensionsPrivate::revAction, et showIcon().

Voici le graphe d'appel pour cette fonction :

QWidgetList * KKbdAccessExtensions::getAllPanels

(

)

[protected]

Retrieves a list of all Splitter and DockArea widgets in the application.

Définition à la ligne 286 du fichier kkbdaccessextensions.cpp.

Référencé par nextHandle(), et prevHandle().

Voici le graphe d'appel pour cette fonction :

void KKbdAccessExtensions::nextHandle

(

)

[protected]

Advances to the next Panel handle. If not currently in resizing mode, turns it on.

Définition à la ligne 307 du fichier kkbdaccessextensions.cpp.

Références d, exitSizing(), getAllPanels(), KKbdAccessExtensionsPrivate::handleNdx, KKbdAccessExtensionsPrivate::panel, et showIcon().

Référencé par eventFilter().

Voici le graphe d'appel pour cette fonction :

Voici le graphe d'appel pour cette fonction :

void KKbdAccessExtensions::prevHandle

(

)

[protected]

Moves to the previous Panel handle. If not currently in resizing mode, turns it on.

Définition à la ligne 342 du fichier kkbdaccessextensions.cpp.

Références d, exitSizing(), getAllPanels(), KKbdAccessExtensionsPrivate::handleNdx, KKbdAccessExtensionsPrivate::panel, et showIcon().

Référencé par eventFilter().

Voici le graphe d'appel pour cette fonction :

Voici le graphe d'appel pour cette fonction :

void KKbdAccessExtensions::exitSizing

(

)

[protected]

Exits Sizing mode.

Définition à la ligne 391 du fichier kkbdaccessextensions.cpp.

Références d, KKbdAccessExtensionsPrivate::handleNdx, hideIcon(), et KKbdAccessExtensionsPrivate::panel.

Référencé par eventFilter(), nextHandle(), prevHandle(), et ~KKbdAccessExtensions().

Voici le graphe d'appel pour cette fonction :

Voici le graphe d'appel pour cette fonction :

void KKbdAccessExtensions::resizePanelFromKey	(	int	key,
		int	state
	)			[protected]

Moves panel handle based on key pressed.

Définition à la ligne 533 du fichier kkbdaccessextensions.cpp.

Références d, KKbdAccessExtensionsPrivate::panel, resizePanel(), showIcon(), KKbdAccessExtensionsPrivate::stepSize, et stepSize().

Référencé par eventFilter().

Voici le graphe d'appel pour cette fonction :

Voici le graphe d'appel pour cette fonction :

void KKbdAccessExtensions::resizePanel	(	int	dx,
		int	dy,
		int	state
	)			[protected]

Moves panel handle based on deltaX and deltaY and state of keyboard modifier keys.

Définition à la ligne 472 du fichier kkbdaccessextensions.cpp.

Références d, KKbdAccessExtensionsPrivate::handleNdx, et KKbdAccessExtensionsPrivate::panel.

Référencé par eventFilter(), et resizePanelFromKey().

Voici le graphe d'appel pour cette fonction :

void KKbdAccessExtensions::showIcon

(

)

[protected]

Displays the sizer icon.

Définition à la ligne 399 du fichier kkbdaccessextensions.cpp.

Références d, KKbdAccessExtensionsPrivate::handleNdx, KKbdAccessExtensionsPrivate::icon, KFormula::Normal, KKbdAccessExtensionsPrivate::panel, KPanelKbdSizerIcon::setShape(), et KPanelKbdSizerIcon::show().

Référencé par eventFilter(), nextHandle(), prevHandle(), et resizePanelFromKey().

Voici le graphe d'appel pour cette fonction :

Voici le graphe d'appel pour cette fonction :

void KKbdAccessExtensions::hideIcon

(

)

[protected]

Hides the sizer icon.

Définition à la ligne 467 du fichier kkbdaccessextensions.cpp.

Références d, KPanelKbdSizerIcon::hide(), et KKbdAccessExtensionsPrivate::icon.

Référencé par exitSizing().

Voici le graphe d'appel pour cette fonction :

Voici le graphe d'appel pour cette fonction :

void KKbdAccessExtensions::displayAccessKeys

(

)

[protected]

Displays the access keys.

Définition à la ligne 564 du fichier kkbdaccessextensions.cpp.

Références KKbdAccessExtensionsPrivate::accessKeyLabels, d, Py::int, et KKbdAccessExtensionsPrivate::mainWindow.

Référencé par eventFilter().

Voici le graphe d'appel pour cette fonction :

bool KKbdAccessExtensions::handleAccessKey

(

const QKeyEvent *

ev

)

[protected]

Handles an access keypress.

Définition à la ligne 638 du fichier kkbdaccessextensions.cpp.

Références KKbdAccessExtensionsPrivate::accessKeyLabels, et d.

Référencé par eventFilter().

Voici le graphe d'appel pour cette fonction :

---

Documentation des données membres

KKbdAccessExtensionsPrivate* KKbdAccessExtensions::d [private]

Définition à la ligne 161 du fichier kkbdaccessextensions.h.

Référencé par displayAccessKeys(), eventFilter(), exitSizing(), handleAccessKey(), hideIcon(), KKbdAccessExtensions(), nextHandle(), prevHandle(), resizePanel(), resizePanelFromKey(), setStepSize(), showIcon(), stepSize(), et ~KKbdAccessExtensions().

---

La documentation de cette classe a été générée à partir des fichiers suivants :

• F:/KPlato/koffice/libs/kofficecore/kkbdaccessextensions.h
• F:/KPlato/koffice/libs/kofficecore/kkbdaccessextensions.cpp

---