Make keyboard navigation in generic wxTreeCtrl more Mac-like under OS X.
[wxWidgets.git] / src / generic / treectlg.cpp
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/generic/treectlg.cpp
3 // Purpose: generic tree control implementation
4 // Author: Robert Roebling
5 // Created: 01/02/97
6 // Modified: 22/10/98 - almost total rewrite, simpler interface (VZ)
7 // Id: $Id$
8 // Copyright: (c) 1998 Robert Roebling and Julian Smart
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
11
12 // =============================================================================
13 // declarations
14 // =============================================================================
15
16 // -----------------------------------------------------------------------------
17 // headers
18 // -----------------------------------------------------------------------------
19
20 // For compilers that support precompilation, includes "wx.h".
21 #include "wx/wxprec.h"
22
23 #ifdef __BORLANDC__
24 #pragma hdrstop
25 #endif
26
27 #if wxUSE_TREECTRL
28
29 #include "wx/treectrl.h"
30
31 #ifndef WX_PRECOMP
32 #include "wx/dcclient.h"
33 #include "wx/timer.h"
34 #include "wx/settings.h"
35 #include "wx/listbox.h"
36 #include "wx/textctrl.h"
37 #endif
38
39 #include "wx/generic/treectlg.h"
40 #include "wx/imaglist.h"
41
42 #include "wx/renderer.h"
43
44 #ifdef __WXMAC__
45 #include "wx/osx/private.h"
46 #endif
47
48 // -----------------------------------------------------------------------------
49 // array types
50 // -----------------------------------------------------------------------------
51
52 class WXDLLIMPEXP_FWD_CORE wxGenericTreeItem;
53
54 WX_DEFINE_ARRAY_PTR(wxGenericTreeItem *, wxArrayGenericTreeItems);
55
56 // ----------------------------------------------------------------------------
57 // constants
58 // ----------------------------------------------------------------------------
59
60 static const int NO_IMAGE = -1;
61
62 static const int PIXELS_PER_UNIT = 10;
63
64 // the margin between the item state image and the item normal image
65 static const int MARGIN_BETWEEN_STATE_AND_IMAGE = 2;
66
67 // the margin between the item image and the item text
68 static const int MARGIN_BETWEEN_IMAGE_AND_TEXT = 4;
69
70 // -----------------------------------------------------------------------------
71 // private classes
72 // -----------------------------------------------------------------------------
73
74 // timer used for enabling in-place edit
75 class WXDLLEXPORT wxTreeRenameTimer: public wxTimer
76 {
77 public:
78 // start editing the current item after half a second (if the mouse hasn't
79 // been clicked/moved)
80 enum { DELAY = 500 };
81
82 wxTreeRenameTimer( wxGenericTreeCtrl *owner );
83
84 virtual void Notify();
85
86 private:
87 wxGenericTreeCtrl *m_owner;
88
89 wxDECLARE_NO_COPY_CLASS(wxTreeRenameTimer);
90 };
91
92 // control used for in-place edit
93 class WXDLLEXPORT wxTreeTextCtrl: public wxTextCtrl
94 {
95 public:
96 wxTreeTextCtrl(wxGenericTreeCtrl *owner, wxGenericTreeItem *item);
97
98 void EndEdit( bool discardChanges );
99
100 const wxGenericTreeItem* item() const { return m_itemEdited; }
101
102 protected:
103 void OnChar( wxKeyEvent &event );
104 void OnKeyUp( wxKeyEvent &event );
105 void OnKillFocus( wxFocusEvent &event );
106
107 bool AcceptChanges();
108 void Finish( bool setfocus );
109
110 private:
111 wxGenericTreeCtrl *m_owner;
112 wxGenericTreeItem *m_itemEdited;
113 wxString m_startValue;
114 bool m_aboutToFinish;
115
116 DECLARE_EVENT_TABLE()
117 wxDECLARE_NO_COPY_CLASS(wxTreeTextCtrl);
118 };
119
120 // timer used to clear wxGenericTreeCtrl::m_findPrefix if no key was pressed
121 // for a sufficiently long time
122 class WXDLLEXPORT wxTreeFindTimer : public wxTimer
123 {
124 public:
125 // reset the current prefix after half a second of inactivity
126 enum { DELAY = 500 };
127
128 wxTreeFindTimer( wxGenericTreeCtrl *owner ) { m_owner = owner; }
129
130 virtual void Notify() { m_owner->m_findPrefix.clear(); }
131
132 private:
133 wxGenericTreeCtrl *m_owner;
134
135 wxDECLARE_NO_COPY_CLASS(wxTreeFindTimer);
136 };
137
138 // a tree item
139 class WXDLLEXPORT wxGenericTreeItem
140 {
141 public:
142 // ctors & dtor
143 wxGenericTreeItem()
144 {
145 m_data = NULL;
146 m_widthText =
147 m_heightText = -1;
148 }
149
150 wxGenericTreeItem( wxGenericTreeItem *parent,
151 const wxString& text,
152 int image,
153 int selImage,
154 wxTreeItemData *data );
155
156 ~wxGenericTreeItem();
157
158 // trivial accessors
159 wxArrayGenericTreeItems& GetChildren() { return m_children; }
160
161 const wxString& GetText() const { return m_text; }
162 int GetImage(wxTreeItemIcon which = wxTreeItemIcon_Normal) const
163 { return m_images[which]; }
164 wxTreeItemData *GetData() const { return m_data; }
165 int GetState() const { return m_state; }
166
167 // returns the current image for the item (depending on its
168 // selected/expanded/whatever state)
169 int GetCurrentImage() const;
170
171 void SetText(const wxString& text)
172 {
173 m_text = text;
174
175 ResetTextSize();
176 }
177
178 void SetImage(int image, wxTreeItemIcon which)
179 {
180 m_images[which] = image;
181 m_width = 0;
182 }
183
184 void SetData(wxTreeItemData *data) { m_data = data; }
185 void SetState(int state) { m_state = state; m_width = 0; }
186
187 void SetHasPlus(bool has = true) { m_hasPlus = has; }
188
189 void SetBold(bool bold)
190 {
191 m_isBold = bold;
192
193 ResetTextSize();
194 }
195
196 int GetX() const { return m_x; }
197 int GetY() const { return m_y; }
198
199 void SetX(int x) { m_x = x; }
200 void SetY(int y) { m_y = y; }
201
202 int GetHeight() const { return m_height; }
203 int GetWidth() const { return m_width; }
204
205 int GetTextHeight() const
206 {
207 wxASSERT_MSG( m_heightText != -1, "must call CalculateSize() first" );
208
209 return m_heightText;
210 }
211
212 int GetTextWidth() const
213 {
214 wxASSERT_MSG( m_widthText != -1, "must call CalculateSize() first" );
215
216 return m_widthText;
217 }
218
219 wxGenericTreeItem *GetParent() const { return m_parent; }
220
221 // sets the items font for the specified DC if it uses any special font or
222 // simply returns false otherwise
223 bool SetFont(wxGenericTreeCtrl *control, wxDC& dc) const
224 {
225 wxFont font;
226
227 wxTreeItemAttr * const attr = GetAttributes();
228 if ( attr && attr->HasFont() )
229 font = attr->GetFont();
230 else if ( IsBold() )
231 font = control->m_boldFont;
232 else
233 return false;
234
235 dc.SetFont(font);
236 return true;
237 }
238
239 // operations
240
241 // deletes all children notifying the treectrl about it
242 void DeleteChildren(wxGenericTreeCtrl *tree);
243
244 // get count of all children (and grand children if 'recursively')
245 size_t GetChildrenCount(bool recursively = true) const;
246
247 void Insert(wxGenericTreeItem *child, size_t index)
248 { m_children.Insert(child, index); }
249
250 // calculate and cache the item size using either the provided DC (which is
251 // supposed to have wxGenericTreeCtrl::m_normalFont selected into it!) or a
252 // wxClientDC on the control window
253 void CalculateSize(wxGenericTreeCtrl *control, wxDC& dc)
254 { DoCalculateSize(control, dc, true /* dc uses normal font */); }
255 void CalculateSize(wxGenericTreeCtrl *control);
256
257 void GetSize( int &x, int &y, const wxGenericTreeCtrl* );
258
259 void ResetSize() { m_width = 0; }
260 void ResetTextSize() { m_width = 0; m_widthText = -1; }
261 void RecursiveResetSize();
262 void RecursiveResetTextSize();
263
264 // return the item at given position (or NULL if no item), onButton is
265 // true if the point belongs to the item's button, otherwise it lies
266 // on the item's label
267 wxGenericTreeItem *HitTest( const wxPoint& point,
268 const wxGenericTreeCtrl *,
269 int &flags,
270 int level );
271
272 void Expand() { m_isCollapsed = false; }
273 void Collapse() { m_isCollapsed = true; }
274
275 void SetHilight( bool set = true ) { m_hasHilight = set; }
276
277 // status inquiries
278 bool HasChildren() const { return !m_children.IsEmpty(); }
279 bool IsSelected() const { return m_hasHilight != 0; }
280 bool IsExpanded() const { return !m_isCollapsed; }
281 bool HasPlus() const { return m_hasPlus || HasChildren(); }
282 bool IsBold() const { return m_isBold != 0; }
283
284 // attributes
285 // get them - may be NULL
286 wxTreeItemAttr *GetAttributes() const { return m_attr; }
287 // get them ensuring that the pointer is not NULL
288 wxTreeItemAttr& Attr()
289 {
290 if ( !m_attr )
291 {
292 m_attr = new wxTreeItemAttr;
293 m_ownsAttr = true;
294 }
295 return *m_attr;
296 }
297 // set them
298 void SetAttributes(wxTreeItemAttr *attr)
299 {
300 if ( m_ownsAttr ) delete m_attr;
301 m_attr = attr;
302 m_ownsAttr = false;
303 m_width = 0;
304 m_widthText = -1;
305 }
306 // set them and delete when done
307 void AssignAttributes(wxTreeItemAttr *attr)
308 {
309 SetAttributes(attr);
310 m_ownsAttr = true;
311 m_width = 0;
312 m_widthText = -1;
313 }
314
315 private:
316 // calculate the size of this item, i.e. set m_width, m_height and
317 // m_widthText and m_heightText properly
318 //
319 // if dcUsesNormalFont is true, the current dc font must be the normal tree
320 // control font
321 void DoCalculateSize(wxGenericTreeCtrl *control,
322 wxDC& dc,
323 bool dcUsesNormalFont);
324
325 // since there can be very many of these, we save size by chosing
326 // the smallest representation for the elements and by ordering
327 // the members to avoid padding.
328 wxString m_text; // label to be rendered for item
329 int m_widthText;
330 int m_heightText;
331
332 wxTreeItemData *m_data; // user-provided data
333
334 int m_state; // item state
335
336 wxArrayGenericTreeItems m_children; // list of children
337 wxGenericTreeItem *m_parent; // parent of this item
338
339 wxTreeItemAttr *m_attr; // attributes???
340
341 // tree ctrl images for the normal, selected, expanded and
342 // expanded+selected states
343 int m_images[wxTreeItemIcon_Max];
344
345 wxCoord m_x; // (virtual) offset from top
346 wxCoord m_y; // (virtual) offset from left
347 int m_width; // width of this item
348 int m_height; // height of this item
349
350 // use bitfields to save size
351 unsigned int m_isCollapsed :1;
352 unsigned int m_hasHilight :1; // same as focused
353 unsigned int m_hasPlus :1; // used for item which doesn't have
354 // children but has a [+] button
355 unsigned int m_isBold :1; // render the label in bold font
356 unsigned int m_ownsAttr :1; // delete attribute when done
357
358 wxDECLARE_NO_COPY_CLASS(wxGenericTreeItem);
359 };
360
361 // =============================================================================
362 // implementation
363 // =============================================================================
364
365 // ----------------------------------------------------------------------------
366 // private functions
367 // ----------------------------------------------------------------------------
368
369 // translate the key or mouse event flags to the type of selection we're
370 // dealing with
371 static void EventFlagsToSelType(long style,
372 bool shiftDown,
373 bool ctrlDown,
374 bool &is_multiple,
375 bool &extended_select,
376 bool &unselect_others)
377 {
378 is_multiple = (style & wxTR_MULTIPLE) != 0;
379 extended_select = shiftDown && is_multiple;
380 unselect_others = !(extended_select || (ctrlDown && is_multiple));
381 }
382
383 // check if the given item is under another one
384 static bool
385 IsDescendantOf(const wxGenericTreeItem *parent, const wxGenericTreeItem *item)
386 {
387 while ( item )
388 {
389 if ( item == parent )
390 {
391 // item is a descendant of parent
392 return true;
393 }
394
395 item = item->GetParent();
396 }
397
398 return false;
399 }
400
401 // -----------------------------------------------------------------------------
402 // wxTreeRenameTimer (internal)
403 // -----------------------------------------------------------------------------
404
405 wxTreeRenameTimer::wxTreeRenameTimer( wxGenericTreeCtrl *owner )
406 {
407 m_owner = owner;
408 }
409
410 void wxTreeRenameTimer::Notify()
411 {
412 m_owner->OnRenameTimer();
413 }
414
415 //-----------------------------------------------------------------------------
416 // wxTreeTextCtrl (internal)
417 //-----------------------------------------------------------------------------
418
419 BEGIN_EVENT_TABLE(wxTreeTextCtrl,wxTextCtrl)
420 EVT_CHAR (wxTreeTextCtrl::OnChar)
421 EVT_KEY_UP (wxTreeTextCtrl::OnKeyUp)
422 EVT_KILL_FOCUS (wxTreeTextCtrl::OnKillFocus)
423 END_EVENT_TABLE()
424
425 wxTreeTextCtrl::wxTreeTextCtrl(wxGenericTreeCtrl *owner,
426 wxGenericTreeItem *item)
427 : m_itemEdited(item), m_startValue(item->GetText())
428 {
429 m_owner = owner;
430 m_aboutToFinish = false;
431
432 wxRect rect;
433 m_owner->GetBoundingRect(m_itemEdited, rect, true);
434
435 // corrects position and size for better appearance
436 #ifdef __WXMSW__
437 rect.x -= 5;
438 rect.width += 10;
439 #elif defined(__WXGTK__)
440 rect.x -= 5;
441 rect.y -= 2;
442 rect.width += 8;
443 rect.height += 4;
444 #elif defined(__WXMAC__)
445 int bestHeight = GetBestSize().y - 8;
446 if ( rect.height > bestHeight )
447 {
448 int diff = rect.height - bestHeight;
449 rect.height -= diff;
450 rect.y += diff / 2;
451 }
452 #endif // platforms
453
454 (void)Create(m_owner, wxID_ANY, m_startValue,
455 rect.GetPosition(), rect.GetSize());
456
457 SetSelection(-1, -1);
458 }
459
460 void wxTreeTextCtrl::EndEdit(bool discardChanges)
461 {
462 m_aboutToFinish = true;
463
464 if ( discardChanges )
465 {
466 m_owner->OnRenameCancelled(m_itemEdited);
467
468 Finish( true );
469 }
470 else
471 {
472 // Notify the owner about the changes
473 AcceptChanges();
474
475 // Even if vetoed, close the control (consistent with MSW)
476 Finish( true );
477 }
478 }
479
480 bool wxTreeTextCtrl::AcceptChanges()
481 {
482 const wxString value = GetValue();
483
484 if ( value == m_startValue )
485 {
486 // nothing changed, always accept
487 // when an item remains unchanged, the owner
488 // needs to be notified that the user decided
489 // not to change the tree item label, and that
490 // the edit has been cancelled
491
492 m_owner->OnRenameCancelled(m_itemEdited);
493 return true;
494 }
495
496 if ( !m_owner->OnRenameAccept(m_itemEdited, value) )
497 {
498 // vetoed by the user
499 return false;
500 }
501
502 // accepted, do rename the item
503 m_owner->SetItemText(m_itemEdited, value);
504
505 return true;
506 }
507
508 void wxTreeTextCtrl::Finish( bool setfocus )
509 {
510 m_owner->ResetTextControl();
511
512 wxPendingDelete.Append(this);
513
514 if (setfocus)
515 m_owner->SetFocus();
516 }
517
518 void wxTreeTextCtrl::OnChar( wxKeyEvent &event )
519 {
520 switch ( event.m_keyCode )
521 {
522 case WXK_RETURN:
523 EndEdit( false );
524 break;
525
526 case WXK_ESCAPE:
527 EndEdit( true );
528 break;
529
530 default:
531 event.Skip();
532 }
533 }
534
535 void wxTreeTextCtrl::OnKeyUp( wxKeyEvent &event )
536 {
537 if ( !m_aboutToFinish )
538 {
539 // auto-grow the textctrl:
540 wxSize parentSize = m_owner->GetSize();
541 wxPoint myPos = GetPosition();
542 wxSize mySize = GetSize();
543 int sx, sy;
544 GetTextExtent(GetValue() + wxT("M"), &sx, &sy);
545 if (myPos.x + sx > parentSize.x)
546 sx = parentSize.x - myPos.x;
547 if (mySize.x > sx)
548 sx = mySize.x;
549 SetSize(sx, wxDefaultCoord);
550 }
551
552 event.Skip();
553 }
554
555 void wxTreeTextCtrl::OnKillFocus( wxFocusEvent &event )
556 {
557 if ( !m_aboutToFinish )
558 {
559 if ( !AcceptChanges() )
560 m_owner->OnRenameCancelled( m_itemEdited );
561
562 Finish( false );
563 }
564
565 // We should let the native text control handle focus, too.
566 event.Skip();
567 }
568
569 // -----------------------------------------------------------------------------
570 // wxGenericTreeItem
571 // -----------------------------------------------------------------------------
572
573 wxGenericTreeItem::wxGenericTreeItem(wxGenericTreeItem *parent,
574 const wxString& text,
575 int image, int selImage,
576 wxTreeItemData *data)
577 : m_text(text)
578 {
579 m_images[wxTreeItemIcon_Normal] = image;
580 m_images[wxTreeItemIcon_Selected] = selImage;
581 m_images[wxTreeItemIcon_Expanded] = NO_IMAGE;
582 m_images[wxTreeItemIcon_SelectedExpanded] = NO_IMAGE;
583
584 m_data = data;
585 m_state = wxTREE_ITEMSTATE_NONE;
586 m_x = m_y = 0;
587
588 m_isCollapsed = true;
589 m_hasHilight = false;
590 m_hasPlus = false;
591 m_isBold = false;
592
593 m_parent = parent;
594
595 m_attr = NULL;
596 m_ownsAttr = false;
597
598 // We don't know the height here yet.
599 m_width = 0;
600 m_height = 0;
601
602 m_widthText = -1;
603 m_heightText = -1;
604 }
605
606 wxGenericTreeItem::~wxGenericTreeItem()
607 {
608 delete m_data;
609
610 if (m_ownsAttr) delete m_attr;
611
612 wxASSERT_MSG( m_children.IsEmpty(),
613 "must call DeleteChildren() before deleting the item" );
614 }
615
616 void wxGenericTreeItem::DeleteChildren(wxGenericTreeCtrl *tree)
617 {
618 size_t count = m_children.GetCount();
619 for ( size_t n = 0; n < count; n++ )
620 {
621 wxGenericTreeItem *child = m_children[n];
622 tree->SendDeleteEvent(child);
623
624 child->DeleteChildren(tree);
625 if ( child == tree->m_select_me )
626 tree->m_select_me = NULL;
627 delete child;
628 }
629
630 m_children.Empty();
631 }
632
633 size_t wxGenericTreeItem::GetChildrenCount(bool recursively) const
634 {
635 size_t count = m_children.GetCount();
636 if ( !recursively )
637 return count;
638
639 size_t total = count;
640 for (size_t n = 0; n < count; ++n)
641 {
642 total += m_children[n]->GetChildrenCount();
643 }
644
645 return total;
646 }
647
648 void wxGenericTreeItem::GetSize( int &x, int &y,
649 const wxGenericTreeCtrl *theButton )
650 {
651 int bottomY=m_y+theButton->GetLineHeight(this);
652 if ( y < bottomY ) y = bottomY;
653 int width = m_x + m_width;
654 if ( x < width ) x = width;
655
656 if (IsExpanded())
657 {
658 size_t count = m_children.GetCount();
659 for ( size_t n = 0; n < count; ++n )
660 {
661 m_children[n]->GetSize( x, y, theButton );
662 }
663 }
664 }
665
666 wxGenericTreeItem *wxGenericTreeItem::HitTest(const wxPoint& point,
667 const wxGenericTreeCtrl *theCtrl,
668 int &flags,
669 int level)
670 {
671 // for a hidden root node, don't evaluate it, but do evaluate children
672 if ( !(level == 0 && theCtrl->HasFlag(wxTR_HIDE_ROOT)) )
673 {
674 // evaluate the item
675 int h = theCtrl->GetLineHeight(this);
676 if ((point.y > m_y) && (point.y < m_y + h))
677 {
678 int y_mid = m_y + h/2;
679 if (point.y < y_mid )
680 flags |= wxTREE_HITTEST_ONITEMUPPERPART;
681 else
682 flags |= wxTREE_HITTEST_ONITEMLOWERPART;
683
684 int xCross = m_x - theCtrl->GetSpacing();
685 #ifdef __WXMAC__
686 // according to the drawing code the triangels are drawn
687 // at -4 , -4 from the position up to +10/+10 max
688 if ((point.x > xCross-4) && (point.x < xCross+10) &&
689 (point.y > y_mid-4) && (point.y < y_mid+10) &&
690 HasPlus() && theCtrl->HasButtons() )
691 #else
692 // 5 is the size of the plus sign
693 if ((point.x > xCross-6) && (point.x < xCross+6) &&
694 (point.y > y_mid-6) && (point.y < y_mid+6) &&
695 HasPlus() && theCtrl->HasButtons() )
696 #endif
697 {
698 flags |= wxTREE_HITTEST_ONITEMBUTTON;
699 return this;
700 }
701
702 if ((point.x >= m_x) && (point.x <= m_x+m_width))
703 {
704 int image_w = -1;
705 int image_h;
706
707 // assuming every image (normal and selected) has the same size!
708 if ( (GetImage() != NO_IMAGE) && theCtrl->m_imageListNormal )
709 {
710 theCtrl->m_imageListNormal->GetSize(GetImage(),
711 image_w, image_h);
712 }
713
714 int state_w = -1;
715 int state_h;
716
717 if ( (GetState() != wxTREE_ITEMSTATE_NONE) &&
718 theCtrl->m_imageListState )
719 {
720 theCtrl->m_imageListState->GetSize(GetState(),
721 state_w, state_h);
722 }
723
724 if ((state_w != -1) && (point.x <= m_x + state_w + 1))
725 flags |= wxTREE_HITTEST_ONITEMSTATEICON;
726 else if ((image_w != -1) &&
727 (point.x <= m_x +
728 (state_w != -1 ? state_w +
729 MARGIN_BETWEEN_STATE_AND_IMAGE
730 : 0)
731 + image_w + 1))
732 flags |= wxTREE_HITTEST_ONITEMICON;
733 else
734 flags |= wxTREE_HITTEST_ONITEMLABEL;
735
736 return this;
737 }
738
739 if (point.x < m_x)
740 flags |= wxTREE_HITTEST_ONITEMINDENT;
741 if (point.x > m_x+m_width)
742 flags |= wxTREE_HITTEST_ONITEMRIGHT;
743
744 return this;
745 }
746
747 // if children are expanded, fall through to evaluate them
748 if (m_isCollapsed) return NULL;
749 }
750
751 // evaluate children
752 size_t count = m_children.GetCount();
753 for ( size_t n = 0; n < count; n++ )
754 {
755 wxGenericTreeItem *res = m_children[n]->HitTest( point,
756 theCtrl,
757 flags,
758 level + 1 );
759 if ( res != NULL )
760 return res;
761 }
762
763 return NULL;
764 }
765
766 int wxGenericTreeItem::GetCurrentImage() const
767 {
768 int image = NO_IMAGE;
769 if ( IsExpanded() )
770 {
771 if ( IsSelected() )
772 {
773 image = GetImage(wxTreeItemIcon_SelectedExpanded);
774 }
775
776 if ( image == NO_IMAGE )
777 {
778 // we usually fall back to the normal item, but try just the
779 // expanded one (and not selected) first in this case
780 image = GetImage(wxTreeItemIcon_Expanded);
781 }
782 }
783 else // not expanded
784 {
785 if ( IsSelected() )
786 image = GetImage(wxTreeItemIcon_Selected);
787 }
788
789 // maybe it doesn't have the specific image we want,
790 // try the default one instead
791 if ( image == NO_IMAGE ) image = GetImage();
792
793 return image;
794 }
795
796 void wxGenericTreeItem::CalculateSize(wxGenericTreeCtrl* control)
797 {
798 // check if we need to do anything before creating the DC
799 if ( m_width != 0 )
800 return;
801
802 wxClientDC dc(control);
803 DoCalculateSize(control, dc, false /* normal font not used */);
804 }
805
806 void
807 wxGenericTreeItem::DoCalculateSize(wxGenericTreeCtrl* control,
808 wxDC& dc,
809 bool dcUsesNormalFont)
810 {
811 if ( m_width != 0 ) // Size known, nothing to do
812 return;
813
814 if ( m_widthText == -1 )
815 {
816 bool fontChanged;
817 if ( SetFont(control, dc) )
818 {
819 fontChanged = true;
820 }
821 else // we have no special font
822 {
823 if ( !dcUsesNormalFont )
824 {
825 // but we do need to ensure that the normal font is used: notice
826 // that this doesn't count as changing the font as we don't need
827 // to restore it
828 dc.SetFont(control->m_normalFont);
829 }
830
831 fontChanged = false;
832 }
833
834 dc.GetTextExtent( GetText(), &m_widthText, &m_heightText );
835
836 // restore normal font if the DC used it previously and we changed it
837 if ( fontChanged )
838 dc.SetFont(control->m_normalFont);
839 }
840
841 int text_h = m_heightText + 2;
842
843 int image_h = 0, image_w = 0;
844 int image = GetCurrentImage();
845 if ( image != NO_IMAGE && control->m_imageListNormal )
846 {
847 control->m_imageListNormal->GetSize(image, image_w, image_h);
848 image_w += MARGIN_BETWEEN_IMAGE_AND_TEXT;
849 }
850
851 int state_h = 0, state_w = 0;
852 int state = GetState();
853 if ( state != wxTREE_ITEMSTATE_NONE && control->m_imageListState )
854 {
855 control->m_imageListState->GetSize(state, state_w, state_h);
856 if ( image_w != 0 )
857 state_w += MARGIN_BETWEEN_STATE_AND_IMAGE;
858 else
859 state_w += MARGIN_BETWEEN_IMAGE_AND_TEXT;
860 }
861
862 int img_h = wxMax(state_h, image_h);
863 m_height = wxMax(img_h, text_h);
864
865 if (m_height < 30)
866 m_height += 2; // at least 2 pixels
867 else
868 m_height += m_height / 10; // otherwise 10% extra spacing
869
870 if (m_height > control->m_lineHeight)
871 control->m_lineHeight = m_height;
872
873 m_width = state_w + image_w + m_widthText + 2;
874 }
875
876 void wxGenericTreeItem::RecursiveResetSize()
877 {
878 m_width = 0;
879
880 const size_t count = m_children.Count();
881 for (size_t i = 0; i < count; i++ )
882 m_children[i]->RecursiveResetSize();
883 }
884
885 void wxGenericTreeItem::RecursiveResetTextSize()
886 {
887 m_width = 0;
888 m_widthText = -1;
889
890 const size_t count = m_children.Count();
891 for (size_t i = 0; i < count; i++ )
892 m_children[i]->RecursiveResetTextSize();
893 }
894
895 // -----------------------------------------------------------------------------
896 // wxGenericTreeCtrl implementation
897 // -----------------------------------------------------------------------------
898
899 IMPLEMENT_DYNAMIC_CLASS(wxGenericTreeCtrl, wxControl)
900
901 BEGIN_EVENT_TABLE(wxGenericTreeCtrl, wxTreeCtrlBase)
902 EVT_PAINT (wxGenericTreeCtrl::OnPaint)
903 EVT_SIZE (wxGenericTreeCtrl::OnSize)
904 EVT_MOUSE_EVENTS (wxGenericTreeCtrl::OnMouse)
905 EVT_CHAR (wxGenericTreeCtrl::OnChar)
906 EVT_SET_FOCUS (wxGenericTreeCtrl::OnSetFocus)
907 EVT_KILL_FOCUS (wxGenericTreeCtrl::OnKillFocus)
908 EVT_TREE_ITEM_GETTOOLTIP(wxID_ANY, wxGenericTreeCtrl::OnGetToolTip)
909 END_EVENT_TABLE()
910
911 #if !defined(__WXMSW__) || defined(__WXUNIVERSAL__)
912 /*
913 * wxTreeCtrl has to be a real class or we have problems with
914 * the run-time information.
915 */
916
917 IMPLEMENT_DYNAMIC_CLASS(wxTreeCtrl, wxGenericTreeCtrl)
918 #endif
919
920 // -----------------------------------------------------------------------------
921 // construction/destruction
922 // -----------------------------------------------------------------------------
923
924 void wxGenericTreeCtrl::Init()
925 {
926 m_current =
927 m_key_current =
928 m_anchor =
929 m_select_me = NULL;
930 m_hasFocus = false;
931 m_dirty = false;
932
933 m_lineHeight = 10;
934 m_indent = 15;
935 m_spacing = 18;
936
937 m_hilightBrush = new wxBrush
938 (
939 wxSystemSettings::GetColour
940 (
941 wxSYS_COLOUR_HIGHLIGHT
942 ),
943 wxBRUSHSTYLE_SOLID
944 );
945
946 m_hilightUnfocusedBrush = new wxBrush
947 (
948 wxSystemSettings::GetColour
949 (
950 wxSYS_COLOUR_BTNSHADOW
951 ),
952 wxBRUSHSTYLE_SOLID
953 );
954
955 m_imageListButtons = NULL;
956 m_ownsImageListButtons = false;
957
958 m_dragCount = 0;
959 m_isDragging = false;
960 m_dropTarget = m_oldSelection = NULL;
961 m_underMouse = NULL;
962 m_textCtrl = NULL;
963
964 m_renameTimer = NULL;
965
966 m_findTimer = NULL;
967
968 m_dropEffectAboveItem = false;
969
970 m_dndEffect = NoEffect;
971 m_dndEffectItem = NULL;
972
973 m_lastOnSame = false;
974
975 #if defined( __WXMAC__ )
976 m_normalFont = wxFont(wxOSX_SYSTEM_FONT_VIEWS);
977 #else
978 m_normalFont = wxSystemSettings::GetFont( wxSYS_DEFAULT_GUI_FONT );
979 #endif
980 m_boldFont = wxFont(m_normalFont.GetPointSize(),
981 m_normalFont.GetFamily(),
982 m_normalFont.GetStyle(),
983 wxBOLD,
984 m_normalFont.GetUnderlined(),
985 m_normalFont.GetFaceName(),
986 m_normalFont.GetEncoding());
987 }
988
989 bool wxGenericTreeCtrl::Create(wxWindow *parent,
990 wxWindowID id,
991 const wxPoint& pos,
992 const wxSize& size,
993 long style,
994 const wxValidator& validator,
995 const wxString& name )
996 {
997 #ifdef __WXMAC__
998 int major, minor;
999 wxGetOsVersion(&major, &minor);
1000
1001 if (major < 10)
1002 style |= wxTR_ROW_LINES;
1003
1004 if (style & wxTR_HAS_BUTTONS)
1005 style |= wxTR_NO_LINES;
1006 #endif // __WXMAC__
1007
1008 #ifdef __WXGTK20__
1009 if (style & wxTR_HAS_BUTTONS)
1010 style |= wxTR_NO_LINES;
1011 #endif
1012
1013 if ( !wxControl::Create( parent, id, pos, size,
1014 style|wxHSCROLL|wxVSCROLL,
1015 validator,
1016 name ) )
1017 return false;
1018
1019 // If the tree display has no buttons, but does have
1020 // connecting lines, we can use a narrower layout.
1021 // It may not be a good idea to force this...
1022 if (!HasButtons() && !HasFlag(wxTR_NO_LINES))
1023 {
1024 m_indent= 10;
1025 m_spacing = 10;
1026 }
1027
1028 wxVisualAttributes attr = GetDefaultAttributes();
1029 SetOwnForegroundColour( attr.colFg );
1030 SetOwnBackgroundColour( attr.colBg );
1031 if (!m_hasFont)
1032 SetOwnFont(attr.font);
1033
1034 // this is a misnomer: it's called "dotted pen" but uses (default) wxSOLID
1035 // style because we apparently get performance problems when using dotted
1036 // pen for drawing in some ports -- but under MSW it seems to work fine
1037 #ifdef __WXMSW__
1038 m_dottedPen = wxPen(*wxLIGHT_GREY, 0, wxPENSTYLE_DOT);
1039 #else
1040 m_dottedPen = *wxGREY_PEN;
1041 #endif
1042
1043 SetInitialSize(size);
1044
1045 return true;
1046 }
1047
1048 wxGenericTreeCtrl::~wxGenericTreeCtrl()
1049 {
1050 delete m_hilightBrush;
1051 delete m_hilightUnfocusedBrush;
1052
1053 DeleteAllItems();
1054
1055 delete m_renameTimer;
1056 delete m_findTimer;
1057
1058 if (m_ownsImageListButtons)
1059 delete m_imageListButtons;
1060 }
1061
1062 // -----------------------------------------------------------------------------
1063 // accessors
1064 // -----------------------------------------------------------------------------
1065
1066 unsigned int wxGenericTreeCtrl::GetCount() const
1067 {
1068 if ( !m_anchor )
1069 {
1070 // the tree is empty
1071 return 0;
1072 }
1073
1074 unsigned int count = m_anchor->GetChildrenCount();
1075 if ( !HasFlag(wxTR_HIDE_ROOT) )
1076 {
1077 // take the root itself into account
1078 count++;
1079 }
1080
1081 return count;
1082 }
1083
1084 void wxGenericTreeCtrl::SetIndent(unsigned int indent)
1085 {
1086 m_indent = (unsigned short) indent;
1087 m_dirty = true;
1088 }
1089
1090 size_t
1091 wxGenericTreeCtrl::GetChildrenCount(const wxTreeItemId& item,
1092 bool recursively) const
1093 {
1094 wxCHECK_MSG( item.IsOk(), 0u, wxT("invalid tree item") );
1095
1096 return ((wxGenericTreeItem*) item.m_pItem)->GetChildrenCount(recursively);
1097 }
1098
1099 void wxGenericTreeCtrl::SetWindowStyle(const long styles)
1100 {
1101 // Do not try to expand the root node if it hasn't been created yet
1102 if (m_anchor && !HasFlag(wxTR_HIDE_ROOT) && (styles & wxTR_HIDE_ROOT))
1103 {
1104 // if we will hide the root, make sure children are visible
1105 m_anchor->SetHasPlus();
1106 m_anchor->Expand();
1107 CalculatePositions();
1108 }
1109
1110 // right now, just sets the styles. Eventually, we may
1111 // want to update the inherited styles, but right now
1112 // none of the parents has updatable styles
1113 m_windowStyle = styles;
1114 m_dirty = true;
1115 }
1116
1117 // -----------------------------------------------------------------------------
1118 // functions to work with tree items
1119 // -----------------------------------------------------------------------------
1120
1121 wxString wxGenericTreeCtrl::GetItemText(const wxTreeItemId& item) const
1122 {
1123 wxCHECK_MSG( item.IsOk(), wxEmptyString, wxT("invalid tree item") );
1124
1125 return ((wxGenericTreeItem*) item.m_pItem)->GetText();
1126 }
1127
1128 int wxGenericTreeCtrl::GetItemImage(const wxTreeItemId& item,
1129 wxTreeItemIcon which) const
1130 {
1131 wxCHECK_MSG( item.IsOk(), -1, wxT("invalid tree item") );
1132
1133 return ((wxGenericTreeItem*) item.m_pItem)->GetImage(which);
1134 }
1135
1136 wxTreeItemData *wxGenericTreeCtrl::GetItemData(const wxTreeItemId& item) const
1137 {
1138 wxCHECK_MSG( item.IsOk(), NULL, wxT("invalid tree item") );
1139
1140 return ((wxGenericTreeItem*) item.m_pItem)->GetData();
1141 }
1142
1143 int wxGenericTreeCtrl::DoGetItemState(const wxTreeItemId& item) const
1144 {
1145 wxCHECK_MSG( item.IsOk(), wxTREE_ITEMSTATE_NONE, wxT("invalid tree item") );
1146
1147 wxGenericTreeItem *pItem = (wxGenericTreeItem*) item.m_pItem;
1148 return pItem->GetState();
1149 }
1150
1151 wxColour wxGenericTreeCtrl::GetItemTextColour(const wxTreeItemId& item) const
1152 {
1153 wxCHECK_MSG( item.IsOk(), wxNullColour, wxT("invalid tree item") );
1154
1155 wxGenericTreeItem *pItem = (wxGenericTreeItem*) item.m_pItem;
1156 return pItem->Attr().GetTextColour();
1157 }
1158
1159 wxColour
1160 wxGenericTreeCtrl::GetItemBackgroundColour(const wxTreeItemId& item) const
1161 {
1162 wxCHECK_MSG( item.IsOk(), wxNullColour, wxT("invalid tree item") );
1163
1164 wxGenericTreeItem *pItem = (wxGenericTreeItem*) item.m_pItem;
1165 return pItem->Attr().GetBackgroundColour();
1166 }
1167
1168 wxFont wxGenericTreeCtrl::GetItemFont(const wxTreeItemId& item) const
1169 {
1170 wxCHECK_MSG( item.IsOk(), wxNullFont, wxT("invalid tree item") );
1171
1172 wxGenericTreeItem *pItem = (wxGenericTreeItem*) item.m_pItem;
1173 return pItem->Attr().GetFont();
1174 }
1175
1176 void
1177 wxGenericTreeCtrl::SetItemText(const wxTreeItemId& item, const wxString& text)
1178 {
1179 wxCHECK_RET( item.IsOk(), wxT("invalid tree item") );
1180
1181 wxGenericTreeItem *pItem = (wxGenericTreeItem*) item.m_pItem;
1182 pItem->SetText(text);
1183 pItem->CalculateSize(this);
1184 RefreshLine(pItem);
1185 }
1186
1187 void wxGenericTreeCtrl::SetItemImage(const wxTreeItemId& item,
1188 int image,
1189 wxTreeItemIcon which)
1190 {
1191 wxCHECK_RET( item.IsOk(), wxT("invalid tree item") );
1192
1193 wxGenericTreeItem *pItem = (wxGenericTreeItem*) item.m_pItem;
1194 pItem->SetImage(image, which);
1195 pItem->CalculateSize(this);
1196 RefreshLine(pItem);
1197 }
1198
1199 void
1200 wxGenericTreeCtrl::SetItemData(const wxTreeItemId& item, wxTreeItemData *data)
1201 {
1202 wxCHECK_RET( item.IsOk(), wxT("invalid tree item") );
1203
1204 if (data)
1205 data->SetId( item );
1206
1207 ((wxGenericTreeItem*) item.m_pItem)->SetData(data);
1208 }
1209
1210 void wxGenericTreeCtrl::DoSetItemState(const wxTreeItemId& item, int state)
1211 {
1212 wxCHECK_RET( item.IsOk(), wxT("invalid tree item") );
1213
1214 wxGenericTreeItem *pItem = (wxGenericTreeItem*) item.m_pItem;
1215 pItem->SetState(state);
1216 pItem->CalculateSize(this);
1217 RefreshLine(pItem);
1218 }
1219
1220 void wxGenericTreeCtrl::SetItemHasChildren(const wxTreeItemId& item, bool has)
1221 {
1222 wxCHECK_RET( item.IsOk(), wxT("invalid tree item") );
1223
1224 wxGenericTreeItem *pItem = (wxGenericTreeItem*) item.m_pItem;
1225 pItem->SetHasPlus(has);
1226 RefreshLine(pItem);
1227 }
1228
1229 void wxGenericTreeCtrl::SetItemBold(const wxTreeItemId& item, bool bold)
1230 {
1231 wxCHECK_RET( item.IsOk(), wxT("invalid tree item") );
1232
1233 // avoid redrawing the tree if no real change
1234 wxGenericTreeItem *pItem = (wxGenericTreeItem*) item.m_pItem;
1235 if ( pItem->IsBold() != bold )
1236 {
1237 pItem->SetBold(bold);
1238
1239 // recalculate the item size as bold and non bold fonts have different
1240 // widths
1241 pItem->CalculateSize(this);
1242 RefreshLine(pItem);
1243 }
1244 }
1245
1246 void wxGenericTreeCtrl::SetItemDropHighlight(const wxTreeItemId& item,
1247 bool highlight)
1248 {
1249 wxCHECK_RET( item.IsOk(), wxT("invalid tree item") );
1250
1251 wxColour fg, bg;
1252
1253 if (highlight)
1254 {
1255 bg = wxSystemSettings::GetColour(wxSYS_COLOUR_HIGHLIGHT);
1256 fg = wxSystemSettings::GetColour(wxSYS_COLOUR_HIGHLIGHTTEXT);
1257 }
1258
1259 wxGenericTreeItem *pItem = (wxGenericTreeItem*) item.m_pItem;
1260 pItem->Attr().SetTextColour(fg);
1261 pItem->Attr().SetBackgroundColour(bg);
1262 RefreshLine(pItem);
1263 }
1264
1265 void wxGenericTreeCtrl::SetItemTextColour(const wxTreeItemId& item,
1266 const wxColour& col)
1267 {
1268 wxCHECK_RET( item.IsOk(), wxT("invalid tree item") );
1269
1270 wxGenericTreeItem *pItem = (wxGenericTreeItem*) item.m_pItem;
1271 pItem->Attr().SetTextColour(col);
1272 RefreshLine(pItem);
1273 }
1274
1275 void wxGenericTreeCtrl::SetItemBackgroundColour(const wxTreeItemId& item,
1276 const wxColour& col)
1277 {
1278 wxCHECK_RET( item.IsOk(), wxT("invalid tree item") );
1279
1280 wxGenericTreeItem *pItem = (wxGenericTreeItem*) item.m_pItem;
1281 pItem->Attr().SetBackgroundColour(col);
1282 RefreshLine(pItem);
1283 }
1284
1285 void
1286 wxGenericTreeCtrl::SetItemFont(const wxTreeItemId& item, const wxFont& font)
1287 {
1288 wxCHECK_RET( item.IsOk(), wxT("invalid tree item") );
1289
1290 wxGenericTreeItem *pItem = (wxGenericTreeItem*) item.m_pItem;
1291 pItem->Attr().SetFont(font);
1292 pItem->ResetTextSize();
1293 pItem->CalculateSize(this);
1294 RefreshLine(pItem);
1295 }
1296
1297 bool wxGenericTreeCtrl::SetFont( const wxFont &font )
1298 {
1299 wxTreeCtrlBase::SetFont(font);
1300
1301 m_normalFont = font ;
1302 m_boldFont = wxFont(m_normalFont.GetPointSize(),
1303 m_normalFont.GetFamily(),
1304 m_normalFont.GetStyle(),
1305 wxBOLD,
1306 m_normalFont.GetUnderlined(),
1307 m_normalFont.GetFaceName(),
1308 m_normalFont.GetEncoding());
1309
1310 if (m_anchor)
1311 m_anchor->RecursiveResetTextSize();
1312
1313 return true;
1314 }
1315
1316
1317 // -----------------------------------------------------------------------------
1318 // item status inquiries
1319 // -----------------------------------------------------------------------------
1320
1321 bool wxGenericTreeCtrl::IsVisible(const wxTreeItemId& item) const
1322 {
1323 wxCHECK_MSG( item.IsOk(), false, wxT("invalid tree item") );
1324
1325 // An item is only visible if it's not a descendant of a collapsed item
1326 wxGenericTreeItem *pItem = (wxGenericTreeItem*) item.m_pItem;
1327 wxGenericTreeItem* parent = pItem->GetParent();
1328 while (parent)
1329 {
1330 if (!parent->IsExpanded())
1331 return false;
1332 parent = parent->GetParent();
1333 }
1334
1335 int startX, startY;
1336 GetViewStart(& startX, & startY);
1337
1338 wxSize clientSize = GetClientSize();
1339
1340 wxRect rect;
1341 if (!GetBoundingRect(item, rect))
1342 return false;
1343 if (rect.GetWidth() == 0 || rect.GetHeight() == 0)
1344 return false;
1345 if (rect.GetBottom() < 0 || rect.GetTop() > clientSize.y)
1346 return false;
1347 if (rect.GetRight() < 0 || rect.GetLeft() > clientSize.x)
1348 return false;
1349
1350 return true;
1351 }
1352
1353 bool wxGenericTreeCtrl::ItemHasChildren(const wxTreeItemId& item) const
1354 {
1355 wxCHECK_MSG( item.IsOk(), false, wxT("invalid tree item") );
1356
1357 // consider that the item does have children if it has the "+" button: it
1358 // might not have them (if it had never been expanded yet) but then it
1359 // could have them as well and it's better to err on this side rather than
1360 // disabling some operations which are restricted to the items with
1361 // children for an item which does have them
1362 return ((wxGenericTreeItem*) item.m_pItem)->HasPlus();
1363 }
1364
1365 bool wxGenericTreeCtrl::IsExpanded(const wxTreeItemId& item) const
1366 {
1367 wxCHECK_MSG( item.IsOk(), false, wxT("invalid tree item") );
1368
1369 return ((wxGenericTreeItem*) item.m_pItem)->IsExpanded();
1370 }
1371
1372 bool wxGenericTreeCtrl::IsSelected(const wxTreeItemId& item) const
1373 {
1374 wxCHECK_MSG( item.IsOk(), false, wxT("invalid tree item") );
1375
1376 return ((wxGenericTreeItem*) item.m_pItem)->IsSelected();
1377 }
1378
1379 bool wxGenericTreeCtrl::IsBold(const wxTreeItemId& item) const
1380 {
1381 wxCHECK_MSG( item.IsOk(), false, wxT("invalid tree item") );
1382
1383 return ((wxGenericTreeItem*) item.m_pItem)->IsBold();
1384 }
1385
1386 // -----------------------------------------------------------------------------
1387 // navigation
1388 // -----------------------------------------------------------------------------
1389
1390 wxTreeItemId wxGenericTreeCtrl::GetItemParent(const wxTreeItemId& item) const
1391 {
1392 wxCHECK_MSG( item.IsOk(), wxTreeItemId(), wxT("invalid tree item") );
1393
1394 return ((wxGenericTreeItem*) item.m_pItem)->GetParent();
1395 }
1396
1397 wxTreeItemId wxGenericTreeCtrl::GetFirstChild(const wxTreeItemId& item,
1398 wxTreeItemIdValue& cookie) const
1399 {
1400 wxCHECK_MSG( item.IsOk(), wxTreeItemId(), wxT("invalid tree item") );
1401
1402 cookie = 0;
1403 return GetNextChild(item, cookie);
1404 }
1405
1406 wxTreeItemId wxGenericTreeCtrl::GetNextChild(const wxTreeItemId& item,
1407 wxTreeItemIdValue& cookie) const
1408 {
1409 wxCHECK_MSG( item.IsOk(), wxTreeItemId(), wxT("invalid tree item") );
1410
1411 wxArrayGenericTreeItems&
1412 children = ((wxGenericTreeItem*) item.m_pItem)->GetChildren();
1413
1414 // it's ok to cast cookie to size_t, we never have indices big enough to
1415 // overflow "void *"
1416 size_t *pIndex = (size_t *)&cookie;
1417 if ( *pIndex < children.GetCount() )
1418 {
1419 return children.Item((*pIndex)++);
1420 }
1421 else
1422 {
1423 // there are no more of them
1424 return wxTreeItemId();
1425 }
1426 }
1427
1428 wxTreeItemId wxGenericTreeCtrl::GetLastChild(const wxTreeItemId& item) const
1429 {
1430 wxCHECK_MSG( item.IsOk(), wxTreeItemId(), wxT("invalid tree item") );
1431
1432 wxArrayGenericTreeItems&
1433 children = ((wxGenericTreeItem*) item.m_pItem)->GetChildren();
1434 return children.IsEmpty() ? wxTreeItemId() : wxTreeItemId(children.Last());
1435 }
1436
1437 wxTreeItemId wxGenericTreeCtrl::GetNextSibling(const wxTreeItemId& item) const
1438 {
1439 wxCHECK_MSG( item.IsOk(), wxTreeItemId(), wxT("invalid tree item") );
1440
1441 wxGenericTreeItem *i = (wxGenericTreeItem*) item.m_pItem;
1442 wxGenericTreeItem *parent = i->GetParent();
1443 if ( parent == NULL )
1444 {
1445 // root item doesn't have any siblings
1446 return wxTreeItemId();
1447 }
1448
1449 wxArrayGenericTreeItems& siblings = parent->GetChildren();
1450 int index = siblings.Index(i);
1451 wxASSERT( index != wxNOT_FOUND ); // I'm not a child of my parent?
1452
1453 size_t n = (size_t)(index + 1);
1454 return n == siblings.GetCount() ? wxTreeItemId()
1455 : wxTreeItemId(siblings[n]);
1456 }
1457
1458 wxTreeItemId wxGenericTreeCtrl::GetPrevSibling(const wxTreeItemId& item) const
1459 {
1460 wxCHECK_MSG( item.IsOk(), wxTreeItemId(), wxT("invalid tree item") );
1461
1462 wxGenericTreeItem *i = (wxGenericTreeItem*) item.m_pItem;
1463 wxGenericTreeItem *parent = i->GetParent();
1464 if ( parent == NULL )
1465 {
1466 // root item doesn't have any siblings
1467 return wxTreeItemId();
1468 }
1469
1470 wxArrayGenericTreeItems& siblings = parent->GetChildren();
1471 int index = siblings.Index(i);
1472 wxASSERT( index != wxNOT_FOUND ); // I'm not a child of my parent?
1473
1474 return index == 0 ? wxTreeItemId()
1475 : wxTreeItemId(siblings[(size_t)(index - 1)]);
1476 }
1477
1478 // Only for internal use right now, but should probably be public
1479 wxTreeItemId wxGenericTreeCtrl::GetNext(const wxTreeItemId& item) const
1480 {
1481 wxCHECK_MSG( item.IsOk(), wxTreeItemId(), wxT("invalid tree item") );
1482
1483 wxGenericTreeItem *i = (wxGenericTreeItem*) item.m_pItem;
1484
1485 // First see if there are any children.
1486 wxArrayGenericTreeItems& children = i->GetChildren();
1487 if (children.GetCount() > 0)
1488 {
1489 return children.Item(0);
1490 }
1491 else
1492 {
1493 // Try a sibling of this or ancestor instead
1494 wxTreeItemId p = item;
1495 wxTreeItemId toFind;
1496 do
1497 {
1498 toFind = GetNextSibling(p);
1499 p = GetItemParent(p);
1500 } while (p.IsOk() && !toFind.IsOk());
1501 return toFind;
1502 }
1503 }
1504
1505 wxTreeItemId wxGenericTreeCtrl::GetFirstVisibleItem() const
1506 {
1507 wxTreeItemId id = GetRootItem();
1508 if (!id.IsOk())
1509 return id;
1510
1511 do
1512 {
1513 if (IsVisible(id))
1514 return id;
1515 id = GetNext(id);
1516 } while (id.IsOk());
1517
1518 return wxTreeItemId();
1519 }
1520
1521 wxTreeItemId wxGenericTreeCtrl::GetNextVisible(const wxTreeItemId& item) const
1522 {
1523 wxCHECK_MSG( item.IsOk(), wxTreeItemId(), wxT("invalid tree item") );
1524 wxASSERT_MSG( IsVisible(item), wxT("this item itself should be visible") );
1525
1526 wxTreeItemId id = item;
1527 if (id.IsOk())
1528 {
1529 while (id = GetNext(id), id.IsOk())
1530 {
1531 if (IsVisible(id))
1532 return id;
1533 }
1534 }
1535 return wxTreeItemId();
1536 }
1537
1538 wxTreeItemId wxGenericTreeCtrl::GetPrevVisible(const wxTreeItemId& item) const
1539 {
1540 wxCHECK_MSG( item.IsOk(), wxTreeItemId(), wxT("invalid tree item") );
1541 wxASSERT_MSG( IsVisible(item), wxT("this item itself should be visible") );
1542
1543 // find out the starting point
1544 wxTreeItemId prevItem = GetPrevSibling(item);
1545 if ( !prevItem.IsOk() )
1546 {
1547 prevItem = GetItemParent(item);
1548 }
1549
1550 // find the first visible item after it
1551 while ( prevItem.IsOk() && !IsVisible(prevItem) )
1552 {
1553 prevItem = GetNext(prevItem);
1554 if ( !prevItem.IsOk() || prevItem == item )
1555 {
1556 // there are no visible items before item
1557 return wxTreeItemId();
1558 }
1559 }
1560
1561 // from there we must be able to navigate until this item
1562 while ( prevItem.IsOk() )
1563 {
1564 const wxTreeItemId nextItem = GetNextVisible(prevItem);
1565 if ( !nextItem.IsOk() || nextItem == item )
1566 break;
1567
1568 prevItem = nextItem;
1569 }
1570
1571 return prevItem;
1572 }
1573
1574 // called by wxTextTreeCtrl when it marks itself for deletion
1575 void wxGenericTreeCtrl::ResetTextControl()
1576 {
1577 m_textCtrl = NULL;
1578 }
1579
1580 // find the first item starting with the given prefix after the given item
1581 wxTreeItemId wxGenericTreeCtrl::FindItem(const wxTreeItemId& idParent,
1582 const wxString& prefixOrig) const
1583 {
1584 // match is case insensitive as this is more convenient to the user: having
1585 // to press Shift-letter to go to the item starting with a capital letter
1586 // would be too bothersome
1587 wxString prefix = prefixOrig.Lower();
1588
1589 // determine the starting point: we shouldn't take the current item (this
1590 // allows to switch between two items starting with the same letter just by
1591 // pressing it) but we shouldn't jump to the next one if the user is
1592 // continuing to type as otherwise he might easily skip the item he wanted
1593 wxTreeItemId id = idParent;
1594 if ( prefix.length() == 1 )
1595 {
1596 id = GetNext(id);
1597 }
1598
1599 // look for the item starting with the given prefix after it
1600 while ( id.IsOk() && !GetItemText(id).Lower().StartsWith(prefix) )
1601 {
1602 id = GetNext(id);
1603 }
1604
1605 // if we haven't found anything...
1606 if ( !id.IsOk() )
1607 {
1608 // ... wrap to the beginning
1609 id = GetRootItem();
1610 if ( HasFlag(wxTR_HIDE_ROOT) )
1611 {
1612 // can't select virtual root
1613 id = GetNext(id);
1614 }
1615
1616 // and try all the items (stop when we get to the one we started from)
1617 while ( id.IsOk() && id != idParent &&
1618 !GetItemText(id).Lower().StartsWith(prefix) )
1619 {
1620 id = GetNext(id);
1621 }
1622 // If we haven't found the item, id.IsOk() will be false, as per
1623 // documentation
1624 }
1625
1626 return id;
1627 }
1628
1629 // -----------------------------------------------------------------------------
1630 // operations
1631 // -----------------------------------------------------------------------------
1632
1633 wxTreeItemId wxGenericTreeCtrl::DoInsertItem(const wxTreeItemId& parentId,
1634 size_t previous,
1635 const wxString& text,
1636 int image,
1637 int selImage,
1638 wxTreeItemData *data)
1639 {
1640 wxGenericTreeItem *parent = (wxGenericTreeItem*) parentId.m_pItem;
1641 if ( !parent )
1642 {
1643 // should we give a warning here?
1644 return AddRoot(text, image, selImage, data);
1645 }
1646
1647 m_dirty = true; // do this first so stuff below doesn't cause flicker
1648
1649 wxGenericTreeItem *item =
1650 new wxGenericTreeItem( parent, text, image, selImage, data );
1651
1652 if ( data != NULL )
1653 {
1654 data->m_pItem = item;
1655 }
1656
1657 parent->Insert( item, previous == (size_t)-1 ? parent->GetChildren().size()
1658 : previous );
1659
1660 InvalidateBestSize();
1661 return item;
1662 }
1663
1664 wxTreeItemId wxGenericTreeCtrl::AddRoot(const wxString& text,
1665 int image,
1666 int selImage,
1667 wxTreeItemData *data)
1668 {
1669 wxCHECK_MSG( !m_anchor, wxTreeItemId(), "tree can have only one root" );
1670
1671 m_dirty = true; // do this first so stuff below doesn't cause flicker
1672
1673 m_anchor = new wxGenericTreeItem(NULL, text,
1674 image, selImage, data);
1675 if ( data != NULL )
1676 {
1677 data->m_pItem = m_anchor;
1678 }
1679
1680 if (HasFlag(wxTR_HIDE_ROOT))
1681 {
1682 // if root is hidden, make sure we can navigate
1683 // into children
1684 m_anchor->SetHasPlus();
1685 m_anchor->Expand();
1686 CalculatePositions();
1687 }
1688
1689 if (!HasFlag(wxTR_MULTIPLE))
1690 {
1691 m_current = m_key_current = m_anchor;
1692 m_current->SetHilight( true );
1693 }
1694
1695 InvalidateBestSize();
1696 return m_anchor;
1697 }
1698
1699 wxTreeItemId wxGenericTreeCtrl::DoInsertAfter(const wxTreeItemId& parentId,
1700 const wxTreeItemId& idPrevious,
1701 const wxString& text,
1702 int image, int selImage,
1703 wxTreeItemData *data)
1704 {
1705 wxGenericTreeItem *parent = (wxGenericTreeItem*) parentId.m_pItem;
1706 if ( !parent )
1707 {
1708 // should we give a warning here?
1709 return AddRoot(text, image, selImage, data);
1710 }
1711
1712 int index = -1;
1713 if (idPrevious.IsOk())
1714 {
1715 index = parent->GetChildren().Index(
1716 (wxGenericTreeItem*) idPrevious.m_pItem);
1717 wxASSERT_MSG( index != wxNOT_FOUND,
1718 "previous item in wxGenericTreeCtrl::InsertItem() "
1719 "is not a sibling" );
1720 }
1721
1722 return DoInsertItem(parentId, (size_t)++index, text, image, selImage, data);
1723 }
1724
1725
1726 void wxGenericTreeCtrl::SendDeleteEvent(wxGenericTreeItem *item)
1727 {
1728 wxTreeEvent event(wxEVT_COMMAND_TREE_DELETE_ITEM, this, item);
1729 GetEventHandler()->ProcessEvent( event );
1730 }
1731
1732 // Don't leave edit or selection on a child which is about to disappear
1733 void wxGenericTreeCtrl::ChildrenClosing(wxGenericTreeItem* item)
1734 {
1735 if ( m_textCtrl && item != m_textCtrl->item() &&
1736 IsDescendantOf(item, m_textCtrl->item()) )
1737 {
1738 m_textCtrl->EndEdit( true );
1739 }
1740
1741 if ( item != m_key_current && IsDescendantOf(item, m_key_current) )
1742 {
1743 m_key_current = NULL;
1744 }
1745
1746 if ( IsDescendantOf(item, m_select_me) )
1747 {
1748 m_select_me = item;
1749 }
1750
1751 if ( item != m_current && IsDescendantOf(item, m_current) )
1752 {
1753 m_current->SetHilight( false );
1754 m_current = NULL;
1755 m_select_me = item;
1756 }
1757 }
1758
1759 void wxGenericTreeCtrl::DeleteChildren(const wxTreeItemId& itemId)
1760 {
1761 m_dirty = true; // do this first so stuff below doesn't cause flicker
1762
1763 wxGenericTreeItem *item = (wxGenericTreeItem*) itemId.m_pItem;
1764 ChildrenClosing(item);
1765 item->DeleteChildren(this);
1766 InvalidateBestSize();
1767 }
1768
1769 void wxGenericTreeCtrl::Delete(const wxTreeItemId& itemId)
1770 {
1771 m_dirty = true; // do this first so stuff below doesn't cause flicker
1772
1773 wxGenericTreeItem *item = (wxGenericTreeItem*) itemId.m_pItem;
1774
1775 if (m_textCtrl != NULL && IsDescendantOf(item, m_textCtrl->item()))
1776 {
1777 // can't delete the item being edited, cancel editing it first
1778 m_textCtrl->EndEdit( true );
1779 }
1780
1781 wxGenericTreeItem *parent = item->GetParent();
1782
1783 // if the selected item will be deleted, select the parent ...
1784 wxGenericTreeItem *to_be_selected = parent;
1785 if (parent)
1786 {
1787 // .. unless there is a next sibling like wxMSW does it
1788 int pos = parent->GetChildren().Index( item );
1789 if ((int)(parent->GetChildren().GetCount()) > pos+1)
1790 to_be_selected = parent->GetChildren().Item( pos+1 );
1791 }
1792
1793 // don't keep stale pointers around!
1794 if ( IsDescendantOf(item, m_key_current) )
1795 {
1796 // Don't silently change the selection:
1797 // do it properly in idle time, so event
1798 // handlers get called.
1799
1800 // m_key_current = parent;
1801 m_key_current = NULL;
1802 }
1803
1804 // m_select_me records whether we need to select
1805 // a different item, in idle time.
1806 if ( m_select_me && IsDescendantOf(item, m_select_me) )
1807 {
1808 m_select_me = to_be_selected;
1809 }
1810
1811 if ( IsDescendantOf(item, m_current) )
1812 {
1813 // Don't silently change the selection:
1814 // do it properly in idle time, so event
1815 // handlers get called.
1816
1817 // m_current = parent;
1818 m_current = NULL;
1819 m_select_me = to_be_selected;
1820 }
1821
1822 // remove the item from the tree
1823 if ( parent )
1824 {
1825 parent->GetChildren().Remove( item ); // remove by value
1826 }
1827 else // deleting the root
1828 {
1829 // nothing will be left in the tree
1830 m_anchor = NULL;
1831 }
1832
1833 // and delete all of its children and the item itself now
1834 item->DeleteChildren(this);
1835 SendDeleteEvent(item);
1836
1837 if (item == m_select_me)
1838 m_select_me = NULL;
1839
1840 delete item;
1841
1842 InvalidateBestSize();
1843 }
1844
1845 void wxGenericTreeCtrl::DeleteAllItems()
1846 {
1847 if ( m_anchor )
1848 {
1849 Delete(m_anchor);
1850 }
1851 }
1852
1853 void wxGenericTreeCtrl::Expand(const wxTreeItemId& itemId)
1854 {
1855 wxGenericTreeItem *item = (wxGenericTreeItem*) itemId.m_pItem;
1856
1857 wxCHECK_RET( item, wxT("invalid item in wxGenericTreeCtrl::Expand") );
1858 wxCHECK_RET( !HasFlag(wxTR_HIDE_ROOT) || itemId != GetRootItem(),
1859 wxT("can't expand hidden root") );
1860
1861 if ( !item->HasPlus() )
1862 return;
1863
1864 if ( item->IsExpanded() )
1865 return;
1866
1867 wxTreeEvent event(wxEVT_COMMAND_TREE_ITEM_EXPANDING, this, item);
1868
1869 if ( GetEventHandler()->ProcessEvent( event ) && !event.IsAllowed() )
1870 {
1871 // cancelled by program
1872 return;
1873 }
1874
1875 item->Expand();
1876 if ( !IsFrozen() )
1877 {
1878 CalculatePositions();
1879
1880 RefreshSubtree(item);
1881 }
1882 else // frozen
1883 {
1884 m_dirty = true;
1885 }
1886
1887 event.SetEventType(wxEVT_COMMAND_TREE_ITEM_EXPANDED);
1888 GetEventHandler()->ProcessEvent( event );
1889 }
1890
1891 void wxGenericTreeCtrl::Collapse(const wxTreeItemId& itemId)
1892 {
1893 wxCHECK_RET( !HasFlag(wxTR_HIDE_ROOT) || itemId != GetRootItem(),
1894 wxT("can't collapse hidden root") );
1895
1896 wxGenericTreeItem *item = (wxGenericTreeItem*) itemId.m_pItem;
1897
1898 if ( !item->IsExpanded() )
1899 return;
1900
1901 wxTreeEvent event(wxEVT_COMMAND_TREE_ITEM_COLLAPSING, this, item);
1902 if ( GetEventHandler()->ProcessEvent( event ) && !event.IsAllowed() )
1903 {
1904 // cancelled by program
1905 return;
1906 }
1907
1908 ChildrenClosing(item);
1909 item->Collapse();
1910
1911 #if 0 // TODO why should items be collapsed recursively?
1912 wxArrayGenericTreeItems& children = item->GetChildren();
1913 size_t count = children.GetCount();
1914 for ( size_t n = 0; n < count; n++ )
1915 {
1916 Collapse(children[n]);
1917 }
1918 #endif
1919
1920 CalculatePositions();
1921
1922 RefreshSubtree(item);
1923
1924 event.SetEventType(wxEVT_COMMAND_TREE_ITEM_COLLAPSED);
1925 GetEventHandler()->ProcessEvent( event );
1926 }
1927
1928 void wxGenericTreeCtrl::CollapseAndReset(const wxTreeItemId& item)
1929 {
1930 Collapse(item);
1931 DeleteChildren(item);
1932 }
1933
1934 void wxGenericTreeCtrl::Toggle(const wxTreeItemId& itemId)
1935 {
1936 wxGenericTreeItem *item = (wxGenericTreeItem*) itemId.m_pItem;
1937
1938 if (item->IsExpanded())
1939 Collapse(itemId);
1940 else
1941 Expand(itemId);
1942 }
1943
1944 void wxGenericTreeCtrl::Unselect()
1945 {
1946 if (m_current)
1947 {
1948 m_current->SetHilight( false );
1949 RefreshLine( m_current );
1950
1951 m_current = NULL;
1952 m_select_me = NULL;
1953 }
1954 }
1955
1956 void wxGenericTreeCtrl::ClearFocusedItem()
1957 {
1958 wxTreeItemId item = GetFocusedItem();
1959 if ( item.IsOk() )
1960 SelectItem(item, false);
1961 }
1962
1963 void wxGenericTreeCtrl::SetFocusedItem(const wxTreeItemId& item)
1964 {
1965 wxCHECK_RET( item.IsOk(), wxT("invalid tree item") );
1966
1967 SelectItem(item, true);
1968 }
1969
1970 void wxGenericTreeCtrl::UnselectAllChildren(wxGenericTreeItem *item)
1971 {
1972 if (item->IsSelected())
1973 {
1974 item->SetHilight(false);
1975 RefreshLine(item);
1976 }
1977
1978 if (item->HasChildren())
1979 {
1980 wxArrayGenericTreeItems& children = item->GetChildren();
1981 size_t count = children.GetCount();
1982 for ( size_t n = 0; n < count; ++n )
1983 {
1984 UnselectAllChildren(children[n]);
1985 }
1986 }
1987 }
1988
1989 void wxGenericTreeCtrl::UnselectAll()
1990 {
1991 wxTreeItemId rootItem = GetRootItem();
1992
1993 // the tree might not have the root item at all
1994 if ( rootItem )
1995 {
1996 UnselectAllChildren((wxGenericTreeItem*) rootItem.m_pItem);
1997 }
1998 }
1999
2000 void wxGenericTreeCtrl::SelectChildren(const wxTreeItemId& parent)
2001 {
2002 wxCHECK_RET( HasFlag(wxTR_MULTIPLE),
2003 "this only works with multiple selection controls" );
2004
2005 UnselectAll();
2006
2007 if ( !HasChildren(parent) )
2008 return;
2009
2010
2011 wxArrayGenericTreeItems&
2012 children = ((wxGenericTreeItem*) parent.m_pItem)->GetChildren();
2013 size_t count = children.GetCount();
2014
2015 wxGenericTreeItem *
2016 item = (wxGenericTreeItem*) ((wxTreeItemId)children[0]).m_pItem;
2017 wxTreeEvent event(wxEVT_COMMAND_TREE_SEL_CHANGING, this, item);
2018 event.m_itemOld = m_current;
2019
2020 if ( GetEventHandler()->ProcessEvent( event ) && !event.IsAllowed() )
2021 return;
2022
2023 for ( size_t n = 0; n < count; ++n )
2024 {
2025 m_current = m_key_current = children[n];
2026 m_current->SetHilight(true);
2027 RefreshSelected();
2028 }
2029
2030
2031 event.SetEventType(wxEVT_COMMAND_TREE_SEL_CHANGED);
2032 GetEventHandler()->ProcessEvent( event );
2033 }
2034
2035
2036 // Recursive function !
2037 // To stop we must have crt_item<last_item
2038 // Algorithm :
2039 // Tag all next children, when no more children,
2040 // Move to parent (not to tag)
2041 // Keep going... if we found last_item, we stop.
2042 bool
2043 wxGenericTreeCtrl::TagNextChildren(wxGenericTreeItem *crt_item,
2044 wxGenericTreeItem *last_item,
2045 bool select)
2046 {
2047 wxGenericTreeItem *parent = crt_item->GetParent();
2048
2049 if (parent == NULL) // This is root item
2050 return TagAllChildrenUntilLast(crt_item, last_item, select);
2051
2052 wxArrayGenericTreeItems& children = parent->GetChildren();
2053 int index = children.Index(crt_item);
2054 wxASSERT( index != wxNOT_FOUND ); // I'm not a child of my parent?
2055
2056 size_t count = children.GetCount();
2057 for (size_t n=(size_t)(index+1); n<count; ++n)
2058 {
2059 if ( TagAllChildrenUntilLast(children[n], last_item, select) )
2060 return true;
2061 }
2062
2063 return TagNextChildren(parent, last_item, select);
2064 }
2065
2066 bool
2067 wxGenericTreeCtrl::TagAllChildrenUntilLast(wxGenericTreeItem *crt_item,
2068 wxGenericTreeItem *last_item,
2069 bool select)
2070 {
2071 crt_item->SetHilight(select);
2072 RefreshLine(crt_item);
2073
2074 if (crt_item==last_item)
2075 return true;
2076
2077 if (crt_item->HasChildren())
2078 {
2079 wxArrayGenericTreeItems& children = crt_item->GetChildren();
2080 size_t count = children.GetCount();
2081 for ( size_t n = 0; n < count; ++n )
2082 {
2083 if (TagAllChildrenUntilLast(children[n], last_item, select))
2084 return true;
2085 }
2086 }
2087
2088 return false;
2089 }
2090
2091 void
2092 wxGenericTreeCtrl::SelectItemRange(wxGenericTreeItem *item1,
2093 wxGenericTreeItem *item2)
2094 {
2095 m_select_me = NULL;
2096
2097 // item2 is not necessary after item1
2098 // choice first' and 'last' between item1 and item2
2099 wxGenericTreeItem *first= (item1->GetY()<item2->GetY()) ? item1 : item2;
2100 wxGenericTreeItem *last = (item1->GetY()<item2->GetY()) ? item2 : item1;
2101
2102 bool select = m_current->IsSelected();
2103
2104 if ( TagAllChildrenUntilLast(first,last,select) )
2105 return;
2106
2107 TagNextChildren(first,last,select);
2108 }
2109
2110 void wxGenericTreeCtrl::DoSelectItem(const wxTreeItemId& itemId,
2111 bool unselect_others,
2112 bool extended_select)
2113 {
2114 wxCHECK_RET( itemId.IsOk(), wxT("invalid tree item") );
2115
2116 m_select_me = NULL;
2117
2118 bool is_single=!(GetWindowStyleFlag() & wxTR_MULTIPLE);
2119 wxGenericTreeItem *item = (wxGenericTreeItem*) itemId.m_pItem;
2120
2121 //wxCHECK_RET( ( (!unselect_others) && is_single),
2122 // wxT("this is a single selection tree") );
2123
2124 // to keep going anyhow !!!
2125 if (is_single)
2126 {
2127 if (item->IsSelected())
2128 return; // nothing to do
2129 unselect_others = true;
2130 extended_select = false;
2131 }
2132 else if ( unselect_others && item->IsSelected() )
2133 {
2134 // selection change if there is more than one item currently selected
2135 wxArrayTreeItemIds selected_items;
2136 if ( GetSelections(selected_items) == 1 )
2137 return;
2138 }
2139
2140 wxTreeEvent event(wxEVT_COMMAND_TREE_SEL_CHANGING, this, item);
2141 event.m_itemOld = m_current;
2142 // TODO : Here we don't send any selection mode yet !
2143
2144 if ( GetEventHandler()->ProcessEvent( event ) && !event.IsAllowed() )
2145 return;
2146
2147 wxTreeItemId parent = GetItemParent( itemId );
2148 while (parent.IsOk())
2149 {
2150 if (!IsExpanded(parent))
2151 Expand( parent );
2152
2153 parent = GetItemParent( parent );
2154 }
2155
2156 // ctrl press
2157 if (unselect_others)
2158 {
2159 if (is_single) Unselect(); // to speed up thing
2160 else UnselectAll();
2161 }
2162
2163 // shift press
2164 if (extended_select)
2165 {
2166 if ( !m_current )
2167 {
2168 m_current =
2169 m_key_current = (wxGenericTreeItem*) GetRootItem().m_pItem;
2170 }
2171
2172 // don't change the mark (m_current)
2173 SelectItemRange(m_current, item);
2174 }
2175 else
2176 {
2177 bool select = true; // the default
2178
2179 // Check if we need to toggle hilight (ctrl mode)
2180 if (!unselect_others)
2181 select=!item->IsSelected();
2182
2183 m_current = m_key_current = item;
2184 m_current->SetHilight(select);
2185 RefreshLine( m_current );
2186 }
2187
2188 // This can cause idle processing to select the root
2189 // if no item is selected, so it must be after the
2190 // selection is set
2191 EnsureVisible( itemId );
2192
2193 event.SetEventType(wxEVT_COMMAND_TREE_SEL_CHANGED);
2194 GetEventHandler()->ProcessEvent( event );
2195 }
2196
2197 void wxGenericTreeCtrl::SelectItem(const wxTreeItemId& itemId, bool select)
2198 {
2199 wxGenericTreeItem * const item = (wxGenericTreeItem*) itemId.m_pItem;
2200 wxCHECK_RET( item, wxT("SelectItem(): invalid tree item") );
2201
2202 if ( select )
2203 {
2204 if ( !item->IsSelected() )
2205 DoSelectItem(itemId, !HasFlag(wxTR_MULTIPLE));
2206 }
2207 else // deselect
2208 {
2209 wxTreeEvent event(wxEVT_COMMAND_TREE_SEL_CHANGING, this, item);
2210 if ( GetEventHandler()->ProcessEvent( event ) && !event.IsAllowed() )
2211 return;
2212
2213 item->SetHilight(false);
2214 RefreshLine(item);
2215
2216 event.SetEventType(wxEVT_COMMAND_TREE_SEL_CHANGED);
2217 GetEventHandler()->ProcessEvent( event );
2218 }
2219 }
2220
2221 void wxGenericTreeCtrl::FillArray(wxGenericTreeItem *item,
2222 wxArrayTreeItemIds &array) const
2223 {
2224 if ( item->IsSelected() )
2225 array.Add(wxTreeItemId(item));
2226
2227 if ( item->HasChildren() )
2228 {
2229 wxArrayGenericTreeItems& children = item->GetChildren();
2230 size_t count = children.GetCount();
2231 for ( size_t n = 0; n < count; ++n )
2232 FillArray(children[n], array);
2233 }
2234 }
2235
2236 size_t wxGenericTreeCtrl::GetSelections(wxArrayTreeItemIds &array) const
2237 {
2238 array.Empty();
2239 wxTreeItemId idRoot = GetRootItem();
2240 if ( idRoot.IsOk() )
2241 {
2242 FillArray((wxGenericTreeItem*) idRoot.m_pItem, array);
2243 }
2244 //else: the tree is empty, so no selections
2245
2246 return array.GetCount();
2247 }
2248
2249 void wxGenericTreeCtrl::EnsureVisible(const wxTreeItemId& item)
2250 {
2251 wxCHECK_RET( item.IsOk(), wxT("invalid tree item") );
2252
2253 if (!item.IsOk()) return;
2254
2255 wxGenericTreeItem *gitem = (wxGenericTreeItem*) item.m_pItem;
2256
2257 // first expand all parent branches
2258 wxGenericTreeItem *parent = gitem->GetParent();
2259
2260 if ( HasFlag(wxTR_HIDE_ROOT) )
2261 {
2262 while ( parent && parent != m_anchor )
2263 {
2264 Expand(parent);
2265 parent = parent->GetParent();
2266 }
2267 }
2268 else
2269 {
2270 while ( parent )
2271 {
2272 Expand(parent);
2273 parent = parent->GetParent();
2274 }
2275 }
2276
2277 //if (parent) CalculatePositions();
2278
2279 ScrollTo(item);
2280 }
2281
2282 void wxGenericTreeCtrl::ScrollTo(const wxTreeItemId &item)
2283 {
2284 if (!item.IsOk())
2285 return;
2286
2287 // update the control before scrolling it
2288 if (m_dirty)
2289 #if defined( __WXMSW__ ) || defined(__WXMAC__)
2290 Update();
2291 #else
2292 DoDirtyProcessing();
2293 #endif
2294
2295 wxGenericTreeItem *gitem = (wxGenericTreeItem*) item.m_pItem;
2296
2297 int itemY = gitem->GetY();
2298
2299 int start_x = 0;
2300 int start_y = 0;
2301 GetViewStart( &start_x, &start_y );
2302
2303 const int clientHeight = GetClientSize().y;
2304
2305 const int itemHeight = GetLineHeight(gitem) + 2;
2306
2307 if ( itemY + itemHeight > start_y*PIXELS_PER_UNIT + clientHeight )
2308 {
2309 // need to scroll up by enough to show this item fully
2310 itemY += itemHeight - clientHeight;
2311 }
2312 else if ( itemY > start_y*PIXELS_PER_UNIT )
2313 {
2314 // item is already fully visible, don't do anything
2315 return;
2316 }
2317 //else: scroll down to make this item the top one displayed
2318
2319 Scroll(-1, itemY/PIXELS_PER_UNIT);
2320 }
2321
2322 // FIXME: tree sorting functions are not reentrant and not MT-safe!
2323 static wxGenericTreeCtrl *s_treeBeingSorted = NULL;
2324
2325 static int LINKAGEMODE tree_ctrl_compare_func(wxGenericTreeItem **item1,
2326 wxGenericTreeItem **item2)
2327 {
2328 wxCHECK_MSG( s_treeBeingSorted, 0,
2329 "bug in wxGenericTreeCtrl::SortChildren()" );
2330
2331 return s_treeBeingSorted->OnCompareItems(*item1, *item2);
2332 }
2333
2334 void wxGenericTreeCtrl::SortChildren(const wxTreeItemId& itemId)
2335 {
2336 wxCHECK_RET( itemId.IsOk(), wxT("invalid tree item") );
2337
2338 wxGenericTreeItem *item = (wxGenericTreeItem*) itemId.m_pItem;
2339
2340 wxCHECK_RET( !s_treeBeingSorted,
2341 wxT("wxGenericTreeCtrl::SortChildren is not reentrant") );
2342
2343 wxArrayGenericTreeItems& children = item->GetChildren();
2344 if ( children.GetCount() > 1 )
2345 {
2346 m_dirty = true;
2347
2348 s_treeBeingSorted = this;
2349 children.Sort(tree_ctrl_compare_func);
2350 s_treeBeingSorted = NULL;
2351 }
2352 //else: don't make the tree dirty as nothing changed
2353 }
2354
2355 void wxGenericTreeCtrl::CalculateLineHeight()
2356 {
2357 wxClientDC dc(this);
2358 m_lineHeight = (int)(dc.GetCharHeight() + 4);
2359
2360 if ( m_imageListNormal )
2361 {
2362 // Calculate a m_lineHeight value from the normal Image sizes.
2363 // May be toggle off. Then wxGenericTreeCtrl will spread when
2364 // necessary (which might look ugly).
2365 int n = m_imageListNormal->GetImageCount();
2366 for (int i = 0; i < n ; i++)
2367 {
2368 int width = 0, height = 0;
2369 m_imageListNormal->GetSize(i, width, height);
2370 if (height > m_lineHeight) m_lineHeight = height;
2371 }
2372 }
2373
2374 if ( m_imageListState )
2375 {
2376 // Calculate a m_lineHeight value from the state Image sizes.
2377 // May be toggle off. Then wxGenericTreeCtrl will spread when
2378 // necessary (which might look ugly).
2379 int n = m_imageListState->GetImageCount();
2380 for (int i = 0; i < n ; i++)
2381 {
2382 int width = 0, height = 0;
2383 m_imageListState->GetSize(i, width, height);
2384 if (height > m_lineHeight) m_lineHeight = height;
2385 }
2386 }
2387
2388 if (m_imageListButtons)
2389 {
2390 // Calculate a m_lineHeight value from the Button image sizes.
2391 // May be toggle off. Then wxGenericTreeCtrl will spread when
2392 // necessary (which might look ugly).
2393 int n = m_imageListButtons->GetImageCount();
2394 for (int i = 0; i < n ; i++)
2395 {
2396 int width = 0, height = 0;
2397 m_imageListButtons->GetSize(i, width, height);
2398 if (height > m_lineHeight) m_lineHeight = height;
2399 }
2400 }
2401
2402 if (m_lineHeight < 30)
2403 m_lineHeight += 2; // at least 2 pixels
2404 else
2405 m_lineHeight += m_lineHeight/10; // otherwise 10% extra spacing
2406 }
2407
2408 void wxGenericTreeCtrl::SetImageList(wxImageList *imageList)
2409 {
2410 if (m_ownsImageListNormal) delete m_imageListNormal;
2411 m_imageListNormal = imageList;
2412 m_ownsImageListNormal = false;
2413 m_dirty = true;
2414
2415 if (m_anchor)
2416 m_anchor->RecursiveResetSize();
2417
2418 // Don't do any drawing if we're setting the list to NULL,
2419 // since we may be in the process of deleting the tree control.
2420 if (imageList)
2421 CalculateLineHeight();
2422 }
2423
2424 void wxGenericTreeCtrl::SetStateImageList(wxImageList *imageList)
2425 {
2426 if (m_ownsImageListState) delete m_imageListState;
2427 m_imageListState = imageList;
2428 m_ownsImageListState = false;
2429 m_dirty = true;
2430
2431 if (m_anchor)
2432 m_anchor->RecursiveResetSize();
2433
2434 // Don't do any drawing if we're setting the list to NULL,
2435 // since we may be in the process of deleting the tree control.
2436 if (imageList)
2437 CalculateLineHeight();
2438 }
2439
2440 void wxGenericTreeCtrl::SetButtonsImageList(wxImageList *imageList)
2441 {
2442 if (m_ownsImageListButtons) delete m_imageListButtons;
2443 m_imageListButtons = imageList;
2444 m_ownsImageListButtons = false;
2445 m_dirty = true;
2446
2447 if (m_anchor)
2448 m_anchor->RecursiveResetSize();
2449
2450 CalculateLineHeight();
2451 }
2452
2453 void wxGenericTreeCtrl::AssignButtonsImageList(wxImageList *imageList)
2454 {
2455 SetButtonsImageList(imageList);
2456 m_ownsImageListButtons = true;
2457 }
2458
2459 // -----------------------------------------------------------------------------
2460 // helpers
2461 // -----------------------------------------------------------------------------
2462
2463 void wxGenericTreeCtrl::AdjustMyScrollbars()
2464 {
2465 if (m_anchor)
2466 {
2467 int x = 0, y = 0;
2468 m_anchor->GetSize( x, y, this );
2469 y += PIXELS_PER_UNIT+2; // one more scrollbar unit + 2 pixels
2470 x += PIXELS_PER_UNIT+2; // one more scrollbar unit + 2 pixels
2471 int x_pos = GetScrollPos( wxHORIZONTAL );
2472 int y_pos = GetScrollPos( wxVERTICAL );
2473 SetScrollbars( PIXELS_PER_UNIT, PIXELS_PER_UNIT,
2474 x/PIXELS_PER_UNIT, y/PIXELS_PER_UNIT,
2475 x_pos, y_pos );
2476 }
2477 else
2478 {
2479 SetScrollbars( 0, 0, 0, 0 );
2480 }
2481 }
2482
2483 int wxGenericTreeCtrl::GetLineHeight(wxGenericTreeItem *item) const
2484 {
2485 if (GetWindowStyleFlag() & wxTR_HAS_VARIABLE_ROW_HEIGHT)
2486 return item->GetHeight();
2487 else
2488 return m_lineHeight;
2489 }
2490
2491 void wxGenericTreeCtrl::PaintItem(wxGenericTreeItem *item, wxDC& dc)
2492 {
2493 item->SetFont(this, dc);
2494 item->CalculateSize(this, dc);
2495
2496 wxCoord text_h = item->GetTextHeight();
2497
2498 int image_h = 0, image_w = 0;
2499 int image = item->GetCurrentImage();
2500 if ( image != NO_IMAGE )
2501 {
2502 if ( m_imageListNormal )
2503 {
2504 m_imageListNormal->GetSize(image, image_w, image_h);
2505 image_w += MARGIN_BETWEEN_IMAGE_AND_TEXT;
2506 }
2507 else
2508 {
2509 image = NO_IMAGE;
2510 }
2511 }
2512
2513 int state_h = 0, state_w = 0;
2514 int state = item->GetState();
2515 if ( state != wxTREE_ITEMSTATE_NONE )
2516 {
2517 if ( m_imageListState )
2518 {
2519 m_imageListState->GetSize(state, state_w, state_h);
2520 if ( image_w != 0 )
2521 state_w += MARGIN_BETWEEN_STATE_AND_IMAGE;
2522 else
2523 state_w += MARGIN_BETWEEN_IMAGE_AND_TEXT;
2524 }
2525 else
2526 {
2527 state = wxTREE_ITEMSTATE_NONE;
2528 }
2529 }
2530
2531 int total_h = GetLineHeight(item);
2532 bool drawItemBackground = false,
2533 hasBgColour = false;
2534
2535 if ( item->IsSelected() )
2536 {
2537 dc.SetBrush(*(m_hasFocus ? m_hilightBrush : m_hilightUnfocusedBrush));
2538 drawItemBackground = true;
2539 }
2540 else
2541 {
2542 wxColour colBg;
2543 wxTreeItemAttr * const attr = item->GetAttributes();
2544 if ( attr && attr->HasBackgroundColour() )
2545 {
2546 drawItemBackground =
2547 hasBgColour = true;
2548 colBg = attr->GetBackgroundColour();
2549 }
2550 else
2551 {
2552 colBg = GetBackgroundColour();
2553 }
2554 dc.SetBrush(wxBrush(colBg, wxBRUSHSTYLE_SOLID));
2555 }
2556
2557 int offset = HasFlag(wxTR_ROW_LINES) ? 1 : 0;
2558
2559 if ( HasFlag(wxTR_FULL_ROW_HIGHLIGHT) )
2560 {
2561 int x, w, h;
2562 x=0;
2563 GetVirtualSize(&w, &h);
2564 wxRect rect( x, item->GetY()+offset, w, total_h-offset);
2565 if (!item->IsSelected())
2566 {
2567 dc.DrawRectangle(rect);
2568 }
2569 else
2570 {
2571 int flags = wxCONTROL_SELECTED;
2572 if (m_hasFocus
2573 #if defined( __WXMAC__ ) && !defined(__WXUNIVERSAL__) && wxOSX_USE_CARBON // TODO CS
2574 && IsControlActive( (ControlRef)GetHandle() )
2575 #endif
2576 )
2577 flags |= wxCONTROL_FOCUSED;
2578 if ((item == m_current) && (m_hasFocus))
2579 flags |= wxCONTROL_CURRENT;
2580
2581 wxRendererNative::Get().
2582 DrawItemSelectionRect(this, dc, rect, flags);
2583 }
2584 }
2585 else // no full row highlight
2586 {
2587 if ( item->IsSelected() &&
2588 (state != wxTREE_ITEMSTATE_NONE || image != NO_IMAGE) )
2589 {
2590 // If it's selected, and there's an state image or normal image,
2591 // then we should take care to leave the area under the image
2592 // painted in the background colour.
2593 wxRect rect( item->GetX() + state_w + image_w - 2,
2594 item->GetY() + offset,
2595 item->GetWidth() - state_w - image_w + 2,
2596 total_h - offset );
2597 #if !defined(__WXGTK20__) && !defined(__WXMAC__)
2598 dc.DrawRectangle( rect );
2599 #else
2600 rect.x -= 1;
2601 rect.width += 2;
2602
2603 int flags = wxCONTROL_SELECTED;
2604 if (m_hasFocus)
2605 flags |= wxCONTROL_FOCUSED;
2606 if ((item == m_current) && (m_hasFocus))
2607 flags |= wxCONTROL_CURRENT;
2608 wxRendererNative::Get().
2609 DrawItemSelectionRect(this, dc, rect, flags);
2610 #endif
2611 }
2612 // On GTK+ 2, drawing a 'normal' background is wrong for themes that
2613 // don't allow backgrounds to be customized. Not drawing the background,
2614 // except for custom item backgrounds, works for both kinds of theme.
2615 else if (drawItemBackground)
2616 {
2617 wxRect rect( item->GetX() + state_w + image_w - 2,
2618 item->GetY() + offset,
2619 item->GetWidth() - state_w - image_w + 2,
2620 total_h - offset );
2621 if ( hasBgColour )
2622 {
2623 dc.DrawRectangle( rect );
2624 }
2625 else // no specific background colour
2626 {
2627 rect.x -= 1;
2628 rect.width += 2;
2629
2630 int flags = wxCONTROL_SELECTED;
2631 if (m_hasFocus)
2632 flags |= wxCONTROL_FOCUSED;
2633 if ((item == m_current) && (m_hasFocus))
2634 flags |= wxCONTROL_CURRENT;
2635 wxRendererNative::Get().
2636 DrawItemSelectionRect(this, dc, rect, flags);
2637 }
2638 }
2639 }
2640
2641 if ( state != wxTREE_ITEMSTATE_NONE )
2642 {
2643 dc.SetClippingRegion( item->GetX(), item->GetY(), state_w, total_h );
2644 m_imageListState->Draw( state, dc,
2645 item->GetX(),
2646 item->GetY() +
2647 (total_h > state_h ? (total_h-state_h)/2
2648 : 0),
2649 wxIMAGELIST_DRAW_TRANSPARENT );
2650 dc.DestroyClippingRegion();
2651 }
2652
2653 if ( image != NO_IMAGE )
2654 {
2655 dc.SetClippingRegion(item->GetX() + state_w, item->GetY(),
2656 image_w, total_h);
2657 m_imageListNormal->Draw( image, dc,
2658 item->GetX() + state_w,
2659 item->GetY() +
2660 (total_h > image_h ? (total_h-image_h)/2
2661 : 0),
2662 wxIMAGELIST_DRAW_TRANSPARENT );
2663 dc.DestroyClippingRegion();
2664 }
2665
2666 dc.SetBackgroundMode(wxBRUSHSTYLE_TRANSPARENT);
2667 int extraH = (total_h > text_h) ? (total_h - text_h)/2 : 0;
2668 dc.DrawText( item->GetText(),
2669 (wxCoord)(state_w + image_w + item->GetX()),
2670 (wxCoord)(item->GetY() + extraH));
2671
2672 // restore normal font
2673 dc.SetFont( m_normalFont );
2674
2675 if (item == m_dndEffectItem)
2676 {
2677 dc.SetPen( *wxBLACK_PEN );
2678 // DnD visual effects
2679 switch (m_dndEffect)
2680 {
2681 case BorderEffect:
2682 {
2683 dc.SetBrush(*wxTRANSPARENT_BRUSH);
2684 int w = item->GetWidth() + 2;
2685 int h = total_h + 2;
2686 dc.DrawRectangle( item->GetX() - 1, item->GetY() - 1, w, h);
2687 break;
2688 }
2689 case AboveEffect:
2690 {
2691 int x = item->GetX(),
2692 y = item->GetY();
2693 dc.DrawLine( x, y, x + item->GetWidth(), y);
2694 break;
2695 }
2696 case BelowEffect:
2697 {
2698 int x = item->GetX(),
2699 y = item->GetY();
2700 y += total_h - 1;
2701 dc.DrawLine( x, y, x + item->GetWidth(), y);
2702 break;
2703 }
2704 case NoEffect:
2705 break;
2706 }
2707 }
2708 }
2709
2710 void
2711 wxGenericTreeCtrl::PaintLevel(wxGenericTreeItem *item,
2712 wxDC &dc,
2713 int level,
2714 int &y)
2715 {
2716 int x = level*m_indent;
2717 if (!HasFlag(wxTR_HIDE_ROOT))
2718 {
2719 x += m_indent;
2720 }
2721 else if (level == 0)
2722 {
2723 // always expand hidden root
2724 int origY = y;
2725 wxArrayGenericTreeItems& children = item->GetChildren();
2726 int count = children.GetCount();
2727 if (count > 0)
2728 {
2729 int n = 0, oldY;
2730 do {
2731 oldY = y;
2732 PaintLevel(children[n], dc, 1, y);
2733 } while (++n < count);
2734
2735 if ( !HasFlag(wxTR_NO_LINES) && HasFlag(wxTR_LINES_AT_ROOT)
2736 && count > 0 )
2737 {
2738 // draw line down to last child
2739 origY += GetLineHeight(children[0])>>1;
2740 oldY += GetLineHeight(children[n-1])>>1;
2741 dc.DrawLine(3, origY, 3, oldY);
2742 }
2743 }
2744 return;
2745 }
2746
2747 item->SetX(x+m_spacing);
2748 item->SetY(y);
2749
2750 int h = GetLineHeight(item);
2751 int y_top = y;
2752 int y_mid = y_top + (h>>1);
2753 y += h;
2754
2755 int exposed_x = dc.LogicalToDeviceX(0);
2756 int exposed_y = dc.LogicalToDeviceY(y_top);
2757
2758 if (IsExposed(exposed_x, exposed_y, 10000, h)) // 10000 = very much
2759 {
2760 const wxPen *pen =
2761 #ifndef __WXMAC__
2762 // don't draw rect outline if we already have the
2763 // background color under Mac
2764 (item->IsSelected() && m_hasFocus) ? wxBLACK_PEN :
2765 #endif // !__WXMAC__
2766 wxTRANSPARENT_PEN;
2767
2768 wxColour colText;
2769 if ( item->IsSelected()
2770 #if defined( __WXMAC__ ) && !defined(__WXUNIVERSAL__) && wxOSX_USE_CARBON // TODO CS
2771 // On wxMac, if the tree doesn't have the focus we draw an empty
2772 // rectangle, so we want to make sure that the text is visible
2773 // against the normal background, not the highlightbackground, so
2774 // don't use the highlight text colour unless we have the focus.
2775 && m_hasFocus && IsControlActive( (ControlRef)GetHandle() )
2776 #endif
2777 )
2778 {
2779 #ifdef __WXMAC__
2780 colText = *wxWHITE;
2781 #else
2782 colText = wxSystemSettings::GetColour(wxSYS_COLOUR_HIGHLIGHTTEXT);
2783 #endif
2784 }
2785 else
2786 {
2787 wxTreeItemAttr *attr = item->GetAttributes();
2788 if (attr && attr->HasTextColour())
2789 colText = attr->GetTextColour();
2790 else
2791 colText = GetForegroundColour();
2792 }
2793
2794 // prepare to draw
2795 dc.SetTextForeground(colText);
2796 dc.SetPen(*pen);
2797
2798 // draw
2799 PaintItem(item, dc);
2800
2801 if (HasFlag(wxTR_ROW_LINES))
2802 {
2803 // if the background colour is white, choose a
2804 // contrasting color for the lines
2805 dc.SetPen(*((GetBackgroundColour() == *wxWHITE)
2806 ? wxMEDIUM_GREY_PEN : wxWHITE_PEN));
2807 dc.DrawLine(0, y_top, 10000, y_top);
2808 dc.DrawLine(0, y, 10000, y);
2809 }
2810
2811 // restore DC objects
2812 dc.SetBrush(*wxWHITE_BRUSH);
2813 dc.SetPen(m_dottedPen);
2814 dc.SetTextForeground(*wxBLACK);
2815
2816 if ( !HasFlag(wxTR_NO_LINES) )
2817 {
2818 // draw the horizontal line here
2819 int x_start = x;
2820 if (x > (signed)m_indent)
2821 x_start -= m_indent;
2822 else if (HasFlag(wxTR_LINES_AT_ROOT))
2823 x_start = 3;
2824 dc.DrawLine(x_start, y_mid, x + m_spacing, y_mid);
2825 }
2826
2827 // should the item show a button?
2828 if ( item->HasPlus() && HasButtons() )
2829 {
2830 if ( m_imageListButtons )
2831 {
2832 // draw the image button here
2833 int image_h = 0,
2834 image_w = 0;
2835 int image = item->IsExpanded() ? wxTreeItemIcon_Expanded
2836 : wxTreeItemIcon_Normal;
2837 if ( item->IsSelected() )
2838 image += wxTreeItemIcon_Selected - wxTreeItemIcon_Normal;
2839
2840 m_imageListButtons->GetSize(image, image_w, image_h);
2841 int xx = x - image_w/2;
2842 int yy = y_mid - image_h/2;
2843
2844 wxDCClipper clip(dc, xx, yy, image_w, image_h);
2845 m_imageListButtons->Draw(image, dc, xx, yy,
2846 wxIMAGELIST_DRAW_TRANSPARENT);
2847 }
2848 else // no custom buttons
2849 {
2850 static const int wImage = 9;
2851 static const int hImage = 9;
2852
2853 int flag = 0;
2854 if (item->IsExpanded())
2855 flag |= wxCONTROL_EXPANDED;
2856 if (item == m_underMouse)
2857 flag |= wxCONTROL_CURRENT;
2858
2859 wxRendererNative::Get().DrawTreeItemButton
2860 (
2861 this,
2862 dc,
2863 wxRect(x - wImage/2,
2864 y_mid - hImage/2,
2865 wImage, hImage),
2866 flag
2867 );
2868 }
2869 }
2870 }
2871
2872 if (item->IsExpanded())
2873 {
2874 wxArrayGenericTreeItems& children = item->GetChildren();
2875 int count = children.GetCount();
2876 if (count > 0)
2877 {
2878 int n = 0, oldY;
2879 ++level;
2880 do {
2881 oldY = y;
2882 PaintLevel(children[n], dc, level, y);
2883 } while (++n < count);
2884
2885 if (!HasFlag(wxTR_NO_LINES) && count > 0)
2886 {
2887 // draw line down to last child
2888 oldY += GetLineHeight(children[n-1])>>1;
2889 if (HasButtons()) y_mid += 5;
2890
2891 // Only draw the portion of the line that is visible, in case
2892 // it is huge
2893 wxCoord xOrigin=0, yOrigin=0, width, height;
2894 dc.GetDeviceOrigin(&xOrigin, &yOrigin);
2895 yOrigin = abs(yOrigin);
2896 GetClientSize(&width, &height);
2897
2898 // Move end points to the begining/end of the view?
2899 if (y_mid < yOrigin)
2900 y_mid = yOrigin;
2901 if (oldY > yOrigin + height)
2902 oldY = yOrigin + height;
2903
2904 // after the adjustments if y_mid is larger than oldY then the
2905 // line isn't visible at all so don't draw anything
2906 if (y_mid < oldY)
2907 dc.DrawLine(x, y_mid, x, oldY);
2908 }
2909 }
2910 }
2911 }
2912
2913 void wxGenericTreeCtrl::DrawDropEffect(wxGenericTreeItem *item)
2914 {
2915 if ( item )
2916 {
2917 if ( item->HasPlus() )
2918 {
2919 // it's a folder, indicate it by a border
2920 DrawBorder(item);
2921 }
2922 else
2923 {
2924 // draw a line under the drop target because the item will be
2925 // dropped there
2926 DrawLine(item, !m_dropEffectAboveItem );
2927 }
2928
2929 SetCursor(*wxSTANDARD_CURSOR);
2930 }
2931 else
2932 {
2933 // can't drop here
2934 SetCursor(wxCURSOR_NO_ENTRY);
2935 }
2936 }
2937
2938 void wxGenericTreeCtrl::DrawBorder(const wxTreeItemId &item)
2939 {
2940 wxCHECK_RET( item.IsOk(), "invalid item in wxGenericTreeCtrl::DrawLine" );
2941
2942 wxGenericTreeItem *i = (wxGenericTreeItem*) item.m_pItem;
2943
2944 if (m_dndEffect == NoEffect)
2945 {
2946 m_dndEffect = BorderEffect;
2947 m_dndEffectItem = i;
2948 }
2949 else
2950 {
2951 m_dndEffect = NoEffect;
2952 m_dndEffectItem = NULL;
2953 }
2954
2955 wxRect rect( i->GetX()-1, i->GetY()-1, i->GetWidth()+2, GetLineHeight(i)+2 );
2956 CalcScrolledPosition( rect.x, rect.y, &rect.x, &rect.y );
2957 RefreshRect( rect );
2958 }
2959
2960 void wxGenericTreeCtrl::DrawLine(const wxTreeItemId &item, bool below)
2961 {
2962 wxCHECK_RET( item.IsOk(), "invalid item in wxGenericTreeCtrl::DrawLine" );
2963
2964 wxGenericTreeItem *i = (wxGenericTreeItem*) item.m_pItem;
2965
2966 if (m_dndEffect == NoEffect)
2967 {
2968 if (below)
2969 m_dndEffect = BelowEffect;
2970 else
2971 m_dndEffect = AboveEffect;
2972 m_dndEffectItem = i;
2973 }
2974 else
2975 {
2976 m_dndEffect = NoEffect;
2977 m_dndEffectItem = NULL;
2978 }
2979
2980 wxRect rect( i->GetX()-1, i->GetY()-1, i->GetWidth()+2, GetLineHeight(i)+2 );
2981 CalcScrolledPosition( rect.x, rect.y, &rect.x, &rect.y );
2982 RefreshRect( rect );
2983 }
2984
2985 // -----------------------------------------------------------------------------
2986 // wxWidgets callbacks
2987 // -----------------------------------------------------------------------------
2988
2989 void wxGenericTreeCtrl::OnSize( wxSizeEvent &event )
2990 {
2991 #ifdef __WXGTK__
2992 if (HasFlag( wxTR_FULL_ROW_HIGHLIGHT) && m_current)
2993 RefreshLine( m_current );
2994 #endif
2995
2996 event.Skip(true);
2997 }
2998
2999 void wxGenericTreeCtrl::OnPaint( wxPaintEvent &WXUNUSED(event) )
3000 {
3001 wxPaintDC dc(this);
3002 PrepareDC( dc );
3003
3004 if ( !m_anchor)
3005 return;
3006
3007 dc.SetFont( m_normalFont );
3008 dc.SetPen( m_dottedPen );
3009
3010 // this is now done dynamically
3011 //if(GetImageList() == NULL)
3012 // m_lineHeight = (int)(dc.GetCharHeight() + 4);
3013
3014 int y = 2;
3015 PaintLevel( m_anchor, dc, 0, y );
3016 }
3017
3018 void wxGenericTreeCtrl::OnSetFocus( wxFocusEvent &event )
3019 {
3020 m_hasFocus = true;
3021
3022 RefreshSelected();
3023
3024 event.Skip();
3025 }
3026
3027 void wxGenericTreeCtrl::OnKillFocus( wxFocusEvent &event )
3028 {
3029 m_hasFocus = false;
3030
3031 RefreshSelected();
3032
3033 event.Skip();
3034 }
3035
3036 void wxGenericTreeCtrl::OnChar( wxKeyEvent &event )
3037 {
3038 wxTreeEvent te( wxEVT_COMMAND_TREE_KEY_DOWN, this);
3039 te.m_evtKey = event;
3040 if ( GetEventHandler()->ProcessEvent( te ) )
3041 {
3042 // intercepted by the user code
3043 return;
3044 }
3045
3046 if ( (m_current == 0) || (m_key_current == 0) )
3047 {
3048 event.Skip();
3049 return;
3050 }
3051
3052 // how should the selection work for this event?
3053 bool is_multiple, extended_select, unselect_others;
3054 EventFlagsToSelType(GetWindowStyleFlag(),
3055 event.ShiftDown(),
3056 event.CmdDown(),
3057 is_multiple, extended_select, unselect_others);
3058
3059 if (GetLayoutDirection() == wxLayout_RightToLeft)
3060 {
3061 if (event.GetKeyCode() == WXK_RIGHT)
3062 event.m_keyCode = WXK_LEFT;
3063 else if (event.GetKeyCode() == WXK_LEFT)
3064 event.m_keyCode = WXK_RIGHT;
3065 }
3066
3067 // + : Expand
3068 // - : Collaspe
3069 // * : Expand all/Collapse all
3070 // ' ' | return : activate
3071 // up : go up (not last children!)
3072 // down : go down
3073 // left : go to parent
3074 // right : open if parent and go next
3075 // home : go to root
3076 // end : go to last item without opening parents
3077 // alnum : start or continue searching for the item with this prefix
3078 int keyCode = event.GetKeyCode();
3079
3080 #ifdef __WXOSX__
3081 // Make the keys work as they do in the native control:
3082 // right => expand
3083 // left => collapse if current item is expanded
3084 if (keyCode == WXK_RIGHT)
3085 {
3086 keyCode = '+';
3087 }
3088 else if (keyCode == WXK_LEFT && IsExpanded(m_current))
3089 {
3090 keyCode = '-';
3091 }
3092 #endif // __WXOSX__
3093
3094 switch ( keyCode )
3095 {
3096 case '+':
3097 case WXK_ADD:
3098 if (m_current->HasPlus() && !IsExpanded(m_current))
3099 {
3100 Expand(m_current);
3101 }
3102 break;
3103
3104 case '*':
3105 case WXK_MULTIPLY:
3106 if ( !IsExpanded(m_current) )
3107 {
3108 // expand all
3109 ExpandAllChildren(m_current);
3110 break;
3111 }
3112 //else: fall through to Collapse() it
3113
3114 case '-':
3115 case WXK_SUBTRACT:
3116 if (IsExpanded(m_current))
3117 {
3118 Collapse(m_current);
3119 }
3120 break;
3121
3122 case WXK_MENU:
3123 {
3124 // Use the item's bounding rectangle to determine position for
3125 // the event
3126 wxRect ItemRect;
3127 GetBoundingRect(m_current, ItemRect, true);
3128
3129 wxTreeEvent
3130 eventMenu(wxEVT_COMMAND_TREE_ITEM_MENU, this, m_current);
3131 // Use the left edge, vertical middle
3132 eventMenu.m_pointDrag = wxPoint(ItemRect.GetX(),
3133 ItemRect.GetY() +
3134 ItemRect.GetHeight() / 2);
3135 GetEventHandler()->ProcessEvent( eventMenu );
3136 }
3137 break;
3138
3139 case ' ':
3140 case WXK_RETURN:
3141 if ( !event.HasModifiers() )
3142 {
3143 wxTreeEvent
3144 eventAct(wxEVT_COMMAND_TREE_ITEM_ACTIVATED, this, m_current);
3145 GetEventHandler()->ProcessEvent( eventAct );
3146 }
3147
3148 // in any case, also generate the normal key event for this key,
3149 // even if we generated the ACTIVATED event above: this is what
3150 // wxMSW does and it makes sense because you might not want to
3151 // process ACTIVATED event at all and handle Space and Return
3152 // directly (and differently) which would be impossible otherwise
3153 event.Skip();
3154 break;
3155
3156 // up goes to the previous sibling or to the last
3157 // of its children if it's expanded
3158 case WXK_UP:
3159 {
3160 wxTreeItemId prev = GetPrevSibling( m_key_current );
3161 if (!prev)
3162 {
3163 prev = GetItemParent( m_key_current );
3164 if ((prev == GetRootItem()) && HasFlag(wxTR_HIDE_ROOT))
3165 {
3166 break; // don't go to root if it is hidden
3167 }
3168 if (prev)
3169 {
3170 wxTreeItemIdValue cookie;
3171 wxTreeItemId current = m_key_current;
3172 // TODO: Huh? If we get here, we'd better be the first
3173 // child of our parent. How else could it be?
3174 if (current == GetFirstChild( prev, cookie ))
3175 {
3176 // otherwise we return to where we came from
3177 DoSelectItem(prev,
3178 unselect_others,
3179 extended_select);
3180 m_key_current = (wxGenericTreeItem*) prev.m_pItem;
3181 break;
3182 }
3183 }
3184 }
3185 if (prev)
3186 {
3187 while ( IsExpanded(prev) && HasChildren(prev) )
3188 {
3189 wxTreeItemId child = GetLastChild(prev);
3190 if ( child )
3191 {
3192 prev = child;
3193 }
3194 }
3195
3196 DoSelectItem( prev, unselect_others, extended_select );
3197 m_key_current=(wxGenericTreeItem*) prev.m_pItem;
3198 }
3199 }
3200 break;
3201
3202 // left arrow goes to the parent
3203 case WXK_LEFT:
3204 {
3205 wxTreeItemId prev = GetItemParent( m_current );
3206 if ((prev == GetRootItem()) && HasFlag(wxTR_HIDE_ROOT))
3207 {
3208 // don't go to root if it is hidden
3209 prev = GetPrevSibling( m_current );
3210 }
3211 if (prev)
3212 {
3213 DoSelectItem( prev, unselect_others, extended_select );
3214 }
3215 }
3216 break;
3217
3218 case WXK_RIGHT:
3219 // this works the same as the down arrow except that we
3220 // also expand the item if it wasn't expanded yet
3221 if (m_current != GetRootItem().m_pItem || !HasFlag(wxTR_HIDE_ROOT))
3222 Expand(m_current);
3223 //else: don't try to expand hidden root item (which can be the
3224 // current one when the tree is empty)
3225
3226 // fall through
3227
3228 case WXK_DOWN:
3229 {
3230 if (IsExpanded(m_key_current) && HasChildren(m_key_current))
3231 {
3232 wxTreeItemIdValue cookie;
3233 wxTreeItemId child = GetFirstChild( m_key_current, cookie );
3234 if ( !child )
3235 break;
3236
3237 DoSelectItem( child, unselect_others, extended_select );
3238 m_key_current=(wxGenericTreeItem*) child.m_pItem;
3239 }
3240 else
3241 {
3242 wxTreeItemId next = GetNextSibling( m_key_current );
3243 if (!next)
3244 {
3245 wxTreeItemId current = m_key_current;
3246 while (current.IsOk() && !next)
3247 {
3248 current = GetItemParent( current );
3249 if (current) next = GetNextSibling( current );
3250 }
3251 }
3252 if (next)
3253 {
3254 DoSelectItem( next, unselect_others, extended_select );
3255 m_key_current=(wxGenericTreeItem*) next.m_pItem;
3256 }
3257 }
3258 }
3259 break;
3260
3261 // <End> selects the last visible tree item
3262 case WXK_END:
3263 {
3264 wxTreeItemId last = GetRootItem();
3265
3266 while ( last.IsOk() && IsExpanded(last) )
3267 {
3268 wxTreeItemId lastChild = GetLastChild(last);
3269
3270 // it may happen if the item was expanded but then all of
3271 // its children have been deleted - so IsExpanded() returned
3272 // true, but GetLastChild() returned invalid item
3273 if ( !lastChild )
3274 break;
3275
3276 last = lastChild;
3277 }
3278
3279 if ( last.IsOk() )
3280 {
3281 DoSelectItem( last, unselect_others, extended_select );
3282 }
3283 }
3284 break;
3285
3286 // <Home> selects the root item
3287 case WXK_HOME:
3288 {
3289 wxTreeItemId prev = GetRootItem();
3290 if (!prev)
3291 break;
3292
3293 if ( HasFlag(wxTR_HIDE_ROOT) )
3294 {
3295 wxTreeItemIdValue cookie;
3296 prev = GetFirstChild(prev, cookie);
3297 if (!prev)
3298 break;
3299 }
3300
3301 DoSelectItem( prev, unselect_others, extended_select );
3302 }
3303 break;
3304
3305 default:
3306 // do not use wxIsalnum() here
3307 if ( !event.HasModifiers() &&
3308 ((keyCode >= '0' && keyCode <= '9') ||
3309 (keyCode >= 'a' && keyCode <= 'z') ||
3310 (keyCode >= 'A' && keyCode <= 'Z' )))
3311 {
3312 // find the next item starting with the given prefix
3313 wxChar ch = (wxChar)keyCode;
3314
3315 wxTreeItemId id = FindItem(m_current, m_findPrefix + ch);
3316 if ( !id.IsOk() )
3317 {
3318 // no such item
3319 break;
3320 }
3321
3322 SelectItem(id);
3323
3324 m_findPrefix += ch;
3325
3326 // also start the timer to reset the current prefix if the user
3327 // doesn't press any more alnum keys soon -- we wouldn't want
3328 // to use this prefix for a new item search
3329 if ( !m_findTimer )
3330 {
3331 m_findTimer = new wxTreeFindTimer(this);
3332 }
3333
3334 m_findTimer->Start(wxTreeFindTimer::DELAY, wxTIMER_ONE_SHOT);
3335 }
3336 else
3337 {
3338 event.Skip();
3339 }
3340 }
3341 }
3342
3343 wxTreeItemId
3344 wxGenericTreeCtrl::DoTreeHitTest(const wxPoint& point, int& flags) const
3345 {
3346 int w, h;
3347 GetSize(&w, &h);
3348 flags=0;
3349 if (point.x<0) flags |= wxTREE_HITTEST_TOLEFT;
3350 if (point.x>w) flags |= wxTREE_HITTEST_TORIGHT;
3351 if (point.y<0) flags |= wxTREE_HITTEST_ABOVE;
3352 if (point.y>h) flags |= wxTREE_HITTEST_BELOW;
3353 if (flags) return wxTreeItemId();
3354
3355 if (m_anchor == NULL)
3356 {
3357 flags = wxTREE_HITTEST_NOWHERE;
3358 return wxTreeItemId();
3359 }
3360
3361 wxGenericTreeItem *hit = m_anchor->HitTest(CalcUnscrolledPosition(point),
3362 this, flags, 0);
3363 if (hit == NULL)
3364 {
3365 flags = wxTREE_HITTEST_NOWHERE;
3366 return wxTreeItemId();
3367 }
3368 return hit;
3369 }
3370
3371 // get the bounding rectangle of the item (or of its label only)
3372 bool wxGenericTreeCtrl::GetBoundingRect(const wxTreeItemId& item,
3373 wxRect& rect,
3374 bool textOnly) const
3375 {
3376 wxCHECK_MSG( item.IsOk(), false,
3377 "invalid item in wxGenericTreeCtrl::GetBoundingRect" );
3378
3379 wxGenericTreeItem *i = (wxGenericTreeItem*) item.m_pItem;
3380
3381 if ( textOnly )
3382 {
3383 int image_h = 0, image_w = 0;
3384 int image = ((wxGenericTreeItem*) item.m_pItem)->GetCurrentImage();
3385 if ( image != NO_IMAGE && m_imageListNormal )
3386 {
3387 m_imageListNormal->GetSize( image, image_w, image_h );
3388 image_w += MARGIN_BETWEEN_IMAGE_AND_TEXT;
3389 }
3390
3391 int state_h = 0, state_w = 0;
3392 int state = ((wxGenericTreeItem*) item.m_pItem)->GetState();
3393 if ( state != wxTREE_ITEMSTATE_NONE && m_imageListState )
3394 {
3395 m_imageListState->GetSize( state, state_w, state_h );
3396 if ( image_w != 0 )
3397 state_w += MARGIN_BETWEEN_STATE_AND_IMAGE;
3398 else
3399 state_w += MARGIN_BETWEEN_IMAGE_AND_TEXT;
3400 }
3401
3402 rect.x = i->GetX() + state_w + image_w;
3403 rect.width = i->GetWidth() - state_w - image_w;
3404
3405 }
3406 else // the entire line
3407 {
3408 rect.x = 0;
3409 rect.width = GetClientSize().x;
3410 }
3411
3412 rect.y = i->GetY();
3413 rect.height = GetLineHeight(i);
3414
3415 // we have to return the logical coordinates, not physical ones
3416 rect.SetTopLeft(CalcScrolledPosition(rect.GetTopLeft()));
3417
3418 return true;
3419 }
3420
3421 wxTextCtrl *wxGenericTreeCtrl::EditLabel(const wxTreeItemId& item,
3422 wxClassInfo * WXUNUSED(textCtrlClass))
3423 {
3424 wxCHECK_MSG( item.IsOk(), NULL, wxT("can't edit an invalid item") );
3425
3426 wxGenericTreeItem *itemEdit = (wxGenericTreeItem *)item.m_pItem;
3427
3428 wxTreeEvent te(wxEVT_COMMAND_TREE_BEGIN_LABEL_EDIT, this, itemEdit);
3429 if ( GetEventHandler()->ProcessEvent( te ) && !te.IsAllowed() )
3430 {
3431 // vetoed by user
3432 return NULL;
3433 }
3434
3435 // We have to call this here because the label in
3436 // question might just have been added and no screen
3437 // update taken place.
3438 if ( m_dirty )
3439 #if defined( __WXMSW__ ) || defined(__WXMAC__)
3440 Update();
3441 #else
3442 DoDirtyProcessing();
3443 #endif
3444
3445 // TODO: use textCtrlClass here to create the control of correct class
3446 m_textCtrl = new wxTreeTextCtrl(this, itemEdit);
3447
3448 m_textCtrl->SetFocus();
3449
3450 return m_textCtrl;
3451 }
3452
3453 // returns a pointer to the text edit control if the item is being
3454 // edited, NULL otherwise (it's assumed that no more than one item may
3455 // be edited simultaneously)
3456 wxTextCtrl* wxGenericTreeCtrl::GetEditControl() const
3457 {
3458 return m_textCtrl;
3459 }
3460
3461 void wxGenericTreeCtrl::EndEditLabel(const wxTreeItemId& WXUNUSED(item),
3462 bool discardChanges)
3463 {
3464 wxCHECK_RET( m_textCtrl, wxT("not editing label") );
3465
3466 m_textCtrl->EndEdit(discardChanges);
3467 }
3468
3469 bool wxGenericTreeCtrl::OnRenameAccept(wxGenericTreeItem *item,
3470 const wxString& value)
3471 {
3472 wxTreeEvent le(wxEVT_COMMAND_TREE_END_LABEL_EDIT, this, item);
3473 le.m_label = value;
3474 le.m_editCancelled = false;
3475
3476 return !GetEventHandler()->ProcessEvent( le ) || le.IsAllowed();
3477 }
3478
3479 void wxGenericTreeCtrl::OnRenameCancelled(wxGenericTreeItem *item)
3480 {
3481 // let owner know that the edit was cancelled
3482 wxTreeEvent le(wxEVT_COMMAND_TREE_END_LABEL_EDIT, this, item);
3483 le.m_label = wxEmptyString;
3484 le.m_editCancelled = true;
3485
3486 GetEventHandler()->ProcessEvent( le );
3487 }
3488
3489 void wxGenericTreeCtrl::OnRenameTimer()
3490 {
3491 EditLabel( m_current );
3492 }
3493
3494 void wxGenericTreeCtrl::OnMouse( wxMouseEvent &event )
3495 {
3496 if ( !m_anchor )return;
3497
3498 wxPoint pt = CalcUnscrolledPosition(event.GetPosition());
3499
3500 // Is the mouse over a tree item button?
3501 int flags = 0;
3502 wxGenericTreeItem *thisItem = m_anchor->HitTest(pt, this, flags, 0);
3503 wxGenericTreeItem *underMouse = thisItem;
3504 #if wxUSE_TOOLTIPS
3505 bool underMouseChanged = (underMouse != m_underMouse) ;
3506 #endif // wxUSE_TOOLTIPS
3507
3508 if ((underMouse) &&
3509 (flags & wxTREE_HITTEST_ONITEMBUTTON) &&
3510 (!event.LeftIsDown()) &&
3511 (!m_isDragging) &&
3512 (!m_renameTimer || !m_renameTimer->IsRunning()))
3513 {
3514 }
3515 else
3516 {
3517 underMouse = NULL;
3518 }
3519
3520 if (underMouse != m_underMouse)
3521 {
3522 if (m_underMouse)
3523 {
3524 // unhighlight old item
3525 wxGenericTreeItem *tmp = m_underMouse;
3526 m_underMouse = NULL;
3527 RefreshLine( tmp );
3528 }
3529
3530 m_underMouse = underMouse;
3531 if (m_underMouse)
3532 RefreshLine( m_underMouse );
3533 }
3534
3535 #if wxUSE_TOOLTIPS
3536 // Determines what item we are hovering over and need a tooltip for
3537 wxTreeItemId hoverItem = thisItem;
3538
3539 // We do not want a tooltip if we are dragging, or if the rename timer is
3540 // running
3541 if ( underMouseChanged &&
3542 hoverItem.IsOk() &&
3543 !m_isDragging &&
3544 (!m_renameTimer || !m_renameTimer->IsRunning()) )
3545 {
3546 // Ask the tree control what tooltip (if any) should be shown
3547 wxTreeEvent
3548 hevent(wxEVT_COMMAND_TREE_ITEM_GETTOOLTIP, this, hoverItem);
3549
3550 if ( GetEventHandler()->ProcessEvent(hevent) && hevent.IsAllowed() )
3551 {
3552 SetToolTip(hevent.m_label);
3553 }
3554 }
3555 #endif
3556
3557 // we process left mouse up event (enables in-place edit), middle/right down
3558 // (pass to the user code), left dbl click (activate item) and
3559 // dragging/moving events for items drag-and-drop
3560 if ( !(event.LeftDown() ||
3561 event.LeftUp() ||
3562 event.MiddleDown() ||
3563 event.RightDown() ||
3564 event.LeftDClick() ||
3565 event.Dragging() ||
3566 ((event.Moving() || event.RightUp()) && m_isDragging)) )
3567 {
3568 event.Skip();
3569
3570 return;
3571 }
3572
3573
3574 flags = 0;
3575 wxGenericTreeItem *item = m_anchor->HitTest(pt, this, flags, 0);
3576
3577 if ( event.Dragging() && !m_isDragging )
3578 {
3579 if (m_dragCount == 0)
3580 m_dragStart = pt;
3581
3582 m_dragCount++;
3583
3584 if (m_dragCount != 3)
3585 {
3586 // wait until user drags a bit further...
3587 return;
3588 }
3589
3590 wxEventType command = event.RightIsDown()
3591 ? wxEVT_COMMAND_TREE_BEGIN_RDRAG
3592 : wxEVT_COMMAND_TREE_BEGIN_DRAG;
3593
3594 wxTreeEvent nevent(command, this, m_current);
3595 nevent.SetPoint(CalcScrolledPosition(pt));
3596
3597 // by default the dragging is not supported, the user code must
3598 // explicitly allow the event for it to take place
3599 nevent.Veto();
3600
3601 if ( GetEventHandler()->ProcessEvent(nevent) && nevent.IsAllowed() )
3602 {
3603 // we're going to drag this item
3604 m_isDragging = true;
3605
3606 // remember the old cursor because we will change it while
3607 // dragging
3608 m_oldCursor = m_cursor;
3609
3610 // in a single selection control, hide the selection temporarily
3611 if ( !(GetWindowStyleFlag() & wxTR_MULTIPLE) )
3612 {
3613 m_oldSelection = (wxGenericTreeItem*) GetSelection().m_pItem;
3614
3615 if ( m_oldSelection )
3616 {
3617 m_oldSelection->SetHilight(false);
3618 RefreshLine(m_oldSelection);
3619 }
3620 }
3621
3622 CaptureMouse();
3623 }
3624 }
3625 else if ( event.Dragging() )
3626 {
3627 if ( item != m_dropTarget )
3628 {
3629 // unhighlight the previous drop target
3630 DrawDropEffect(m_dropTarget);
3631
3632 m_dropTarget = item;
3633
3634 // highlight the current drop target if any
3635 DrawDropEffect(m_dropTarget);
3636
3637 #if defined(__WXMSW__) || defined(__WXMAC__) || defined(__WXGTK20__)
3638 Update();
3639 #else
3640 // TODO: remove this call or use wxEventLoopBase::GetActive()->YieldFor(wxEVT_CATEGORY_UI)
3641 // instead (needs to be tested!)
3642 wxYieldIfNeeded();
3643 #endif
3644 }
3645 }
3646 else if ( (event.LeftUp() || event.RightUp()) && m_isDragging )
3647 {
3648 ReleaseMouse();
3649
3650 // erase the highlighting
3651 DrawDropEffect(m_dropTarget);
3652
3653 if ( m_oldSelection )
3654 {
3655 m_oldSelection->SetHilight(true);
3656 RefreshLine(m_oldSelection);
3657 m_oldSelection = NULL;
3658 }
3659
3660 // generate the drag end event
3661 wxTreeEvent eventEndDrag(wxEVT_COMMAND_TREE_END_DRAG, this, item);
3662
3663 eventEndDrag.m_pointDrag = CalcScrolledPosition(pt);
3664
3665 (void)GetEventHandler()->ProcessEvent(eventEndDrag);
3666
3667 m_isDragging = false;
3668 m_dropTarget = NULL;
3669
3670 SetCursor(m_oldCursor);
3671
3672 #if defined( __WXMSW__ ) || defined(__WXMAC__) || defined(__WXGTK20__)
3673 Update();
3674 #else
3675 // TODO: remove this call or use wxEventLoopBase::GetActive()->YieldFor(wxEVT_CATEGORY_UI)
3676 // instead (needs to be tested!)
3677 wxYieldIfNeeded();
3678 #endif
3679 }
3680 else
3681 {
3682 // If we got to this point, we are not dragging or moving the mouse.
3683 // Because the code in carbon/toplevel.cpp will only set focus to the
3684 // tree if we skip for EVT_LEFT_DOWN, we MUST skip this event here for
3685 // focus to work.
3686 // We skip even if we didn't hit an item because we still should
3687 // restore focus to the tree control even if we didn't exactly hit an
3688 // item.
3689 if ( event.LeftDown() )
3690 {
3691 event.Skip();
3692 }
3693
3694 // here we process only the messages which happen on tree items
3695
3696 m_dragCount = 0;
3697
3698 if (item == NULL) return; /* we hit the blank area */
3699
3700 if ( event.RightDown() )
3701 {
3702 // If the item is already selected, do not update the selection.
3703 // Multi-selections should not be cleared if a selected item is
3704 // clicked.
3705 if (!IsSelected(item))
3706 {
3707 DoSelectItem(item, true, false);
3708 }
3709
3710 wxTreeEvent
3711 nevent(wxEVT_COMMAND_TREE_ITEM_RIGHT_CLICK, this, item);
3712 nevent.m_pointDrag = CalcScrolledPosition(pt);
3713 event.Skip(!GetEventHandler()->ProcessEvent(nevent));
3714
3715 // Consistent with MSW (for now), send the ITEM_MENU *after*
3716 // the RIGHT_CLICK event. TODO: This behavior may change.
3717 wxTreeEvent nevent2(wxEVT_COMMAND_TREE_ITEM_MENU, this, item);
3718 nevent2.m_pointDrag = CalcScrolledPosition(pt);
3719 GetEventHandler()->ProcessEvent(nevent2);
3720 }
3721 else if ( event.MiddleDown() )
3722 {
3723 wxTreeEvent
3724 nevent(wxEVT_COMMAND_TREE_ITEM_MIDDLE_CLICK, this, item);
3725 nevent.m_pointDrag = CalcScrolledPosition(pt);
3726 event.Skip(!GetEventHandler()->ProcessEvent(nevent));
3727 }
3728 else if ( event.LeftUp() )
3729 {
3730 if (flags & wxTREE_HITTEST_ONITEMSTATEICON)
3731 {
3732 wxTreeEvent
3733 nevent(wxEVT_COMMAND_TREE_STATE_IMAGE_CLICK, this, item);
3734 GetEventHandler()->ProcessEvent(nevent);
3735 }
3736
3737 // this facilitates multiple-item drag-and-drop
3738
3739 if ( /* item && */ HasFlag(wxTR_MULTIPLE))
3740 {
3741 wxArrayTreeItemIds selections;
3742 size_t count = GetSelections(selections);
3743
3744 if (count > 1 &&
3745 !event.CmdDown() &&
3746 !event.ShiftDown())
3747 {
3748 DoSelectItem(item, true, false);
3749 }
3750 }
3751
3752 if ( m_lastOnSame )
3753 {
3754 if ( (item == m_current) &&
3755 (flags & wxTREE_HITTEST_ONITEMLABEL) &&
3756 HasFlag(wxTR_EDIT_LABELS) )
3757 {
3758 if ( m_renameTimer )
3759 {
3760 if ( m_renameTimer->IsRunning() )
3761 m_renameTimer->Stop();
3762 }
3763 else
3764 {
3765 m_renameTimer = new wxTreeRenameTimer( this );
3766 }
3767
3768 m_renameTimer->Start( wxTreeRenameTimer::DELAY, true );
3769 }
3770
3771 m_lastOnSame = false;
3772 }
3773 }
3774 else // !RightDown() && !MiddleDown() && !LeftUp()
3775 {
3776 // ==> LeftDown() || LeftDClick()
3777 if ( event.LeftDown() )
3778 {
3779 m_lastOnSame = item == m_current;
3780 }
3781
3782 if ( flags & wxTREE_HITTEST_ONITEMBUTTON )
3783 {
3784 // only toggle the item for a single click, double click on
3785 // the button doesn't do anything (it toggles the item twice)
3786 if ( event.LeftDown() )
3787 {
3788 Toggle( item );
3789 }
3790
3791 // don't select the item if the button was clicked
3792 return;
3793 }
3794
3795
3796 // clear the previously selected items, if the
3797 // user clicked outside of the present selection.
3798 // otherwise, perform the deselection on mouse-up.
3799 // this allows multiple drag and drop to work.
3800 // but if Cmd is down, toggle selection of the clicked item
3801 if (!IsSelected(item) || event.CmdDown())
3802 {
3803 // how should the selection work for this event?
3804 bool is_multiple, extended_select, unselect_others;
3805 EventFlagsToSelType(GetWindowStyleFlag(),
3806 event.ShiftDown(),
3807 event.CmdDown(),
3808 is_multiple,
3809 extended_select,
3810 unselect_others);
3811
3812 DoSelectItem(item, unselect_others, extended_select);
3813 }
3814
3815
3816 // For some reason, Windows isn't recognizing a left double-click,
3817 // so we need to simulate it here. Allow 200 milliseconds for now.
3818 if ( event.LeftDClick() )
3819 {
3820 // double clicking should not start editing the item label
3821 if ( m_renameTimer )
3822 m_renameTimer->Stop();
3823
3824 m_lastOnSame = false;
3825
3826 // send activate event first
3827 wxTreeEvent
3828 nevent(wxEVT_COMMAND_TREE_ITEM_ACTIVATED, this, item);
3829 nevent.m_pointDrag = CalcScrolledPosition(pt);
3830 if ( !GetEventHandler()->ProcessEvent( nevent ) )
3831 {
3832 // if the user code didn't process the activate event,
3833 // handle it ourselves by toggling the item when it is
3834 // double clicked
3835 if ( item->HasPlus() )
3836 {
3837 Toggle(item);
3838 }
3839 }
3840 }
3841 }
3842 }
3843 }
3844
3845 void wxGenericTreeCtrl::OnInternalIdle()
3846 {
3847 wxWindow::OnInternalIdle();
3848
3849 // Check if we need to select the root item
3850 // because nothing else has been selected.
3851 // Delaying it means that we can invoke event handlers
3852 // as required, when a first item is selected.
3853 if (!HasFlag(wxTR_MULTIPLE) && !GetSelection().IsOk())
3854 {
3855 if (m_select_me)
3856 SelectItem(m_select_me);
3857 else if (GetRootItem().IsOk())
3858 SelectItem(GetRootItem());
3859 }
3860
3861 // after all changes have been done to the tree control,
3862 // actually redraw the tree when everything is over
3863 if (m_dirty)
3864 DoDirtyProcessing();
3865 }
3866
3867 void
3868 wxGenericTreeCtrl::CalculateLevel(wxGenericTreeItem *item,
3869 wxDC &dc,
3870 int level,
3871 int &y )
3872 {
3873 int x = level*m_indent;
3874 if (!HasFlag(wxTR_HIDE_ROOT))
3875 {
3876 x += m_indent;
3877 }
3878 else if (level == 0)
3879 {
3880 // a hidden root is not evaluated, but its
3881 // children are always calculated
3882 goto Recurse;
3883 }
3884
3885 item->CalculateSize(this, dc);
3886
3887 // set its position
3888 item->SetX( x+m_spacing );
3889 item->SetY( y );
3890 y += GetLineHeight(item);
3891
3892 if ( !item->IsExpanded() )
3893 {
3894 // we don't need to calculate collapsed branches
3895 return;
3896 }
3897
3898 Recurse:
3899 wxArrayGenericTreeItems& children = item->GetChildren();
3900 size_t n, count = children.GetCount();
3901 ++level;
3902 for (n = 0; n < count; ++n )
3903 CalculateLevel( children[n], dc, level, y ); // recurse
3904 }
3905
3906 void wxGenericTreeCtrl::CalculatePositions()
3907 {
3908 if ( !m_anchor ) return;
3909
3910 wxClientDC dc(this);
3911 PrepareDC( dc );
3912
3913 dc.SetFont( m_normalFont );
3914
3915 dc.SetPen( m_dottedPen );
3916 //if(GetImageList() == NULL)
3917 // m_lineHeight = (int)(dc.GetCharHeight() + 4);
3918
3919 int y = 2;
3920 CalculateLevel( m_anchor, dc, 0, y ); // start recursion
3921 }
3922
3923 void wxGenericTreeCtrl::Refresh(bool eraseBackground, const wxRect *rect)
3924 {
3925 if ( !IsFrozen() )
3926 wxTreeCtrlBase::Refresh(eraseBackground, rect);
3927 }
3928
3929 void wxGenericTreeCtrl::RefreshSubtree(wxGenericTreeItem *item)
3930 {
3931 if (m_dirty || IsFrozen() )
3932 return;
3933
3934 wxSize client = GetClientSize();
3935
3936 wxRect rect;
3937 CalcScrolledPosition(0, item->GetY(), NULL, &rect.y);
3938 rect.width = client.x;
3939 rect.height = client.y;
3940
3941 Refresh(true, &rect);
3942
3943 AdjustMyScrollbars();
3944 }
3945
3946 void wxGenericTreeCtrl::RefreshLine( wxGenericTreeItem *item )
3947 {
3948 if (m_dirty || IsFrozen() )
3949 return;
3950
3951 wxRect rect;
3952 CalcScrolledPosition(0, item->GetY(), NULL, &rect.y);
3953 rect.width = GetClientSize().x;
3954 rect.height = GetLineHeight(item); //dc.GetCharHeight() + 6;
3955
3956 Refresh(true, &rect);
3957 }
3958
3959 void wxGenericTreeCtrl::RefreshSelected()
3960 {
3961 if (IsFrozen())
3962 return;
3963
3964 // TODO: this is awfully inefficient, we should keep the list of all
3965 // selected items internally, should be much faster
3966 if ( m_anchor )
3967 RefreshSelectedUnder(m_anchor);
3968 }
3969
3970 void wxGenericTreeCtrl::RefreshSelectedUnder(wxGenericTreeItem *item)
3971 {
3972 if (IsFrozen())
3973 return;
3974
3975 if ( item->IsSelected() )
3976 RefreshLine(item);
3977
3978 const wxArrayGenericTreeItems& children = item->GetChildren();
3979 size_t count = children.GetCount();
3980 for ( size_t n = 0; n < count; n++ )
3981 {
3982 RefreshSelectedUnder(children[n]);
3983 }
3984 }
3985
3986 void wxGenericTreeCtrl::DoThaw()
3987 {
3988 wxTreeCtrlBase::DoThaw();
3989
3990 if ( m_dirty )
3991 DoDirtyProcessing();
3992 else
3993 Refresh();
3994 }
3995
3996 // ----------------------------------------------------------------------------
3997 // changing colours: we need to refresh the tree control
3998 // ----------------------------------------------------------------------------
3999
4000 bool wxGenericTreeCtrl::SetBackgroundColour(const wxColour& colour)
4001 {
4002 if ( !wxWindow::SetBackgroundColour(colour) )
4003 return false;
4004
4005 Refresh();
4006
4007 return true;
4008 }
4009
4010 bool wxGenericTreeCtrl::SetForegroundColour(const wxColour& colour)
4011 {
4012 if ( !wxWindow::SetForegroundColour(colour) )
4013 return false;
4014
4015 Refresh();
4016
4017 return true;
4018 }
4019
4020 // Process the tooltip event, to speed up event processing.
4021 // Doesn't actually get a tooltip.
4022 void wxGenericTreeCtrl::OnGetToolTip( wxTreeEvent &event )
4023 {
4024 event.Veto();
4025 }
4026
4027
4028 // NOTE: If using the wxListBox visual attributes works everywhere then this can
4029 // be removed, as well as the #else case below.
4030 #define _USE_VISATTR 0
4031
4032 //static
4033 wxVisualAttributes
4034 #if _USE_VISATTR
4035 wxGenericTreeCtrl::GetClassDefaultAttributes(wxWindowVariant variant)
4036 #else
4037 wxGenericTreeCtrl::GetClassDefaultAttributes(wxWindowVariant WXUNUSED(variant))
4038 #endif
4039 {
4040 #if _USE_VISATTR
4041 // Use the same color scheme as wxListBox
4042 return wxListBox::GetClassDefaultAttributes(variant);
4043 #else
4044 wxVisualAttributes attr;
4045 attr.colFg = wxSystemSettings::GetColour(wxSYS_COLOUR_LISTBOXTEXT);
4046 attr.colBg = wxSystemSettings::GetColour(wxSYS_COLOUR_LISTBOX);
4047 attr.font = wxSystemSettings::GetFont(wxSYS_DEFAULT_GUI_FONT);
4048 return attr;
4049 #endif
4050 }
4051
4052 void wxGenericTreeCtrl::DoDirtyProcessing()
4053 {
4054 if (IsFrozen())
4055 return;
4056
4057 m_dirty = false;
4058
4059 CalculatePositions();
4060 Refresh();
4061 AdjustMyScrollbars();
4062 }
4063
4064 wxSize wxGenericTreeCtrl::DoGetBestSize() const
4065 {
4066 // make sure all positions are calculated as normally this only done during
4067 // idle time but we need them for base class DoGetBestSize() to return the
4068 // correct result
4069 wxConstCast(this, wxGenericTreeCtrl)->CalculatePositions();
4070
4071 wxSize size = wxTreeCtrlBase::DoGetBestSize();
4072
4073 // there seems to be an implicit extra border around the items, although
4074 // I'm not really sure where does it come from -- but without this, the
4075 // scrollbars appear in a tree with default/best size
4076 size.IncBy(4, 4);
4077
4078 // and the border has to be rounded up to a multiple of PIXELS_PER_UNIT or
4079 // scrollbars still appear
4080 const wxSize& borderSize = GetWindowBorderSize();
4081
4082 int dx = (size.x - borderSize.x) % PIXELS_PER_UNIT;
4083 if ( dx )
4084 size.x += PIXELS_PER_UNIT - dx;
4085 int dy = (size.y - borderSize.y) % PIXELS_PER_UNIT;
4086 if ( dy )
4087 size.y += PIXELS_PER_UNIT - dy;
4088
4089 // we need to update the cache too as the base class cached its own value
4090 CacheBestSize(size);
4091
4092 return size;
4093 }
4094
4095 #endif // wxUSE_TREECTRL