Changes

=== How do I add a keyboard shortcut to my tool button? ===

=== How do I add a keyboard shortcut to my tool button? ===

We typically use Alt characters for shortcuts within an activity, reserving Ctrl for system shortcuts. In the example below, we add the Alt-b short cut to our custom button.

In the example below, we add the Ctrl-b short cut to our custom button.

         #Add keyboard shortcut for customButton

         #Add keyboard shortcut for customButton

         customButton.props.accelerator = '<Alt>b'

         customButton.props.accelerator = '<ctrl>b'

If you want to enable translators to override the shortcut, use the gettext syntax so that an entry in the POT file is generated (See [[Development_Team/Almanac/Internationalization]] for details):

If you want to enable translators to override the shortcut, use the gettext syntax so that an entry in the POT file is generated (See [[Development_Team/Almanac/Internationalization]] for details):

         customButton.props.accelerator = _('<Alt>b')

         customButton.props.accelerator = _('<ctrl>b')

If you want to use symbols in you shortcuts, you'll need to refer to the X11 keysymdefs (/usr/include/X11/keysymdef.h), e.g., to use a "+" as a shortcut, you'd refer to <code>#define XK_plus 0x002b /* U+002B PLUS SIGN */</code> and use the string after the <code>XK_</code>:

If you want to use symbols in you shortcuts, you'll need to refer to the X11 keysymdefs (/usr/include/X11/keysymdef.h), e.g., to use a "+" as a shortcut, you'd refer to <code>#define XK_plus 0x002b /* U+002B PLUS SIGN */</code> and use the string after the <code>XK_</code>:

         customButton.props.accelerator = _('<Alt>plus')

         customButton.props.accelerator = _('<ctrl>plus')