Difference between revisions of "Development Team/Almanac/sugar.graphics.toolbutton"

From Sugar Labs
Jump to navigation Jump to search
Line 4: Line 4:
  
 
=== How do I create my own custom tool button? ===
 
=== How do I create my own custom tool button? ===
 +
There are several steps you need to follow in order to create a tool button:
 +
1. Import the ToolButton class from the sugar.graphics.toolbutton package.
 +
2. If you intend to have an icon for your tool button, then create an "icons" directory in your activity directory and put the icon (which is a .svg file) in to that directory.
 +
3. Use the code below to guide you on how to then create your button programmatically and add it to a tool bar (we add it to an EditToolbar object that was presumably created already in our code).
 +
 +
 +
        from sugar.graphics.toolbutton import ToolButton
 +
        ...
 +
        #Create a custom tool button and add it to the edit toolbar
 +
        customButton = ToolButton('edit-custom')
 +
        customButton.set_tooltip(_('Custom'))
 +
        self._edit_toolbar.insert(customButton, -1)
 +
        customButton.show()
  
 
=== How do I connect my tool button to a callback? ===
 
=== How do I connect my tool button to a callback? ===

Revision as of 14:42, 29 May 2008

Class: ToolButton (gtk.ToolButton)

Sugar tool buttons can be added to toolbars and used to control various activity processes. Some common tool button tasks are outlined below.

How do I create my own custom tool button?

There are several steps you need to follow in order to create a tool button: 1. Import the ToolButton class from the sugar.graphics.toolbutton package. 2. If you intend to have an icon for your tool button, then create an "icons" directory in your activity directory and put the icon (which is a .svg file) in to that directory. 3. Use the code below to guide you on how to then create your button programmatically and add it to a tool bar (we add it to an EditToolbar object that was presumably created already in our code). 


       from sugar.graphics.toolbutton import ToolButton
       ...
       #Create a custom tool button and add it to the edit toolbar
       customButton = ToolButton('edit-custom')
       customButton.set_tooltip(_('Custom'))
       self._edit_toolbar.insert(customButton, -1)
       customButton.show()

How do I connect my tool button to a callback?

Retrieved from "https://wiki.sugarlabs.org/index.php?title=Development_Team/Almanac/sugar.graphics.toolbutton&oldid=18496"