The PropertyList is a utility class that
can be used to hold a list of properties. It’s derived from an Array,
so it can hold the properties in a well defined order. The order can be
determined by an arbitrary number of sorting levels. A sorting level
specifies an attribute who’s value should be used for sorting, a
scenario index if necessary and the sorting direction (up/down). All nodes
in the PropertyList must belong to the same
PropertySet.
addSortingCriteria(criteria, up, scIdx)
click to toggle source
Append a new sorting level to the existing levels.
98: def addSortingCriteria(criteria, up, scIdx)
99: unless @propertySet.knownAttribute?(criteria) ||
100: @propertySet.hasQuery?(criteria, scIdx)
101: raise TjException.new, "Unknown attribute #{criteria} used for " +
102: 'sorting criterium'
103: end
104: if scIdx == 1
105: if @propertySet.scenarioSpecific?(criteria)
106: raise TjException.new, "Attribute #{criteria} is scenario specific." +
107: "You must specify a scenario id."
108: end
109: else
110: if @propertySet.project.scenario(scIdx).nil?
111: raise TjException.new, "Unknown scenario index #{scIdx} used."
112: end
113: if !@propertySet.scenarioSpecific?(criteria)
114: raise TjException.new, "Attribute #{criteria} is not scenario specific"
115: end
116: end
117: @sortingCriteria.push(criteria)
118: @sortingUp.push(up)
119: @scenarioIdx.push(scIdx)
120: @sortingLevels += 1
121: end
append(list)
click to toggle source
Append another Array of PropertyTreeNodes or a PropertyList to this. The list will be sorted
again.
84: def append(list)
85: if $DEBUG
86: list.each do |node|
87: unless node.propertySet == @propertySet
88: raise "Fatal Error: All nodes must belong to the same PropertySet."
89: end
90: end
91: end
92:
93: @items.concat(list)
94: sort!
95: end
index()
click to toggle source
This function sets the index attribute of all the properties in the list.
The index starts with 0 and increases for each property.
172: def index
173: i = 0
174: @items.each do |p|
175: p.set('index', i += 1)
176: end
177: end
itemIndex(item)
click to toggle source
Return the Array index of item or nil.
166: def itemIndex(item)
167: @items.index(item)
168: end
method_missing(func, *args, &block)
click to toggle source
This class should be a derived class of Array. But since it re-defines
sort!() and still needs to call Array::sort!() I took a different route.
All missing methods will be propagated to the @items Array.
58: def method_missing(func, *args, &block)
59: @items.method(func).call(*args, &block)
60: end
resetSorting()
click to toggle source
Clear all sorting levels.
75: def resetSorting
76: @sortingLevels = 0
77: @sortingCriteria = []
78: @sortingUp = []
79: @scenarioIdx = []
80: end
setSorting(modes)
click to toggle source
Set all sorting levels as Array of triplets.
67: def setSorting(modes)
68: resetSorting
69: modes.each do |mode|
70: addSortingCriteria(*mode)
71: end
72: end
sort!()
click to toggle source
Sort the properties according to the currently defined sorting criteria.
131: def sort!
132: if treeMode?
133:
134:
135:
136:
137:
138: sc = @sortingCriteria.delete_at(0)
139: su = @sortingUp.delete_at(0)
140: si = @scenarioIdx.delete_at(0)
141: @sortingLevels -= 1
142:
143:
144: sortInternal
145:
146: index
147:
148: indexTree
149:
150:
151: @sortingCriteria.insert(0, sc)
152: @sortingUp.insert(0, su)
153: @scenarioIdx.insert(0, si)
154: @sortingLevels += 1
155:
156:
157: sortInternal
158: else
159: sortInternal
160: end
161:
162: index
163: end
to_ary()
click to toggle source
62: def to_ary
63: @items.dup
64: end
treeMode?()
click to toggle source
If the first sorting level is ‘tree’ the breakdown structure of
the list is preserved. This is a somewhat special mode and this function
returns true if the mode is set.
126: def treeMode?
127: @sortingLevels > 0 && @sortingCriteria[0] == 'tree'
128: end
![[+]](../images/find.png "show/hide quicksearch")