Use the associated document manager, not the global one
[wxWidgets.git] / src / common / gbsizer.cpp
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: gbsizer.cpp
3 // Purpose: wxGridBagSizer: A sizer that can lay out items in a grid,
4 // with items at specified cells, and with the option of row
5 // and/or column spanning
6 //
7 // Author: Robin Dunn
8 // Created: 03-Nov-2003
9 // RCS-ID: $Id$
10 // Copyright: (c) Robin Dunn
11 // Licence: wxWindows licence
12 /////////////////////////////////////////////////////////////////////////////
13
14 // For compilers that support precompilation, includes "wx.h".
15 #include "wx/wxprec.h"
16
17 #ifdef __BORLANDC__
18 #pragma hdrstop
19 #endif
20
21 #include "wx/gbsizer.h"
22
23 //---------------------------------------------------------------------------
24
25 IMPLEMENT_DYNAMIC_CLASS(wxGBSizerItem, wxSizerItem)
26 IMPLEMENT_CLASS(wxGridBagSizer, wxFlexGridSizer)
27
28 const wxGBSpan wxDefaultSpan;
29
30 //---------------------------------------------------------------------------
31 // wxGBSizerItem
32 //---------------------------------------------------------------------------
33
34 wxGBSizerItem::wxGBSizerItem( int width,
35 int height,
36 const wxGBPosition& pos,
37 const wxGBSpan& span,
38 int flag,
39 int border,
40 wxObject* userData)
41 : wxSizerItem(width, height, 0, flag, border, userData),
42 m_pos(pos),
43 m_span(span),
44 m_gbsizer(NULL)
45 {
46 }
47
48
49 wxGBSizerItem::wxGBSizerItem( wxWindow *window,
50 const wxGBPosition& pos,
51 const wxGBSpan& span,
52 int flag,
53 int border,
54 wxObject* userData )
55 : wxSizerItem(window, 0, flag, border, userData),
56 m_pos(pos),
57 m_span(span),
58 m_gbsizer(NULL)
59 {
60 }
61
62
63 wxGBSizerItem::wxGBSizerItem( wxSizer *sizer,
64 const wxGBPosition& pos,
65 const wxGBSpan& span,
66 int flag,
67 int border,
68 wxObject* userData )
69 : wxSizerItem(sizer, 0, flag, border, userData),
70 m_pos(pos),
71 m_span(span),
72 m_gbsizer(NULL)
73 {
74 }
75
76 wxGBSizerItem::wxGBSizerItem()
77 : wxSizerItem(),
78 m_pos(-1,-1),
79 m_span(-1,-1),
80 m_gbsizer(NULL)
81 {
82 }
83
84 //---------------------------------------------------------------------------
85
86
87 void wxGBSizerItem::GetPos(int& row, int& col) const
88 {
89 row = m_pos.GetRow();
90 col = m_pos.GetCol();
91 }
92
93 void wxGBSizerItem::GetSpan(int& rowspan, int& colspan) const
94 {
95 rowspan = m_span.GetRowspan();
96 colspan = m_span.GetColspan();
97 }
98
99
100 bool wxGBSizerItem::SetPos( const wxGBPosition& pos )
101 {
102 if (m_gbsizer)
103 {
104 wxCHECK_MSG( !m_gbsizer->CheckForIntersection(pos, m_span, this), false,
105 wxT("An item is already at that position") );
106 }
107 m_pos = pos;
108 return true;
109 }
110
111 bool wxGBSizerItem::SetSpan( const wxGBSpan& span )
112 {
113 if (m_gbsizer)
114 {
115 wxCHECK_MSG( !m_gbsizer->CheckForIntersection(m_pos, span, this), false,
116 wxT("An item is already at that position") );
117 }
118 m_span = span;
119 return true;
120 }
121
122
123 inline bool InRange(int val, int min, int max)
124 {
125 return (val >= min && val <= max);
126 }
127
128 bool wxGBSizerItem::Intersects(const wxGBSizerItem& other)
129 {
130 return Intersects(other.GetPos(), other.GetSpan());
131 }
132
133 bool wxGBSizerItem::Intersects(const wxGBPosition& pos, const wxGBSpan& span)
134 {
135
136 int row, col, endrow, endcol;
137 int otherrow, othercol, otherendrow, otherendcol;
138
139 GetPos(row, col);
140 GetEndPos(endrow, endcol);
141
142 otherrow = pos.GetRow();
143 othercol = pos.GetCol();
144 otherendrow = otherrow + span.GetRowspan() - 1;
145 otherendcol = othercol + span.GetColspan() - 1;
146
147 // is the other item's start or end in the range of this one?
148 if (( InRange(otherrow, row, endrow) && InRange(othercol, col, endcol) ) ||
149 ( InRange(otherendrow, row, endrow) && InRange(otherendcol, col, endcol) ))
150 return true;
151
152 // is this item's start or end in the range of the other one?
153 if (( InRange(row, otherrow, otherendrow) && InRange(col, othercol, otherendcol) ) ||
154 ( InRange(endrow, otherrow, otherendrow) && InRange(endcol, othercol, otherendcol) ))
155 return true;
156
157 return false;
158 }
159
160
161 void wxGBSizerItem::GetEndPos(int& row, int& col)
162 {
163 row = m_pos.GetRow() + m_span.GetRowspan() - 1;
164 col = m_pos.GetCol() + m_span.GetColspan() - 1;
165 }
166
167
168 //---------------------------------------------------------------------------
169 // wxGridBagSizer
170 //---------------------------------------------------------------------------
171
172 wxGridBagSizer::wxGridBagSizer(int vgap, int hgap )
173 : wxFlexGridSizer(1, vgap, hgap),
174 m_emptyCellSize(10,20)
175
176 {
177 }
178
179
180 wxSizerItem* wxGridBagSizer::Add( wxWindow *window,
181 const wxGBPosition& pos, const wxGBSpan& span,
182 int flag, int border, wxObject* userData )
183 {
184 wxGBSizerItem* item = new wxGBSizerItem(window, pos, span, flag, border, userData);
185 if ( Add(item) )
186 return item;
187 else
188 {
189 delete item;
190 return (wxSizerItem*)NULL;
191 }
192 }
193
194 wxSizerItem* wxGridBagSizer::Add( wxSizer *sizer,
195 const wxGBPosition& pos, const wxGBSpan& span,
196 int flag, int border, wxObject* userData )
197 {
198 wxGBSizerItem* item = new wxGBSizerItem(sizer, pos, span, flag, border, userData);
199 if ( Add(item) )
200 return item;
201 else
202 {
203 delete item;
204 return (wxSizerItem*)NULL;
205 }
206 }
207
208 wxSizerItem* wxGridBagSizer::Add( int width, int height,
209 const wxGBPosition& pos, const wxGBSpan& span,
210 int flag, int border, wxObject* userData )
211 {
212 wxGBSizerItem* item = new wxGBSizerItem(width, height, pos, span, flag, border, userData);
213 if ( Add(item) )
214 return item;
215 else
216 {
217 delete item;
218 return (wxSizerItem*)NULL;
219 }
220 }
221
222 wxSizerItem* wxGridBagSizer::Add( wxGBSizerItem *item )
223 {
224 wxCHECK_MSG( !CheckForIntersection(item), NULL,
225 wxT("An item is already at that position") );
226 m_children.Append(item);
227 item->SetGBSizer(this);
228 if ( item->GetWindow() )
229 item->GetWindow()->SetContainingSizer( this );
230
231 return item;
232 }
233
234
235
236 //---------------------------------------------------------------------------
237
238 wxSize wxGridBagSizer::GetCellSize(int row, int col) const
239 {
240 wxCHECK_MSG( (row < m_rows) && (col < m_cols),
241 wxDefaultSize,
242 wxT("Invalid cell."));
243 return wxSize( m_colWidths[col], m_rowHeights[row] );
244 }
245
246
247 wxGBPosition wxGridBagSizer::GetItemPosition(wxWindow *window)
248 {
249 wxGBPosition badpos(-1,-1);
250 wxGBSizerItem* item = FindItem(window);
251 wxCHECK_MSG(item, badpos, wxT("Failed to find item."));
252 return item->GetPos();
253 }
254
255
256 wxGBPosition wxGridBagSizer::GetItemPosition(wxSizer *sizer)
257 {
258 wxGBPosition badpos(-1,-1);
259 wxGBSizerItem* item = FindItem(sizer);
260 wxCHECK_MSG(item, badpos, wxT("Failed to find item."));
261 return item->GetPos();
262 }
263
264
265 wxGBPosition wxGridBagSizer::GetItemPosition(size_t index)
266 {
267 wxGBPosition badpos(-1,-1);
268 wxSizerItemList::compatibility_iterator node = m_children.Item( index );
269 wxCHECK_MSG( node, badpos, _T("Failed to find item.") );
270 wxGBSizerItem* item = (wxGBSizerItem*)node->GetData();
271 return item->GetPos();
272 }
273
274
275
276 bool wxGridBagSizer::SetItemPosition(wxWindow *window, const wxGBPosition& pos)
277 {
278 wxGBSizerItem* item = FindItem(window);
279 wxCHECK_MSG(item, false, wxT("Failed to find item."));
280 return item->SetPos(pos);
281 }
282
283
284 bool wxGridBagSizer::SetItemPosition(wxSizer *sizer, const wxGBPosition& pos)
285 {
286 wxGBSizerItem* item = FindItem(sizer);
287 wxCHECK_MSG(item, false, wxT("Failed to find item."));
288 return item->SetPos(pos);
289 }
290
291
292 bool wxGridBagSizer::SetItemPosition(size_t index, const wxGBPosition& pos)
293 {
294 wxSizerItemList::compatibility_iterator node = m_children.Item( index );
295 wxCHECK_MSG( node, false, _T("Failed to find item.") );
296 wxGBSizerItem* item = (wxGBSizerItem*)node->GetData();
297 return item->SetPos(pos);
298 }
299
300
301
302 wxGBSpan wxGridBagSizer::GetItemSpan(wxWindow *window)
303 {
304 wxGBSpan badspan(-1,-1);
305 wxGBSizerItem* item = FindItem(window);
306 wxCHECK_MSG( item, badspan, _T("Failed to find item.") );
307 return item->GetSpan();
308 }
309
310
311 wxGBSpan wxGridBagSizer::GetItemSpan(wxSizer *sizer)
312 {
313 wxGBSpan badspan(-1,-1);
314 wxGBSizerItem* item = FindItem(sizer);
315 wxCHECK_MSG( item, badspan, _T("Failed to find item.") );
316 return item->GetSpan();
317 }
318
319
320 wxGBSpan wxGridBagSizer::GetItemSpan(size_t index)
321 {
322 wxGBSpan badspan(-1,-1);
323 wxSizerItemList::compatibility_iterator node = m_children.Item( index );
324 wxCHECK_MSG( node, badspan, _T("Failed to find item.") );
325 wxGBSizerItem* item = (wxGBSizerItem*)node->GetData();
326 return item->GetSpan();
327 }
328
329
330
331 bool wxGridBagSizer::SetItemSpan(wxWindow *window, const wxGBSpan& span)
332 {
333 wxGBSizerItem* item = FindItem(window);
334 wxCHECK_MSG(item, false, wxT("Failed to find item."));
335 return item->SetSpan(span);
336 }
337
338
339 bool wxGridBagSizer::SetItemSpan(wxSizer *sizer, const wxGBSpan& span)
340 {
341 wxGBSizerItem* item = FindItem(sizer);
342 wxCHECK_MSG(item, false, wxT("Failed to find item."));
343 return item->SetSpan(span);
344 }
345
346
347 bool wxGridBagSizer::SetItemSpan(size_t index, const wxGBSpan& span)
348 {
349 wxSizerItemList::compatibility_iterator node = m_children.Item( index );
350 wxCHECK_MSG( node, false, _T("Failed to find item.") );
351 wxGBSizerItem* item = (wxGBSizerItem*)node->GetData();
352 return item->SetSpan(span);
353 }
354
355
356
357
358 wxGBSizerItem* wxGridBagSizer::FindItem(wxWindow* window)
359 {
360 wxSizerItemList::compatibility_iterator node = m_children.GetFirst();
361 while (node)
362 {
363 wxGBSizerItem* item = (wxGBSizerItem*)node->GetData();
364 if ( item->GetWindow() == window )
365 return item;
366 node = node->GetNext();
367 }
368 return NULL;
369 }
370
371
372 wxGBSizerItem* wxGridBagSizer::FindItem(wxSizer* sizer)
373 {
374 wxSizerItemList::compatibility_iterator node = m_children.GetFirst();
375 while (node)
376 {
377 wxGBSizerItem* item = (wxGBSizerItem*)node->GetData();
378 if ( item->GetSizer() == sizer )
379 return item;
380 node = node->GetNext();
381 }
382 return NULL;
383 }
384
385
386
387
388 wxGBSizerItem* wxGridBagSizer::FindItemAtPosition(const wxGBPosition& pos)
389 {
390 wxSizerItemList::compatibility_iterator node = m_children.GetFirst();
391 while (node)
392 {
393 wxGBSizerItem* item = (wxGBSizerItem*)node->GetData();
394 if ( item->Intersects(pos, wxDefaultSpan) )
395 return item;
396 node = node->GetNext();
397 }
398 return NULL;
399 }
400
401
402
403
404 wxGBSizerItem* wxGridBagSizer::FindItemAtPoint(const wxPoint& pt)
405 {
406 wxSizerItemList::compatibility_iterator node = m_children.GetFirst();
407 while (node)
408 {
409 wxGBSizerItem* item = (wxGBSizerItem*)node->GetData();
410 wxRect rect(item->GetPosition(), item->GetSize());
411 rect.Inflate(m_hgap, m_vgap);
412 if ( rect.Contains(pt) )
413 return item;
414 node = node->GetNext();
415 }
416 return NULL;
417 }
418
419
420
421
422 wxGBSizerItem* wxGridBagSizer::FindItemWithData(const wxObject* userData)
423 {
424 wxSizerItemList::compatibility_iterator node = m_children.GetFirst();
425 while (node)
426 {
427 wxGBSizerItem* item = (wxGBSizerItem*)node->GetData();
428 if ( item->GetUserData() == userData )
429 return item;
430 node = node->GetNext();
431 }
432 return NULL;
433 }
434
435
436
437
438 //---------------------------------------------------------------------------
439
440 // Figure out what all the min row heights and col widths are, and calculate
441 // min size from that.
442 wxSize wxGridBagSizer::CalcMin()
443 {
444 int idx;
445
446 if (m_children.GetCount() == 0)
447 return m_emptyCellSize;
448
449 m_rowHeights.Empty();
450 m_colWidths.Empty();
451
452 wxSizerItemList::compatibility_iterator node = m_children.GetFirst();
453 while (node)
454 {
455 wxGBSizerItem* item = (wxGBSizerItem*)node->GetData();
456 if ( item->IsShown() )
457 {
458 int row, col, endrow, endcol;
459
460 item->GetPos(row, col);
461 item->GetEndPos(endrow, endcol);
462
463 // fill heights and widths upto this item if needed
464 while ( m_rowHeights.GetCount() <= (size_t)endrow )
465 m_rowHeights.Add(m_emptyCellSize.GetHeight());
466 while ( m_colWidths.GetCount() <= (size_t)endcol )
467 m_colWidths.Add(m_emptyCellSize.GetWidth());
468
469 // See if this item increases the size of its row(s) or col(s)
470 wxSize size(item->CalcMin());
471 for (idx=row; idx <= endrow; idx++)
472 m_rowHeights[idx] = wxMax(m_rowHeights[idx], size.GetHeight() / (endrow-row+1));
473 for (idx=col; idx <= endcol; idx++)
474 m_colWidths[idx] = wxMax(m_colWidths[idx], size.GetWidth() / (endcol-col+1));
475 }
476 node = node->GetNext();
477 }
478
479 AdjustForFlexDirection();
480
481 // Now traverse the heights and widths arrays calcing the totals, including gaps
482 int width = 0;
483 m_cols = m_colWidths.GetCount();
484 for (idx=0; idx < m_cols; idx++)
485 width += m_colWidths[idx] + ( idx == m_cols-1 ? 0 : m_hgap );
486
487 int height = 0;
488 m_rows = m_rowHeights.GetCount();
489 for (idx=0; idx < m_rows; idx++)
490 height += m_rowHeights[idx] + ( idx == m_rows-1 ? 0 : m_vgap );
491
492 m_calculatedMinSize = wxSize(width, height);
493 return m_calculatedMinSize;
494 }
495
496
497
498 void wxGridBagSizer::RecalcSizes()
499 {
500 if (m_children.GetCount() == 0)
501 return;
502
503 wxPoint pt( GetPosition() );
504 wxSize sz( GetSize() );
505
506 m_rows = m_rowHeights.GetCount();
507 m_cols = m_colWidths.GetCount();
508 int idx, width, height;
509
510 AdjustForGrowables(sz, m_calculatedMinSize, m_rows, m_cols);
511
512 // Find the start positions on the window of the rows and columns
513 wxArrayInt rowpos;
514 rowpos.Add(0, m_rows);
515 int y = pt.y;
516 for (idx=0; idx < m_rows; idx++)
517 {
518 height = m_rowHeights[idx] + m_vgap;
519 rowpos[idx] = y;
520 y += height;
521 }
522
523 wxArrayInt colpos;
524 colpos.Add(0, m_cols);
525 int x = pt.x;
526 for (idx=0; idx < m_cols; idx++)
527 {
528 width = m_colWidths[idx] + m_hgap;
529 colpos[idx] = x;
530 x += width;
531 }
532
533
534 // Now iterate the children, setting each child's dimensions
535 wxSizerItemList::compatibility_iterator node = m_children.GetFirst();
536 while (node)
537 {
538 int row, col, endrow, endcol;
539 wxGBSizerItem* item = (wxGBSizerItem*)node->GetData();
540 item->GetPos(row, col);
541 item->GetEndPos(endrow, endcol);
542
543 height = 0;
544 for(idx=row; idx <= endrow; idx++)
545 height += m_rowHeights[idx];
546 height += (endrow - row) * m_vgap; // add a vgap for every row spanned
547
548 width = 0;
549 for (idx=col; idx <= endcol; idx++)
550 width += m_colWidths[idx];
551 width += (endcol - col) * m_hgap; // add a hgap for every col spanned
552
553 SetItemBounds(item, colpos[col], rowpos[row], width, height);
554
555 node = node->GetNext();
556 }
557 }
558
559
560
561 //---------------------------------------------------------------------------
562
563 bool wxGridBagSizer::CheckForIntersection(wxGBSizerItem* item, wxGBSizerItem* excludeItem)
564 {
565 return CheckForIntersection(item->GetPos(), item->GetSpan(), excludeItem);
566 }
567
568 bool wxGridBagSizer::CheckForIntersection(const wxGBPosition& pos, const wxGBSpan& span, wxGBSizerItem* excludeItem)
569 {
570 wxSizerItemList::compatibility_iterator node = m_children.GetFirst();
571 while (node)
572 {
573 wxGBSizerItem* item = (wxGBSizerItem*)node->GetData();
574 node = node->GetNext();
575
576 if ( excludeItem && item == excludeItem )
577 continue;
578
579 if ( item->Intersects(pos, span) )
580 return true;
581
582 }
583 return false;
584 }
585
586
587 // Assumes a 10x10 grid, and returns the first empty cell found. This is
588 // really stupid but it is only used by the Add methods that match the base
589 // class virtuals, which should normally not be used anyway...
590 wxGBPosition wxGridBagSizer::FindEmptyCell()
591 {
592 int row, col;
593
594 for (row=0; row<10; row++)
595 for (col=0; col<10; col++)
596 {
597 wxGBPosition pos(row, col);
598 if ( !CheckForIntersection(pos, wxDefaultSpan) )
599 return pos;
600 }
601 return wxGBPosition(-1, -1);
602 }
603
604
605 //---------------------------------------------------------------------------
606
607 // The Add base class virtuals should not be used with this class, but
608 // we'll try to make them automatically select a location for the item
609 // anyway.
610
611 wxSizerItem* wxGridBagSizer::Add( wxWindow *window, int, int flag, int border, wxObject* userData )
612 {
613 return Add(window, FindEmptyCell(), wxDefaultSpan, flag, border, userData);
614 }
615
616 wxSizerItem* wxGridBagSizer::Add( wxSizer *sizer, int, int flag, int border, wxObject* userData )
617 {
618 return Add(sizer, FindEmptyCell(), wxDefaultSpan, flag, border, userData);
619 }
620
621 wxSizerItem* wxGridBagSizer::Add( int width, int height, int, int flag, int border, wxObject* userData )
622 {
623 return Add(width, height, FindEmptyCell(), wxDefaultSpan, flag, border, userData);
624 }
625
626
627
628 // The Insert nad Prepend base class virtuals that are not appropriate for
629 // this class and should not be used. Their implementation in this class
630 // simply fails.
631
632 wxSizerItem* wxGridBagSizer::Add( wxSizerItem * )
633 {
634 wxFAIL_MSG(wxT("Invalid Add form called."));
635 return (wxSizerItem*)NULL;
636 }
637
638 wxSizerItem* wxGridBagSizer::Prepend( wxWindow *, int, int, int, wxObject* )
639 {
640 wxFAIL_MSG(wxT("Prepend should not be used with wxGridBagSizer."));
641 return (wxSizerItem*)NULL;
642 }
643
644 wxSizerItem* wxGridBagSizer::Prepend( wxSizer *, int, int, int, wxObject* )
645 {
646 wxFAIL_MSG(wxT("Prepend should not be used with wxGridBagSizer."));
647 return (wxSizerItem*)NULL;
648 }
649
650 wxSizerItem* wxGridBagSizer::Prepend( int, int, int, int, int, wxObject* )
651 {
652 wxFAIL_MSG(wxT("Prepend should not be used with wxGridBagSizer."));
653 return (wxSizerItem*)NULL;
654 }
655
656 wxSizerItem* wxGridBagSizer::Prepend( wxSizerItem * )
657 {
658 wxFAIL_MSG(wxT("Prepend should not be used with wxGridBagSizer."));
659 return (wxSizerItem*)NULL;
660 }
661
662
663 wxSizerItem* wxGridBagSizer::Insert( size_t, wxWindow *, int, int, int, wxObject* )
664 {
665 wxFAIL_MSG(wxT("Insert should not be used with wxGridBagSizer."));
666 return (wxSizerItem*)NULL;
667 }
668
669 wxSizerItem* wxGridBagSizer::Insert( size_t, wxSizer *, int, int, int, wxObject* )
670 {
671 wxFAIL_MSG(wxT("Insert should not be used with wxGridBagSizer."));
672 return (wxSizerItem*)NULL;
673 }
674
675 wxSizerItem* wxGridBagSizer::Insert( size_t, int, int, int, int, int, wxObject* )
676 {
677 wxFAIL_MSG(wxT("Insert should not be used with wxGridBagSizer."));
678 return (wxSizerItem*)NULL;
679 }
680
681 wxSizerItem* wxGridBagSizer::Insert( size_t, wxSizerItem * )
682 {
683 wxFAIL_MSG(wxT("Insert should not be used with wxGridBagSizer."));
684 return (wxSizerItem*)NULL;
685 }
686
687
688 //---------------------------------------------------------------------------
689 //---------------------------------------------------------------------------