Features/TableView Widget

From Sugar Labs
Jump to navigation Jump to search


Summary

GTK widget to replace gtk.TreeView in Journal.

Owner

Current status

  • Targeted release: 0.88
  • Last updated: Sat Nov 28 01:20:59 UTC 2009
  • Percentage of completion: 75%

Detailed Description

Feature introduced two new classes - SmartTable and TableView.

SmartTable class

Model less implementation. The real widget consist of visible-columns * (visible-rows + 2) identical widgets(constructor is beeing passed to SmartTable while creation) and while scrolling(per line, not per row) class shifts these widgets.

TreeTable class

Just adds mgt.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 then renders, we can reuse our existed custom widgets instead of coding sugarized cell renders
  • in some cases its hard to sugarize cells theme(we still have ugly progress bar for Journal entries), with new widget, we use just gtk.ProgressBar

Scope

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.

Comments and Discussion