10,505
edits
Changes
Jump to navigation
Jump to search
Line 1:
Line 1: − + Line 32:
Line 32: − + − Line 43:
Line 42: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Development Team/Almanac/sugar.graphics.toolbutton (view source)
Revision as of 12:17, 9 April 2011
, 12:17, 9 April 2011→How do I set the default toolbar menu?
{{Sugar Almanac}}
{{Almanac}}
= Class: ToolButton ([http://www.pygtk.org/docs/pygtk/ gtk.ToolButton]) =
= Class: ToolButton ([http://www.pygtk.org/docs/pygtk/ gtk.ToolButton]) =
=== What is a tooltip and how do I set it for my tool button? ===
=== What is a tooltip and how do I set it for my tool button? ===
A tooltip is a brief textual description of a tool button that pops up when the mouse cursor is on the toolbutton and the user right-clicks. It is meant to be descriptive so that a user understands what a toolbutton does if it isn't immediately obvious from the icon.
A tooltip is a brief textual description of a tool button that pops up when the mouse cursor is on the toolbutton and the user right-clicks. It is meant to be descriptive so that a user understands what a toolbutton does if it isn't immediately obvious from the icon. (Note that in the example below, the gettext syntax is used so that the tooltip will be included in the POT file for the project and thus it can be localized.)
#Set the tooltip for the customButton to "Custom"
#Set the tooltip for the customButton to "Custom"
customButton.set_tooltip(_('Custom'))
customButton.set_tooltip(_('Custom'))
=== How do I reset the icon displayed for my tool button? ===
=== How do I reset the icon displayed for my tool button? ===
#Reset the icon displayed for customButton
#Reset the icon displayed for customButton
customButton.set_icon("edit-custom");
customButton.set_icon("edit-custom");
=== 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. (Activity authors are encouraged to use <ctrl> for most shortcuts.)
#Add keyboard shortcut for customButton
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):
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>:
customButton.props.accelerator = _('<ctrl>plus')
=== How do I set the default toolbar menu? ===
Use the set_expanded() method of the ToolbarButton class.
my_toolbar_button.set_expanded(True)
When using pre-0.86 toolbars, use the set_current_toolbar() method:
self.toolbox.set_current_toolbar(1)
=== How do I set the icon search path for my toolbar button? ===
By default, the Sugar system icon folders and the icons subdirectory of your activity are searched. You can add additional directories to search as follows:
icon_theme = gtk.icon_theme_get_default()
icon_theme.append_search_path(your_icon_path)