Web   ·   Wiki   ·   Activities   ·   Blog   ·   Lists   ·   Chat   ·   Meeting   ·   Bugs   ·   Git   ·   Translate   ·   Archive   ·   People   ·   Donate
summaryrefslogtreecommitdiffstats
path: root/sugar/graphics
diff options
context:
space:
mode:
authorEduardo Silva <edsiper@monotop.(none)>2007-05-09 02:38:56 (GMT)
committer Eduardo Silva <edsiper@monotop.(none)>2007-05-09 02:38:56 (GMT)
commitc34a26416867ac886f095e3b002504fd70404ba4 (patch)
treec6b4bdca2f7ec620cdbf4de037139f67834ed704 /sugar/graphics
parenta67d87c2a67238796debec0143322d325f4a1631 (diff)
Add some comments in the notebook class
Diffstat (limited to 'sugar/graphics')
-rw-r--r--sugar/graphics/notebook.py22
1 files changed, 17 insertions, 5 deletions
diff --git a/sugar/graphics/notebook.py b/sugar/graphics/notebook.py
index 3c21231..062b6f1 100644
--- a/sugar/graphics/notebook.py
+++ b/sugar/graphics/notebook.py
@@ -1,3 +1,9 @@
+"""Notebook class
+
+This class create a gtk.Notebook() widget supporting
+a close button in every tab when the 'can-close-tabs' gproperty
+is enabled (True)
+"""
#!/usr/bin/env python
# Copyright (C) 2007, Eduardo Silva (edsiper@gmail.com)
@@ -28,6 +34,12 @@ class Notebook(gtk.Notebook):
}
def __init__(self):
+ """Initialise the Widget
+
+ Side effects:
+ Set False the 'can-close-tabs' property
+ Set True the scrollable notebook property
+ """
gtk.Notebook.__init__(self)
self._can_close_tabs = False
@@ -61,7 +73,7 @@ class Notebook(gtk.Notebook):
tab_label = gtk.Label(text)
tab_button = gtk.Button()
- tab_button.connect('clicked', self.close_page, child)
+ tab_button.connect('clicked', self._close_page, child)
# Add a picture on a button
self._add_icon_to_button(tab_button)
@@ -79,8 +91,8 @@ class Notebook(gtk.Notebook):
return event_box
- # Add a new page to the notebook
def add_page(self, text_label, widget):
+ """ Add a new page to the notebook """
if self._can_close_tabs:
eventbox = self._create_custom_tab(text_label, widget)
self.append_page(widget, eventbox)
@@ -89,14 +101,14 @@ class Notebook(gtk.Notebook):
pages = self.get_n_pages()
- # Set the new page
+ """ Set the new page """
self.set_current_page(pages - 1)
self.show_all()
return True
- # Remove a page from the notebook
- def close_page(self, button, child):
+ def _close_page(self, button, child):
+ """ Remove a page from the notebook """
page = self.page_num(child)
if page != -1: