• R/O
  • SSH

tkpane: Commit

Default repository for tkpane.py.


Commit MetaInfo

Revisão93ead7b12f03548d3cf88863ddd34e3efa1c2419 (tree)
Hora2018-07-21 11:15:14
AutorDreas Nielsen <dreas.nielsen@gmai...>
CommiterDreas Nielsen

Mensagem de Log

Merged heads.

Mudança Sumário

Diff

diff -r c8211341ec1a -r 93ead7b12f03 doc/source/index.rst
--- a/doc/source/index.rst Fri Jul 20 19:14:45 2018 -0700
+++ b/doc/source/index.rst Fri Jul 20 19:15:14 2018 -0700
@@ -8,17 +8,20 @@
88
99 TkPane is a Python package designed to simplify the construction of a
1010 Tkinter user interface by encapsulating one or more widgets into 'pane'
11-objects that have no direct dependence on any other UI elements. Panes
12-interact with other application elements only through a standardized
13-interface of methods and callback functions. The ``tkpane`` package
14-allows custom panes to be created that can be easily re-used in
15-multiple applications. When multiple panes are assembled for use in a
16-single UI, and some panes require data from other panes, each such
17-dependency can be established with a simple method call. Panes that
18-manage data (e.g., user entries) can automatically pass that data to
19-other panes. Other application code can also easily obtain a pane's
11+objects. Pane objects are independent in that each pane has no inherent
12+dependence on any other pane, but dependencies and data sharing between
13+panes can be established with as little as a single method call. Panes
14+interact with one another through a standardized interface of methods
15+and callback functions. Each pane maintains a dictionary of its own
16+data, and panes can send data to, or request data from, other panes.
17+Other application code can also easily obtain a pane's
2018 data in the form of a Python dictionary.
2119
20+The ``tkpane.lib`` package includes a number of pre-defined general-purpose
21+panes that may be useful in many user interfaces. The TkPane class
22+in the ``tkapne`` package is the foundation for custom panes that can
23+be created and tailored to the specific needs of a particular application.
24+
2225 The following figure illustrates a user interface containing four
2326 separate panes. Borders have been added to the panes so that they are
2427 easily distinguished for the purpose of this illustration. Both input
diff -r c8211341ec1a -r 93ead7b12f03 tkpane/tkpane.py
--- a/tkpane/tkpane.py Fri Jul 20 19:14:45 2018 -0700
+++ b/tkpane/tkpane.py Fri Jul 20 19:15:14 2018 -0700
@@ -82,28 +82,32 @@
8282
8383
8484 class PaneDataHandler(CbHandler):
85- """Define a callback function that will receive a dictionary of a pane's own data values."""
85+ """Define a callback function that takes a single argument consisting of
86+ a dictionary of a pane's own data values."""
8687
8788 def call(self, tkpane_obj):
8889 self.function(tkpane_obj.values())
8990
9091
9192 class PaneKeyHandler(CbHandler):
92- """Define a callback function that will receive a list of a pane's own data keys."""
93+ """Define a callback function that takes a single argument consisting of
94+ a list of a pane's own data keys."""
9395
9496 def call(self, tkpane_obj):
9597 self.function(tkpane_obj.datakeylist)
9698
9799
98100 class AllDataHandler(CbHandler):
99- """Define a callback function that will receive a dictionary of all of a pane's data values."""
101+ """Define a callback function that takes a single argument consisting of
102+ a dictionary of all of a pane's data values."""
100103
101104 def call(self, tkpane_obj):
102105 self.function(tkpane_obj.datadict)
103106
104107
105108 class PaneAllDataHandler(CbHandler):
106- """Define a callback function that will receive the calling pane object and a dictionary of all of that pane's data values."""
109+ """Define a callback function that takes a single argument consisting of
110+ the calling pane object and a dictionary of all of that pane's data values."""
107111
108112 def call(self, tkpane_obj):
109113 self.function(tkpane_obj, tkpane_obj.datadict)
Show on old repository browser