Softwareentwicklung in C++ - ASC

10.2 Das DDD 287
93 ∗ handler i s then s e t when the gameboard i t s e l f i s r e g i s t e r e d
94 ∗ with the ” master ” output handler .
95 ∗ The number of rows and the number o f columns are checked in
96 ∗ a way that they both have to be non−zero and that the number
97 ∗ o f f i e l d s o v e r a l l i s even ( there i s always an even number o f
98 ∗ cards ! ) . I f something i s wrong the values have to be c o r r e c t e d
99 ∗ accordingly ( j u s t because exceptions are not known yet ) .
100 ∗ @param num rows The number of rows f o r the f i e l d
101 ∗ @param num cols The number of columns f o r the f i e l d
102 ∗/
103 MemoryGameboard( uint32 num rows , uint32 num cols ) ;
104
105 /∗ Destructor
106 ∗ Has to d e l e t e a l l v e c t o r s and the output handler f o r the
107 ∗ container .
108 ∗/
109 virtual ˜MemoryGameboard ( ) ;
110
111 /∗ Because the gameboard does not produce any s p e c i a l i z e d
112 ∗ output i t s e l f ( a l l text f i e l d s are r e g i s t e r e d as text
113 ∗ d i s p l a y a b l e s ) i t only t r i g g e r s output o f the contained
114 ∗ d i s p l a y a b l e elements .
115 ∗ @param context The output context to write to
116 ∗/
117 virtual void writeDisplayRep ( OutputContext &context )
118 {
119 i f ( container output handling )
120 container output handling −>writeOutput ( ) ;
121 }
122
123 /∗ When t h i s method i s c a l l e d a l l necessary text d i s p l a y a b l e s
124 ∗ have to be generated and stored in the row and column heading
125 ∗ v e c t o r s . Additionally the container output handler has to
126 ∗ be i n s t a n t i a t e d and these generated d i s p l a y a b l e s have to
127 ∗ be r e g i s t e r e d there together with a l l the cards .
128 ∗ ATTENTION: This behaviour means that a l l cards already
129 ∗ have to be on the gameboard before r e g i s t e r i n g i t with the
130 ∗ d i s p l a y handler ! ! ! ! Otherwise t h i s method ’ s tasks are not
131 ∗ f u l f i l l a b l e c o r r e c t l y ! ! !
132 ∗ ATTENTION: I f t h i s board i s r e g i s t e r e d with more than one
133 ∗ d i s p l a y handler the i n i t i a l i z i n g s t e p s must not be done
134 ∗ again , because everything i s already setup c o r r e c t l y .
135 ∗ Therefore t h i s method has to check t h i s b e f o r e .
136 ∗ @param handler The handler f o r which t h i s d i s p l a y a b l e was
137 ∗ r e g i s t e r e d .
138 ∗/
139 virtual void d i s p l a y a b l e R e g i s t e r e d (
140 SimpleOutputHandling &handler ) ;
141
142 /∗ Turns a l l the cards so that they show the f r o n t s i d e . This
143 ∗ method does not t r i g g e r any output , so f o r the r e s u l t o f
144 ∗ the operation to be shown the output has to be t r i g g e r e d
145 ∗ e x p l i c i t l y by an according c a l l to the d i s p l a y handler .
146 ∗ This method a l s o updates the i n t e r n a l cache f o r the number
147 ∗ o f cards that show t h e i r f r o n t s i d e at the moment ( t h i s
148 ∗ i s the v a r i a b l e num cards front side up ) .
149 ∗/
150 virtual void putAllCardsFrontSideUp ( ) ;
151
152 /∗ Turns a l l the cards so that they show the back s i d e . This
153 ∗ method does not t r i g g e r any output , so f o r the r e s u l t o f
154 ∗ the operation to be shown the output has to be t r i g g e r e d
155 ∗ e x p l i c i t l y by an according c a l l to the d i s p l a y handler .
156 ∗ This method a l s o updates the i n t e r n a l cache f o r the number
157 ∗ o f cards that show t h e i r f r o n t s i d e at the moment ( t h i s
158 ∗ i s the v a r i a b l e num cards front side up ) .