2,354
edits
Changes
Jump to navigation
Jump to search
Line 44:
Line 44: − 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.+ − + − + − +
Development Team/Almanac/sugar.graphics.toolbutton (view source)
Revision as of 13:32, 23 April 2009
, 13:32, 23 April 2009change from alt to Ctrl as that is the primary modifier
=== How do I add a keyboard shortcut to my tool button? ===
=== How do I add a keyboard shortcut to my tool 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')