Features/TableView Widget
Summary
GTK widget to replace gtk.TreeView in Journal.
Owner
- Name: Aleksey Lim
- Email: send an email
Current status
- Targeted release: 0.88
- Last updated: Sat Nov 28 21:15:02 UTC 2009
- Percentage of completion: 90%
Detailed Description
Feature introduced two new classes - SmoothTable and TableView.
SmoothTable class
Model less implementation. The real widget consists of visible-columns * (visible-rows + 2) identical widgets (constructor is passed to SmoothTable during creation) and while scrolling (by pixel); SmoothTable shifts these widgets.
TableView class
Just adds gtk.TreeModel support.
Benefit to Sugar
Standard gtk components are not designed to be lazy. Third party widgets, I managed to find, uses scheme with renders (like gtk components), introduced component uses widgets instead (could have performance penalties, I guess, in common case but we don't have many rows in Journal view, so should be ok for us).
Benefits we have for such scheme:
- coding cells is more useful by using widgets than renders, we can reuse our existing custom widgets instead of coding sugarized cell renders
- in some cases it's hard to sugarize cells theme (we still have ugly progress bar for Journal entries), with new widget, we use just gtk.ProgressBar
Scope
- new widget for sugar-toolkit
UI Design
Nothing.
How To Test
Simple example for SmootTable widget
import gtk
from sugar.graphics.smoothtable import SmoothTable
window = gtk.Window()
scrolled = gtk.ScrolledWindow()
scrolled.set_policy(gtk.POLICY_ALWAYS, gtk.POLICY_ALWAYS)
window.add(scrolled)
class Cell(gtk.Button):
def do_fill_in(self, table, row, column):
self.props.label = '%s:%s' % (row, column)
table = SmoothTable(Cell, 3, 3)
table.row_count = 100
scrolled.add(table)
window.show_all()
gtk.main()
User Experience
Nothing will be changed in case of user experience.
Dependencies
- regular glucose dependencies
Contingency Plan
None necessary, revert to previous release behaviour.
Documentation
Is there upstream documentation on this feature, or notes you have written yourself? Has this topic been discussed in the mailing list or during a meeting? Link to that material here so other interested developers can get involved.
Release Notes
The Sugar Release Notes inform end-users about what is new in the release. An Example is 0.84/Notes. The release notes also help users know how to deal with platform changes such as ABIs/APIs, configuration or data file formats, or upgrade concerns. If there are any such changes involved in this feature, indicate them here. You can also link to upstream documentation if it satisfies this need. This information forms the basis of the release notes edited by the release team and shipped with the release.