-
Notifications
You must be signed in to change notification settings - Fork 4
/
table.py
106 lines (89 loc) · 3.51 KB
/
table.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
# ============================================================================
#
# Copyright (C) 2007-2012 Conceptive Engineering bvba. All rights reserved.
# www.conceptive.be / project-camelot@conceptive.be
#
# This file is part of the Camelot Library.
#
# This file may be used under the terms of the GNU General Public
# License version 2.0 as published by the Free Software Foundation
# and appearing in the file license.txt included in the packaging of
# this file. Please review this information to ensure GNU
# General Public Licensing requirements will be met.
#
# If you are unsure which license is appropriate for your use, please
# visit www.python-camelot.com or contact project-camelot@conceptive.be
#
# This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
# WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
#
# For use of this library in commercial applications, please contact
# project-camelot@conceptive.be
#
# ============================================================================
"""
A :class:`Table` and a :class:`ColumnGroup` class to define table views that
are more complex.
"""
class ColumnGroup( object ):
"""
A group of columns to be displayed in a table view. By building a Table
with multiple column groups, lots of data can be displayed in a limited
space.
:param verbose_name: the text to be displayed in the tab widget of the
column group
:param columns: a list of fields to display within this column group
:param icon: a :class:`camelot.view.art.Icon` object
.. literalinclude:: ../../test/test_view.py
:start-after: begin column group
:end-before: end column group
.. image:: /_static/controls/column_group.png
"""
def __init__( self,
verbose_name,
columns,
icon = None ):
self.verbose_name = verbose_name
self.icon = icon
self.columns = columns
def get_fields( self ):
"""
:return: an ordered list of field names displayed in the column group
"""
return self.columns
class Table( object ):
"""
Represents the columns that should be displayed in a table view.
:param columns: a list of strings with the fields to be displayed, or a
list of :class:`ColumnGroup` objects
"""
def __init__( self,
columns ):
self.columns = columns
def get_fields( self ):
"""
:return: a ordered list of field names displayed in the table
"""
fields = []
for column in self.columns:
if isinstance( column, basestring ):
fields.append( column )
else:
fields.extend( column.get_fields() )
return fields
def render( self, item_view, parent = None ):
"""
Create a tab widget that allows the user to switch between column
groups.
:param item_view: a :class:`QtGui.QAbstractItemView` object.
:param parent: a :class:`QtGui.QWidget` object
"""
pass
def structure_to_table( structure ):
"""Convert a python data structure to a table, using the following rules :
* if structure is an instance of Table, return structure
* if structure is a list, create a Table from this list
"""
if isinstance( structure, Table ):
return structure
return Table( structure )