1 /////////////////////////////////////////////////////////////////////////////
4 // Author: Julian Smart
5 // Modified by: Vadim Zeitlin to be less MSW-specific on 10.10.98
8 // Copyright: (c) Julian Smart
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 // ============================================================================
14 // ============================================================================
16 // ----------------------------------------------------------------------------
18 // ----------------------------------------------------------------------------
20 #pragma implementation "treectrl.h"
23 // For compilers that support precompilation, includes "wx.h".
24 #include "wx/wxprec.h"
30 #include "wx/msw/private.h"
32 // Mingw32 is a bit mental even though this is done in winundef
41 #if defined(__WIN95__)
44 #include "wx/dynarray.h"
45 #include "wx/imaglist.h"
46 #include "wx/treectrl.h"
47 #include "wx/settings.h"
49 #include "wx/msw/dragimag.h"
51 #ifdef __GNUWIN32_OLD__
52 #include "wx/msw/gnuwin32/extra.h"
55 #if defined(__WIN95__) && !(defined(__GNUWIN32_OLD__) || defined(__TWIN32__))
59 // Bug in headers, sometimes
61 #define TVIS_FOCUSED 0x0001
65 #define TV_FIRST 0x1100
68 #ifndef TVS_CHECKBOXES
69 #define TVS_CHECKBOXES 0x0100
72 // old headers might miss these messages (comctl32.dll 4.71+ only)
73 #ifndef TVM_SETBKCOLOR
74 #define TVM_SETBKCOLOR (TV_FIRST + 29)
75 #define TVM_SETTEXTCOLOR (TV_FIRST + 30)
78 // a macro to hide the ugliness of nested casts
79 #define HITEM(item) (HTREEITEM)(WXHTREEITEM)(item)
81 // the native control doesn't support multiple selections under MSW and we
82 // have 2 ways to emulate them: either using TVS_CHECKBOXES style and let
83 // checkboxes be the selection status (checked == selected) or by really
84 // emulating everything, i.e. intercepting mouse and key events &c. The first
85 // approach is much easier but doesn't work with comctl32.dll < 4.71 and also
87 #define wxUSE_CHECKBOXES_IN_MULTI_SEL_TREE 0
89 // ----------------------------------------------------------------------------
91 // ----------------------------------------------------------------------------
93 // wrapper for TreeView_HitTest
94 static HTREEITEM
GetItemFromPoint(HWND hwndTV
, int x
, int y
)
100 return (HTREEITEM
)TreeView_HitTest(hwndTV
, &tvht
);
103 #if !wxUSE_CHECKBOXES_IN_MULTI_SEL_TREE
105 // wrappers for TreeView_GetItem/TreeView_SetItem
106 static bool IsItemSelected(HWND hwndTV
, HTREEITEM hItem
)
109 tvi
.mask
= TVIF_STATE
| TVIF_HANDLE
;
110 tvi
.stateMask
= TVIS_SELECTED
;
113 if ( !TreeView_GetItem(hwndTV
, &tvi
) )
115 wxLogLastError("TreeView_GetItem");
118 return (tvi
.state
& TVIS_SELECTED
) != 0;
121 static void SelectItem(HWND hwndTV
, HTREEITEM hItem
, bool select
= TRUE
)
124 tvi
.mask
= TVIF_STATE
| TVIF_HANDLE
;
125 tvi
.stateMask
= TVIS_SELECTED
;
126 tvi
.state
= select ? TVIS_SELECTED
: 0;
129 if ( TreeView_SetItem(hwndTV
, &tvi
) == -1 )
131 wxLogLastError("TreeView_SetItem");
135 static inline void UnselectItem(HWND hwndTV
, HTREEITEM htItem
)
137 SelectItem(hwndTV
, htItem
, FALSE
);
140 static inline void ToggleItemSelection(HWND hwndTV
, HTREEITEM htItem
)
142 SelectItem(hwndTV
, htItem
, !IsItemSelected(hwndTV
, htItem
));
145 // helper function which selects all items in a range and, optionally,
146 // unselects all others
147 static void SelectRange(HWND hwndTV
,
150 bool unselectOthers
= TRUE
)
152 // find the first (or last) item and select it
154 HTREEITEM htItem
= (HTREEITEM
)TreeView_GetRoot(hwndTV
);
155 while ( htItem
&& cont
)
157 if ( (htItem
== htFirst
) || (htItem
== htLast
) )
159 if ( !IsItemSelected(hwndTV
, htItem
) )
161 SelectItem(hwndTV
, htItem
);
168 if ( unselectOthers
&& IsItemSelected(hwndTV
, htItem
) )
170 UnselectItem(hwndTV
, htItem
);
174 htItem
= (HTREEITEM
)TreeView_GetNextVisible(hwndTV
, htItem
);
177 // select the items in range
178 cont
= htFirst
!= htLast
;
179 while ( htItem
&& cont
)
181 if ( !IsItemSelected(hwndTV
, htItem
) )
183 SelectItem(hwndTV
, htItem
);
186 cont
= (htItem
!= htFirst
) && (htItem
!= htLast
);
188 htItem
= (HTREEITEM
)TreeView_GetNextVisible(hwndTV
, htItem
);
192 if ( unselectOthers
)
196 if ( IsItemSelected(hwndTV
, htItem
) )
198 UnselectItem(hwndTV
, htItem
);
201 htItem
= (HTREEITEM
)TreeView_GetNextVisible(hwndTV
, htItem
);
205 // seems to be necessary - otherwise the just selected items don't always
206 // appear as selected
207 UpdateWindow(hwndTV
);
210 // helper function which tricks the standard control into changing the focused
211 // item without changing anything else (if someone knows why Microsoft doesn't
212 // allow to do it by just setting TVIS_FOCUSED flag, please tell me!)
213 static void SetFocus(HWND hwndTV
, HTREEITEM htItem
)
216 HTREEITEM htFocus
= (HTREEITEM
)TreeView_GetSelection(hwndTV
);
221 if ( htItem
!= htFocus
)
223 // remember the selection state of the item
224 bool wasSelected
= IsItemSelected(hwndTV
, htItem
);
226 if ( htFocus
&& IsItemSelected(hwndTV
, htFocus
) )
228 // prevent the tree from unselecting the old focus which it
229 // would do by default (TreeView_SelectItem unselects the
231 TreeView_SelectItem(hwndTV
, 0);
232 SelectItem(hwndTV
, htFocus
);
235 TreeView_SelectItem(hwndTV
, htItem
);
239 // need to clear the selection which TreeView_SelectItem() gave
241 UnselectItem(hwndTV
, htItem
);
243 //else: was selected, still selected - ok
245 //else: nothing to do, focus already there
251 bool wasFocusSelected
= IsItemSelected(hwndTV
, htFocus
);
253 // just clear the focus
254 TreeView_SelectItem(hwndTV
, 0);
256 if ( wasFocusSelected
)
258 // restore the selection state
259 SelectItem(hwndTV
, htFocus
);
262 //else: nothing to do, no focus already
266 #endif // wxUSE_CHECKBOXES_IN_MULTI_SEL_TREE
268 // ----------------------------------------------------------------------------
270 // ----------------------------------------------------------------------------
272 // a convenient wrapper around TV_ITEM struct which adds a ctor
274 #pragma warning( disable : 4097 ) // inheriting from typedef
277 struct wxTreeViewItem
: public TV_ITEM
279 wxTreeViewItem(const wxTreeItemId
& item
, // the item handle
280 UINT mask_
, // fields which are valid
281 UINT stateMask_
= 0) // for TVIF_STATE only
283 // hItem member is always valid
284 mask
= mask_
| TVIF_HANDLE
;
285 stateMask
= stateMask_
;
291 #pragma warning( default : 4097 )
294 // a class which encapsulates the tree traversal logic: it vists all (unless
295 // OnVisit() returns FALSE) items under the given one
296 class wxTreeTraversal
299 wxTreeTraversal(const wxTreeCtrl
*tree
)
304 // do traverse the tree: visit all items (recursively by default) under the
305 // given one; return TRUE if all items were traversed or FALSE if the
306 // traversal was aborted because OnVisit returned FALSE
307 bool DoTraverse(const wxTreeItemId
& root
, bool recursively
= TRUE
);
309 // override this function to do whatever is needed for each item, return
310 // FALSE to stop traversing
311 virtual bool OnVisit(const wxTreeItemId
& item
) = 0;
314 const wxTreeCtrl
*GetTree() const { return m_tree
; }
317 bool Traverse(const wxTreeItemId
& root
, bool recursively
);
319 const wxTreeCtrl
*m_tree
;
322 // internal class for getting the selected items
323 class TraverseSelections
: public wxTreeTraversal
326 TraverseSelections(const wxTreeCtrl
*tree
,
327 wxArrayTreeItemIds
& selections
)
328 : wxTreeTraversal(tree
), m_selections(selections
)
330 m_selections
.Empty();
332 DoTraverse(tree
->GetRootItem());
335 virtual bool OnVisit(const wxTreeItemId
& item
)
337 #if wxUSE_CHECKBOXES_IN_MULTI_SEL_TREE
338 if ( GetTree()->IsItemChecked(item
) )
340 if ( ::IsItemSelected(GetHwndOf(GetTree()), HITEM(item
)) )
343 m_selections
.Add(item
);
349 size_t GetCount() const { return m_selections
.GetCount(); }
352 wxArrayTreeItemIds
& m_selections
;
355 // internal class for counting tree items
356 class TraverseCounter
: public wxTreeTraversal
359 TraverseCounter(const wxTreeCtrl
*tree
,
360 const wxTreeItemId
& root
,
362 : wxTreeTraversal(tree
)
366 DoTraverse(root
, recursively
);
369 virtual bool OnVisit(const wxTreeItemId
& item
)
376 size_t GetCount() const { return m_count
; }
382 // ----------------------------------------------------------------------------
383 // This class is needed for support of different images: the Win32 common
384 // control natively supports only 2 images (the normal one and another for the
385 // selected state). We wish to provide support for 2 more of them for folder
386 // items (i.e. those which have children): for expanded state and for expanded
387 // selected state. For this we use this structure to store the additional items
390 // There is only one problem with this: when we retrieve the item's data, we
391 // don't know whether we get a pointer to wxTreeItemData or
392 // wxTreeItemIndirectData. So we have to maintain a list of all items which
393 // have indirect data inside the listctrl itself.
394 // ----------------------------------------------------------------------------
396 class wxTreeItemIndirectData
399 // ctor associates this data with the item and the real item data becomes
400 // available through our GetData() method
401 wxTreeItemIndirectData(wxTreeCtrl
*tree
, const wxTreeItemId
& item
)
403 for ( size_t n
= 0; n
< WXSIZEOF(m_images
); n
++ )
409 m_data
= tree
->GetItemData(item
);
411 // and set ourselves as the new one
412 tree
->SetIndirectItemData(item
, this);
415 // dtor deletes the associated data as well
416 ~wxTreeItemIndirectData() { delete m_data
; }
419 // get the real data associated with the item
420 wxTreeItemData
*GetData() const { return m_data
; }
422 void SetData(wxTreeItemData
*data
) { m_data
= data
; }
424 // do we have such image?
425 bool HasImage(wxTreeItemIcon which
) const { return m_images
[which
] != -1; }
427 int GetImage(wxTreeItemIcon which
) const { return m_images
[which
]; }
429 void SetImage(int image
, wxTreeItemIcon which
) { m_images
[which
] = image
; }
432 // all the images associated with the item
433 int m_images
[wxTreeItemIcon_Max
];
435 wxTreeItemData
*m_data
;
438 // ----------------------------------------------------------------------------
440 // ----------------------------------------------------------------------------
442 IMPLEMENT_DYNAMIC_CLASS(wxTreeCtrl
, wxControl
)
444 // ----------------------------------------------------------------------------
446 // ----------------------------------------------------------------------------
448 // handy table for sending events
449 static const wxEventType g_events
[2][2] =
451 { wxEVT_COMMAND_TREE_ITEM_COLLAPSED
, wxEVT_COMMAND_TREE_ITEM_COLLAPSING
},
452 { wxEVT_COMMAND_TREE_ITEM_EXPANDED
, wxEVT_COMMAND_TREE_ITEM_EXPANDING
}
455 // ============================================================================
457 // ============================================================================
459 // ----------------------------------------------------------------------------
461 // ----------------------------------------------------------------------------
463 bool wxTreeTraversal
::DoTraverse(const wxTreeItemId
& root
, bool recursively
)
465 if ( !OnVisit(root
) )
468 return Traverse(root
, recursively
);
471 bool wxTreeTraversal
::Traverse(const wxTreeItemId
& root
, bool recursively
)
474 wxTreeItemId child
= m_tree
->GetFirstChild(root
, cookie
);
475 while ( child
.IsOk() )
477 // depth first traversal
478 if ( recursively
&& !Traverse(child
, TRUE
) )
481 if ( !OnVisit(child
) )
484 child
= m_tree
->GetNextChild(root
, cookie
);
490 // ----------------------------------------------------------------------------
491 // construction and destruction
492 // ----------------------------------------------------------------------------
494 void wxTreeCtrl
::Init()
496 m_imageListNormal
= NULL
;
497 m_imageListState
= NULL
;
499 m_hasAnyAttr
= FALSE
;
505 bool wxTreeCtrl
::Create(wxWindow
*parent
,
510 const wxValidator
& validator
,
511 const wxString
& name
)
515 if ( !CreateControl(parent
, id
, pos
, size
, style
, validator
, name
) )
518 DWORD wstyle
= WS_VISIBLE
| WS_CHILD
| WS_TABSTOP
|
519 TVS_HASLINES
| TVS_SHOWSELALWAYS
;
521 if ( m_windowStyle
& wxTR_HAS_BUTTONS
)
522 wstyle
|= TVS_HASBUTTONS
;
524 if ( m_windowStyle
& wxTR_EDIT_LABELS
)
525 wstyle
|= TVS_EDITLABELS
;
527 if ( m_windowStyle
& wxTR_LINES_AT_ROOT
)
528 wstyle
|= TVS_LINESATROOT
;
530 // using TVS_CHECKBOXES for emulation of a multiselection tree control
531 // doesn't work without the new enough headers
532 #if wxUSE_CHECKBOXES_IN_MULTI_SEL_TREE && \
533 !defined( __GNUWIN32_OLD__ ) && \
534 !defined( __BORLANDC__ ) && \
535 !defined( __WATCOMC__ ) && \
536 (!defined(__VISUALC__) || (__VISUALC__ > 1010))
538 // we emulate the multiple selection tree controls by using checkboxes: set
539 // up the image list we need for this if we do have multiple selections
540 if ( m_windowStyle
& wxTR_MULTIPLE
)
541 wstyle
|= TVS_CHECKBOXES
;
542 #endif // wxUSE_CHECKBOXES_IN_MULTI_SEL_TREE
544 // Create the tree control.
545 if ( !MSWCreateControl(WC_TREEVIEW
, wstyle
) )
549 SetBackgroundColour(wxSystemSettings
::GetSystemColour(wxSYS_COLOUR_WINDOW
));
551 // This works around a bug in the Windows tree control whereby for some versions
552 // of comctrl32, setting any colour actually draws the background in black.
553 // This will initialise the background to the system colour.
554 ::SendMessage(GetHwnd(), TVM_SETBKCOLOR
, 0,-1);
555 wxWindow
::SetBackgroundColour(wxSystemSettings
::GetSystemColour(wxSYS_COLOUR_WINDOW
));
558 SetForegroundColour(wxWindow
::GetParent()->GetForegroundColour());
560 // VZ: this is some experimental code which may be used to get the
561 // TVS_CHECKBOXES style functionality for comctl32.dll < 4.71.
562 // AFAIK, the standard DLL does about the same thing anyhow.
564 if ( m_windowStyle
& wxTR_MULTIPLE
)
568 // create the DC compatible with the current screen
569 HDC hdcMem
= CreateCompatibleDC(NULL
);
571 // create a mono bitmap of the standard size
572 int x
= GetSystemMetrics(SM_CXMENUCHECK
);
573 int y
= GetSystemMetrics(SM_CYMENUCHECK
);
574 wxImageList
imagelistCheckboxes(x
, y
, FALSE
, 2);
575 HBITMAP hbmpCheck
= CreateBitmap(x
, y
, // bitmap size
576 1, // # of color planes
577 1, // # bits needed for one pixel
578 0); // array containing colour data
579 SelectObject(hdcMem
, hbmpCheck
);
581 // then draw a check mark into it
582 RECT rect
= { 0, 0, x
, y
};
583 if ( !::DrawFrameControl(hdcMem
, &rect
,
585 DFCS_BUTTONCHECK
| DFCS_CHECKED
) )
587 wxLogLastError(wxT("DrawFrameControl(check)"));
590 bmp
.SetHBITMAP((WXHBITMAP
)hbmpCheck
);
591 imagelistCheckboxes
.Add(bmp
);
593 if ( !::DrawFrameControl(hdcMem
, &rect
,
597 wxLogLastError(wxT("DrawFrameControl(uncheck)"));
600 bmp
.SetHBITMAP((WXHBITMAP
)hbmpCheck
);
601 imagelistCheckboxes
.Add(bmp
);
607 SetStateImageList(&imagelistCheckboxes
);
611 SetSize(pos
.x
, pos
.y
, size
.x
, size
.y
);
616 wxTreeCtrl
::~wxTreeCtrl()
618 // delete any attributes
621 for ( wxNode
*node
= m_attrs
.Next(); node
; node
= m_attrs
.Next() )
623 delete (wxTreeItemAttr
*)node
->Data();
626 // prevent TVN_DELETEITEM handler from deleting the attributes again!
627 m_hasAnyAttr
= FALSE
;
632 // delete user data to prevent memory leaks
636 // ----------------------------------------------------------------------------
638 // ----------------------------------------------------------------------------
640 // simple wrappers which add error checking in debug mode
642 bool wxTreeCtrl
::DoGetItem(wxTreeViewItem
* tvItem
) const
644 if ( !TreeView_GetItem(GetHwnd(), tvItem
) )
646 wxLogLastError("TreeView_GetItem");
654 void wxTreeCtrl
::DoSetItem(wxTreeViewItem
* tvItem
)
656 if ( TreeView_SetItem(GetHwnd(), tvItem
) == -1 )
658 wxLogLastError("TreeView_SetItem");
662 size_t wxTreeCtrl
::GetCount() const
664 return (size_t)TreeView_GetCount(GetHwnd());
667 unsigned int wxTreeCtrl
::GetIndent() const
669 return TreeView_GetIndent(GetHwnd());
672 void wxTreeCtrl
::SetIndent(unsigned int indent
)
674 TreeView_SetIndent(GetHwnd(), indent
);
677 wxImageList
*wxTreeCtrl
::GetImageList() const
679 return m_imageListNormal
;
682 wxImageList
*wxTreeCtrl
::GetStateImageList() const
684 return m_imageListNormal
;
687 void wxTreeCtrl
::SetAnyImageList(wxImageList
*imageList
, int which
)
690 TreeView_SetImageList(GetHwnd(),
691 imageList ? imageList
->GetHIMAGELIST() : 0,
695 void wxTreeCtrl
::SetImageList(wxImageList
*imageList
)
697 SetAnyImageList(m_imageListNormal
= imageList
, TVSIL_NORMAL
);
700 void wxTreeCtrl
::SetStateImageList(wxImageList
*imageList
)
702 SetAnyImageList(m_imageListState
= imageList
, TVSIL_STATE
);
705 size_t wxTreeCtrl
::GetChildrenCount(const wxTreeItemId
& item
,
706 bool recursively
) const
708 TraverseCounter
counter(this, item
, recursively
);
710 return counter
.GetCount() - 1;
713 // ----------------------------------------------------------------------------
715 // ----------------------------------------------------------------------------
717 bool wxTreeCtrl
::SetBackgroundColour(const wxColour
&colour
)
719 if ( !wxWindowBase
::SetBackgroundColour(colour
) )
722 SendMessage(GetHwnd(), TVM_SETBKCOLOR
, 0, colour
.GetPixel());
727 bool wxTreeCtrl
::SetForegroundColour(const wxColour
&colour
)
729 if ( !wxWindowBase
::SetForegroundColour(colour
) )
732 SendMessage(GetHwnd(), TVM_SETTEXTCOLOR
, 0, colour
.GetPixel());
737 // ----------------------------------------------------------------------------
739 // ----------------------------------------------------------------------------
741 wxString wxTreeCtrl
::GetItemText(const wxTreeItemId
& item
) const
743 wxChar buf
[512]; // the size is arbitrary...
745 wxTreeViewItem
tvItem(item
, TVIF_TEXT
);
746 tvItem
.pszText
= buf
;
747 tvItem
.cchTextMax
= WXSIZEOF(buf
);
748 if ( !DoGetItem(&tvItem
) )
750 // don't return some garbage which was on stack, but an empty string
754 return wxString(buf
);
757 void wxTreeCtrl
::SetItemText(const wxTreeItemId
& item
, const wxString
& text
)
759 wxTreeViewItem
tvItem(item
, TVIF_TEXT
);
760 tvItem
.pszText
= (wxChar
*)text
.c_str(); // conversion is ok
764 int wxTreeCtrl
::DoGetItemImageFromData(const wxTreeItemId
& item
,
765 wxTreeItemIcon which
) const
767 wxTreeViewItem
tvItem(item
, TVIF_PARAM
);
768 if ( !DoGetItem(&tvItem
) )
773 return ((wxTreeItemIndirectData
*)tvItem
.lParam
)->GetImage(which
);
776 void wxTreeCtrl
::DoSetItemImageFromData(const wxTreeItemId
& item
,
778 wxTreeItemIcon which
) const
780 wxTreeViewItem
tvItem(item
, TVIF_PARAM
);
781 if ( !DoGetItem(&tvItem
) )
786 wxTreeItemIndirectData
*data
= ((wxTreeItemIndirectData
*)tvItem
.lParam
);
788 data
->SetImage(image
, which
);
790 // make sure that we have selected images as well
791 if ( which
== wxTreeItemIcon_Normal
&&
792 !data
->HasImage(wxTreeItemIcon_Selected
) )
794 data
->SetImage(image
, wxTreeItemIcon_Selected
);
797 if ( which
== wxTreeItemIcon_Expanded
&&
798 !data
->HasImage(wxTreeItemIcon_SelectedExpanded
) )
800 data
->SetImage(image
, wxTreeItemIcon_SelectedExpanded
);
804 void wxTreeCtrl
::DoSetItemImages(const wxTreeItemId
& item
,
808 wxTreeViewItem
tvItem(item
, TVIF_IMAGE
| TVIF_SELECTEDIMAGE
);
809 tvItem
.iSelectedImage
= imageSel
;
810 tvItem
.iImage
= image
;
814 int wxTreeCtrl
::GetItemImage(const wxTreeItemId
& item
,
815 wxTreeItemIcon which
) const
817 if ( HasIndirectData(item
) )
819 return DoGetItemImageFromData(item
, which
);
826 wxFAIL_MSG( wxT("unknown tree item image type") );
828 case wxTreeItemIcon_Normal
:
832 case wxTreeItemIcon_Selected
:
833 mask
= TVIF_SELECTEDIMAGE
;
836 case wxTreeItemIcon_Expanded
:
837 case wxTreeItemIcon_SelectedExpanded
:
841 wxTreeViewItem
tvItem(item
, mask
);
844 return mask
== TVIF_IMAGE ? tvItem
.iImage
: tvItem
.iSelectedImage
;
847 void wxTreeCtrl
::SetItemImage(const wxTreeItemId
& item
, int image
,
848 wxTreeItemIcon which
)
850 int imageNormal
, imageSel
;
854 wxFAIL_MSG( wxT("unknown tree item image type") );
856 case wxTreeItemIcon_Normal
:
858 imageSel
= GetItemSelectedImage(item
);
861 case wxTreeItemIcon_Selected
:
862 imageNormal
= GetItemImage(item
);
866 case wxTreeItemIcon_Expanded
:
867 case wxTreeItemIcon_SelectedExpanded
:
868 if ( !HasIndirectData(item
) )
870 // we need to get the old images first, because after we create
871 // the wxTreeItemIndirectData GetItemXXXImage() will use it to
873 imageNormal
= GetItemImage(item
);
874 imageSel
= GetItemSelectedImage(item
);
876 // if it doesn't have it yet, add it
877 wxTreeItemIndirectData
*data
= new
878 wxTreeItemIndirectData(this, item
);
880 // copy the data to the new location
881 data
->SetImage(imageNormal
, wxTreeItemIcon_Normal
);
882 data
->SetImage(imageSel
, wxTreeItemIcon_Selected
);
885 DoSetItemImageFromData(item
, image
, which
);
887 // reset the normal/selected images because we won't use them any
888 // more - now they're stored inside the indirect data
890 imageSel
= I_IMAGECALLBACK
;
894 // NB: at least in version 5.00.0518.9 of comctl32.dll we need to always
895 // change both normal and selected image - otherwise the change simply
896 // doesn't take place!
897 DoSetItemImages(item
, imageNormal
, imageSel
);
900 wxTreeItemData
*wxTreeCtrl
::GetItemData(const wxTreeItemId
& item
) const
902 wxTreeViewItem
tvItem(item
, TVIF_PARAM
);
903 if ( !DoGetItem(&tvItem
) )
908 if ( HasIndirectData(item
) )
910 return ((wxTreeItemIndirectData
*)tvItem
.lParam
)->GetData();
914 return (wxTreeItemData
*)tvItem
.lParam
;
918 void wxTreeCtrl
::SetItemData(const wxTreeItemId
& item
, wxTreeItemData
*data
)
920 wxTreeViewItem
tvItem(item
, TVIF_PARAM
);
922 if ( HasIndirectData(item
) )
924 if ( DoGetItem(&tvItem
) )
926 ((wxTreeItemIndirectData
*)tvItem
.lParam
)->SetData(data
);
930 wxFAIL_MSG( wxT("failed to change tree items data") );
935 tvItem
.lParam
= (LPARAM
)data
;
940 void wxTreeCtrl
::SetIndirectItemData(const wxTreeItemId
& item
,
941 wxTreeItemIndirectData
*data
)
943 // this should never happen because it's unnecessary and will probably lead
944 // to crash too because the code elsewhere supposes that the pointer the
945 // wxTreeItemIndirectData has is a real wxItemData and not
946 // wxTreeItemIndirectData as well
947 wxASSERT_MSG( !HasIndirectData(item
), wxT("setting indirect data twice?") );
949 SetItemData(item
, (wxTreeItemData
*)data
);
951 m_itemsWithIndirectData
.Add(item
);
954 bool wxTreeCtrl
::HasIndirectData(const wxTreeItemId
& item
) const
956 return m_itemsWithIndirectData
.Index(item
) != wxNOT_FOUND
;
959 void wxTreeCtrl
::SetItemHasChildren(const wxTreeItemId
& item
, bool has
)
961 wxTreeViewItem
tvItem(item
, TVIF_CHILDREN
);
962 tvItem
.cChildren
= (int)has
;
966 void wxTreeCtrl
::SetItemBold(const wxTreeItemId
& item
, bool bold
)
968 wxTreeViewItem
tvItem(item
, TVIF_STATE
, TVIS_BOLD
);
969 tvItem
.state
= bold ? TVIS_BOLD
: 0;
973 void wxTreeCtrl
::SetItemDropHighlight(const wxTreeItemId
& item
, bool highlight
)
975 wxTreeViewItem
tvItem(item
, TVIF_STATE
, TVIS_DROPHILITED
);
976 tvItem
.state
= highlight ? TVIS_DROPHILITED
: 0;
980 void wxTreeCtrl
::SetItemTextColour(const wxTreeItemId
& item
,
985 long id
= (long)(WXHTREEITEM
)item
;
986 wxTreeItemAttr
*attr
= (wxTreeItemAttr
*)m_attrs
.Get(id
);
989 attr
= new wxTreeItemAttr
;
990 m_attrs
.Put(id
, (wxObject
*)attr
);
993 attr
->SetTextColour(col
);
996 void wxTreeCtrl
::SetItemBackgroundColour(const wxTreeItemId
& item
,
1001 long id
= (long)(WXHTREEITEM
)item
;
1002 wxTreeItemAttr
*attr
= (wxTreeItemAttr
*)m_attrs
.Get(id
);
1005 attr
= new wxTreeItemAttr
;
1006 m_attrs
.Put(id
, (wxObject
*)attr
);
1009 attr
->SetBackgroundColour(col
);
1012 void wxTreeCtrl
::SetItemFont(const wxTreeItemId
& item
, const wxFont
& font
)
1014 m_hasAnyAttr
= TRUE
;
1016 long id
= (long)(WXHTREEITEM
)item
;
1017 wxTreeItemAttr
*attr
= (wxTreeItemAttr
*)m_attrs
.Get(id
);
1020 attr
= new wxTreeItemAttr
;
1021 m_attrs
.Put(id
, (wxObject
*)attr
);
1024 attr
->SetFont(font
);
1027 // ----------------------------------------------------------------------------
1029 // ----------------------------------------------------------------------------
1031 bool wxTreeCtrl
::IsVisible(const wxTreeItemId
& item
) const
1033 // Bug in Gnu-Win32 headers, so don't use the macro TreeView_GetItemRect
1036 // this ugliness comes directly from MSDN - it *is* the correct way to pass
1037 // the HTREEITEM with TVM_GETITEMRECT
1038 *(WXHTREEITEM
*)&rect
= (WXHTREEITEM
)item
;
1040 // FALSE means get item rect for the whole item, not only text
1041 return SendMessage(GetHwnd(), TVM_GETITEMRECT
, FALSE
, (LPARAM
)&rect
) != 0;
1045 bool wxTreeCtrl
::ItemHasChildren(const wxTreeItemId
& item
) const
1047 wxTreeViewItem
tvItem(item
, TVIF_CHILDREN
);
1050 return tvItem
.cChildren
!= 0;
1053 bool wxTreeCtrl
::IsExpanded(const wxTreeItemId
& item
) const
1055 // probably not a good idea to put it here
1056 //wxASSERT( ItemHasChildren(item) );
1058 wxTreeViewItem
tvItem(item
, TVIF_STATE
, TVIS_EXPANDED
);
1061 return (tvItem
.state
& TVIS_EXPANDED
) != 0;
1064 bool wxTreeCtrl
::IsSelected(const wxTreeItemId
& item
) const
1066 wxTreeViewItem
tvItem(item
, TVIF_STATE
, TVIS_SELECTED
);
1069 return (tvItem
.state
& TVIS_SELECTED
) != 0;
1072 bool wxTreeCtrl
::IsBold(const wxTreeItemId
& item
) const
1074 wxTreeViewItem
tvItem(item
, TVIF_STATE
, TVIS_BOLD
);
1077 return (tvItem
.state
& TVIS_BOLD
) != 0;
1080 // ----------------------------------------------------------------------------
1082 // ----------------------------------------------------------------------------
1084 wxTreeItemId wxTreeCtrl
::GetRootItem() const
1086 return wxTreeItemId((WXHTREEITEM
) TreeView_GetRoot(GetHwnd()));
1089 wxTreeItemId wxTreeCtrl
::GetSelection() const
1091 wxCHECK_MSG( !(m_windowStyle
& wxTR_MULTIPLE
), (WXHTREEITEM
)0,
1092 wxT("this only works with single selection controls") );
1094 return wxTreeItemId((WXHTREEITEM
) TreeView_GetSelection(GetHwnd()));
1097 wxTreeItemId wxTreeCtrl
::GetParent(const wxTreeItemId
& item
) const
1099 return wxTreeItemId((WXHTREEITEM
) TreeView_GetParent(GetHwnd(), HITEM(item
)));
1102 wxTreeItemId wxTreeCtrl
::GetFirstChild(const wxTreeItemId
& item
,
1103 long& _cookie
) const
1105 // remember the last child returned in 'cookie'
1106 _cookie
= (long)TreeView_GetChild(GetHwnd(), HITEM(item
));
1108 return wxTreeItemId((WXHTREEITEM
)_cookie
);
1111 wxTreeItemId wxTreeCtrl
::GetNextChild(const wxTreeItemId
& WXUNUSED(item
),
1112 long& _cookie
) const
1114 wxTreeItemId l
= wxTreeItemId((WXHTREEITEM
)TreeView_GetNextSibling(GetHwnd(),
1121 wxTreeItemId wxTreeCtrl
::GetLastChild(const wxTreeItemId
& item
) const
1123 // can this be done more efficiently?
1126 wxTreeItemId childLast
,
1127 child
= GetFirstChild(item
, cookie
);
1128 while ( child
.IsOk() )
1131 child
= GetNextChild(item
, cookie
);
1137 wxTreeItemId wxTreeCtrl
::GetNextSibling(const wxTreeItemId
& item
) const
1139 return wxTreeItemId((WXHTREEITEM
) TreeView_GetNextSibling(GetHwnd(), HITEM(item
)));
1142 wxTreeItemId wxTreeCtrl
::GetPrevSibling(const wxTreeItemId
& item
) const
1144 return wxTreeItemId((WXHTREEITEM
) TreeView_GetPrevSibling(GetHwnd(), HITEM(item
)));
1147 wxTreeItemId wxTreeCtrl
::GetFirstVisibleItem() const
1149 return wxTreeItemId((WXHTREEITEM
) TreeView_GetFirstVisible(GetHwnd()));
1152 wxTreeItemId wxTreeCtrl
::GetNextVisible(const wxTreeItemId
& item
) const
1154 wxASSERT_MSG( IsVisible(item
), wxT("The item you call GetNextVisible() "
1155 "for must be visible itself!"));
1157 return wxTreeItemId((WXHTREEITEM
) TreeView_GetNextVisible(GetHwnd(), HITEM(item
)));
1160 wxTreeItemId wxTreeCtrl
::GetPrevVisible(const wxTreeItemId
& item
) const
1162 wxASSERT_MSG( IsVisible(item
), wxT("The item you call GetPrevVisible() "
1163 "for must be visible itself!"));
1165 return wxTreeItemId((WXHTREEITEM
) TreeView_GetPrevVisible(GetHwnd(), HITEM(item
)));
1168 // ----------------------------------------------------------------------------
1169 // multiple selections emulation
1170 // ----------------------------------------------------------------------------
1172 bool wxTreeCtrl
::IsItemChecked(const wxTreeItemId
& item
) const
1174 // receive the desired information.
1175 wxTreeViewItem
tvItem(item
, TVIF_STATE
, TVIS_STATEIMAGEMASK
);
1178 // state image indices are 1 based
1179 return ((tvItem
.state
>> 12) - 1) == 1;
1182 void wxTreeCtrl
::SetItemCheck(const wxTreeItemId
& item
, bool check
)
1184 // receive the desired information.
1185 wxTreeViewItem
tvItem(item
, TVIF_STATE
, TVIS_STATEIMAGEMASK
);
1187 // state images are one-based
1188 tvItem
.state
= (check ?
2 : 1) << 12;
1193 size_t wxTreeCtrl
::GetSelections(wxArrayTreeItemIds
& selections
) const
1195 TraverseSelections
selector(this, selections
);
1197 return selector
.GetCount();
1200 // ----------------------------------------------------------------------------
1202 // ----------------------------------------------------------------------------
1204 wxTreeItemId wxTreeCtrl
::DoInsertItem(const wxTreeItemId
& parent
,
1205 wxTreeItemId hInsertAfter
,
1206 const wxString
& text
,
1207 int image
, int selectedImage
,
1208 wxTreeItemData
*data
)
1210 wxCHECK_MSG( parent
.IsOk() || !TreeView_GetRoot(GetHwnd()),
1212 _T("can't have more than one root in the tree") );
1214 TV_INSERTSTRUCT tvIns
;
1215 tvIns
.hParent
= HITEM(parent
);
1216 tvIns
.hInsertAfter
= HITEM(hInsertAfter
);
1218 // this is how we insert the item as the first child: supply a NULL
1220 if ( !tvIns
.hInsertAfter
)
1222 tvIns
.hInsertAfter
= TVI_FIRST
;
1226 if ( !text
.IsEmpty() )
1229 tvIns
.item
.pszText
= (wxChar
*)text
.c_str(); // cast is ok
1235 tvIns
.item
.iImage
= image
;
1237 if ( selectedImage
== -1 )
1239 // take the same image for selected icon if not specified
1240 selectedImage
= image
;
1244 if ( selectedImage
!= -1 )
1246 mask
|= TVIF_SELECTEDIMAGE
;
1247 tvIns
.item
.iSelectedImage
= selectedImage
;
1253 tvIns
.item
.lParam
= (LPARAM
)data
;
1256 tvIns
.item
.mask
= mask
;
1258 HTREEITEM id
= (HTREEITEM
) TreeView_InsertItem(GetHwnd(), &tvIns
);
1261 wxLogLastError("TreeView_InsertItem");
1266 // associate the application tree item with Win32 tree item handle
1267 data
->SetId((WXHTREEITEM
)id
);
1270 return wxTreeItemId((WXHTREEITEM
)id
);
1273 // for compatibility only
1274 wxTreeItemId wxTreeCtrl
::InsertItem(const wxTreeItemId
& parent
,
1275 const wxString
& text
,
1276 int image
, int selImage
,
1279 return DoInsertItem(parent
, (WXHTREEITEM
)insertAfter
, text
,
1280 image
, selImage
, NULL
);
1283 wxTreeItemId wxTreeCtrl
::AddRoot(const wxString
& text
,
1284 int image
, int selectedImage
,
1285 wxTreeItemData
*data
)
1287 return DoInsertItem(wxTreeItemId((WXHTREEITEM
) 0), (WXHTREEITEM
) 0,
1288 text
, image
, selectedImage
, data
);
1291 wxTreeItemId wxTreeCtrl
::PrependItem(const wxTreeItemId
& parent
,
1292 const wxString
& text
,
1293 int image
, int selectedImage
,
1294 wxTreeItemData
*data
)
1296 return DoInsertItem(parent
, (WXHTREEITEM
) TVI_FIRST
,
1297 text
, image
, selectedImage
, data
);
1300 wxTreeItemId wxTreeCtrl
::InsertItem(const wxTreeItemId
& parent
,
1301 const wxTreeItemId
& idPrevious
,
1302 const wxString
& text
,
1303 int image
, int selectedImage
,
1304 wxTreeItemData
*data
)
1306 return DoInsertItem(parent
, idPrevious
, text
, image
, selectedImage
, data
);
1309 wxTreeItemId wxTreeCtrl
::InsertItem(const wxTreeItemId
& parent
,
1311 const wxString
& text
,
1312 int image
, int selectedImage
,
1313 wxTreeItemData
*data
)
1315 // find the item from index
1317 wxTreeItemId idPrev
, idCur
= GetFirstChild(parent
, cookie
);
1318 while ( index
!= 0 && idCur
.IsOk() )
1323 idCur
= GetNextChild(parent
, cookie
);
1326 // assert, not check: if the index is invalid, we will append the item
1328 wxASSERT_MSG( index
== 0, _T("bad index in wxTreeCtrl::InsertItem") );
1330 return DoInsertItem(parent
, idPrev
, text
, image
, selectedImage
, data
);
1333 wxTreeItemId wxTreeCtrl
::AppendItem(const wxTreeItemId
& parent
,
1334 const wxString
& text
,
1335 int image
, int selectedImage
,
1336 wxTreeItemData
*data
)
1338 return DoInsertItem(parent
, (WXHTREEITEM
) TVI_LAST
,
1339 text
, image
, selectedImage
, data
);
1342 void wxTreeCtrl
::Delete(const wxTreeItemId
& item
)
1344 if ( !TreeView_DeleteItem(GetHwnd(), HITEM(item
)) )
1346 wxLogLastError("TreeView_DeleteItem");
1350 // delete all children (but don't delete the item itself)
1351 void wxTreeCtrl
::DeleteChildren(const wxTreeItemId
& item
)
1355 wxArrayLong children
;
1356 wxTreeItemId child
= GetFirstChild(item
, cookie
);
1357 while ( child
.IsOk() )
1359 children
.Add((long)(WXHTREEITEM
)child
);
1361 child
= GetNextChild(item
, cookie
);
1364 size_t nCount
= children
.Count();
1365 for ( size_t n
= 0; n
< nCount
; n
++ )
1367 if ( !TreeView_DeleteItem(GetHwnd(), (HTREEITEM
)children
[n
]) )
1369 wxLogLastError("TreeView_DeleteItem");
1374 void wxTreeCtrl
::DeleteAllItems()
1376 if ( !TreeView_DeleteAllItems(GetHwnd()) )
1378 wxLogLastError("TreeView_DeleteAllItems");
1382 void wxTreeCtrl
::DoExpand(const wxTreeItemId
& item
, int flag
)
1384 wxASSERT_MSG( flag
== TVE_COLLAPSE
||
1385 flag
== (TVE_COLLAPSE
| TVE_COLLAPSERESET
) ||
1386 flag
== TVE_EXPAND
||
1388 wxT("Unknown flag in wxTreeCtrl::DoExpand") );
1390 // TreeView_Expand doesn't send TVN_ITEMEXPAND(ING) messages, so we must
1391 // emulate them. This behaviour has changed slightly with comctl32.dll
1392 // v 4.70 - now it does send them but only the first time. To maintain
1393 // compatible behaviour and also in order to not have surprises with the
1394 // future versions, don't rely on this and still do everything ourselves.
1395 // To avoid that the messages be sent twice when the item is expanded for
1396 // the first time we must clear TVIS_EXPANDEDONCE style manually.
1398 wxTreeViewItem
tvItem(item
, TVIF_STATE
, TVIS_EXPANDEDONCE
);
1402 if ( TreeView_Expand(GetHwnd(), HITEM(item
), flag
) != 0 )
1404 wxTreeEvent
event(wxEVT_NULL
, m_windowId
);
1405 event
.m_item
= item
;
1407 bool isExpanded
= IsExpanded(item
);
1409 event
.SetEventObject(this);
1411 // FIXME return value of {EXPAND|COLLAPS}ING event handler is discarded
1412 event
.SetEventType(g_events
[isExpanded
][TRUE
]);
1413 GetEventHandler()->ProcessEvent(event
);
1415 event
.SetEventType(g_events
[isExpanded
][FALSE
]);
1416 GetEventHandler()->ProcessEvent(event
);
1418 //else: change didn't took place, so do nothing at all
1421 void wxTreeCtrl
::Expand(const wxTreeItemId
& item
)
1423 DoExpand(item
, TVE_EXPAND
);
1426 void wxTreeCtrl
::Collapse(const wxTreeItemId
& item
)
1428 DoExpand(item
, TVE_COLLAPSE
);
1431 void wxTreeCtrl
::CollapseAndReset(const wxTreeItemId
& item
)
1433 DoExpand(item
, TVE_COLLAPSE
| TVE_COLLAPSERESET
);
1436 void wxTreeCtrl
::Toggle(const wxTreeItemId
& item
)
1438 DoExpand(item
, TVE_TOGGLE
);
1441 void wxTreeCtrl
::ExpandItem(const wxTreeItemId
& item
, int action
)
1443 DoExpand(item
, action
);
1446 void wxTreeCtrl
::Unselect()
1448 wxASSERT_MSG( !(m_windowStyle
& wxTR_MULTIPLE
),
1449 wxT("doesn't make sense, may be you want UnselectAll()?") );
1451 // just remove the selection
1452 SelectItem(wxTreeItemId((WXHTREEITEM
) 0));
1455 void wxTreeCtrl
::UnselectAll()
1457 if ( m_windowStyle
& wxTR_MULTIPLE
)
1459 wxArrayTreeItemIds selections
;
1460 size_t count
= GetSelections(selections
);
1461 for ( size_t n
= 0; n
< count
; n
++ )
1463 #if wxUSE_CHECKBOXES_IN_MULTI_SEL_TREE
1464 SetItemCheck(selections
[n
], FALSE
);
1465 #else // !wxUSE_CHECKBOXES_IN_MULTI_SEL_TREE
1466 ::UnselectItem(GetHwnd(), HITEM(selections
[n
]));
1467 #endif // wxUSE_CHECKBOXES_IN_MULTI_SEL_TREE/!wxUSE_CHECKBOXES_IN_MULTI_SEL_TREE
1472 // just remove the selection
1477 void wxTreeCtrl
::SelectItem(const wxTreeItemId
& item
)
1479 if ( m_windowStyle
& wxTR_MULTIPLE
)
1481 #if wxUSE_CHECKBOXES_IN_MULTI_SEL_TREE
1482 // selecting the item means checking it
1484 #else // !wxUSE_CHECKBOXES_IN_MULTI_SEL_TREE
1485 ::SelectItem(GetHwnd(), HITEM(item
));
1486 #endif // wxUSE_CHECKBOXES_IN_MULTI_SEL_TREE/!wxUSE_CHECKBOXES_IN_MULTI_SEL_TREE
1490 // inspite of the docs (MSDN Jan 99 edition), we don't seem to receive
1491 // the notification from the control (i.e. TVN_SELCHANG{ED|ING}), so
1492 // send them ourselves
1494 wxTreeEvent
event(wxEVT_NULL
, m_windowId
);
1495 event
.m_item
= item
;
1496 event
.SetEventObject(this);
1498 event
.SetEventType(wxEVT_COMMAND_TREE_SEL_CHANGING
);
1499 if ( !GetEventHandler()->ProcessEvent(event
) || event
.IsAllowed() )
1501 if ( !TreeView_SelectItem(GetHwnd(), HITEM(item
)) )
1503 wxLogLastError("TreeView_SelectItem");
1507 event
.SetEventType(wxEVT_COMMAND_TREE_SEL_CHANGED
);
1508 (void)GetEventHandler()->ProcessEvent(event
);
1511 //else: program vetoed the change
1515 void wxTreeCtrl
::EnsureVisible(const wxTreeItemId
& item
)
1518 TreeView_EnsureVisible(GetHwnd(), HITEM(item
));
1521 void wxTreeCtrl
::ScrollTo(const wxTreeItemId
& item
)
1523 if ( !TreeView_SelectSetFirstVisible(GetHwnd(), HITEM(item
)) )
1525 wxLogLastError("TreeView_SelectSetFirstVisible");
1529 wxTextCtrl
* wxTreeCtrl
::GetEditControl() const
1531 // normally, we could try to do something like this to return something
1532 // even when the editing was started by the user and not by calling
1533 // EditLabel() - but as nobody has asked for this so far and there might be
1534 // problems in the code below, I leave it disabled for now (VZ)
1538 HWND hwndText
= TreeView_GetEditControl(GetHwnd());
1541 m_textCtrl
= new wxTextCtrl(this, -1);
1543 m_textCtrl
->SetHWND((WXHWND
)hwndText
);
1545 //else: not editing label right now
1552 void wxTreeCtrl
::DeleteTextCtrl()
1556 m_textCtrl
->UnsubclassWin();
1557 m_textCtrl
->SetHWND(0);
1563 wxTextCtrl
* wxTreeCtrl
::EditLabel(const wxTreeItemId
& item
,
1564 wxClassInfo
* textControlClass
)
1566 wxASSERT( textControlClass
->IsKindOf(CLASSINFO(wxTextCtrl
)) );
1570 HWND hWnd
= (HWND
) TreeView_EditLabel(GetHwnd(), HITEM(item
));
1572 // this is not an error - the TVN_BEGINLABELEDIT handler might have
1579 m_textCtrl
= (wxTextCtrl
*)textControlClass
->CreateObject();
1580 m_textCtrl
->SetHWND((WXHWND
)hWnd
);
1581 m_textCtrl
->SubclassWin((WXHWND
)hWnd
);
1586 // End label editing, optionally cancelling the edit
1587 void wxTreeCtrl
::EndEditLabel(const wxTreeItemId
& item
, bool discardChanges
)
1589 TreeView_EndEditLabelNow(GetHwnd(), discardChanges
);
1594 wxTreeItemId wxTreeCtrl
::HitTest(const wxPoint
& point
, int& flags
)
1596 TV_HITTESTINFO hitTestInfo
;
1597 hitTestInfo
.pt
.x
= (int)point
.x
;
1598 hitTestInfo
.pt
.y
= (int)point
.y
;
1600 TreeView_HitTest(GetHwnd(), &hitTestInfo
);
1605 #define TRANSLATE_FLAG(flag) if ( hitTestInfo.flags & TVHT_##flag ) \
1606 flags |= wxTREE_HITTEST_##flag
1608 TRANSLATE_FLAG(ABOVE
);
1609 TRANSLATE_FLAG(BELOW
);
1610 TRANSLATE_FLAG(NOWHERE
);
1611 TRANSLATE_FLAG(ONITEMBUTTON
);
1612 TRANSLATE_FLAG(ONITEMICON
);
1613 TRANSLATE_FLAG(ONITEMINDENT
);
1614 TRANSLATE_FLAG(ONITEMLABEL
);
1615 TRANSLATE_FLAG(ONITEMRIGHT
);
1616 TRANSLATE_FLAG(ONITEMSTATEICON
);
1617 TRANSLATE_FLAG(TOLEFT
);
1618 TRANSLATE_FLAG(TORIGHT
);
1620 #undef TRANSLATE_FLAG
1622 return wxTreeItemId((WXHTREEITEM
) hitTestInfo
.hItem
);
1625 bool wxTreeCtrl
::GetBoundingRect(const wxTreeItemId
& item
,
1627 bool textOnly
) const
1630 if ( TreeView_GetItemRect(GetHwnd(), HITEM(item
),
1633 rect
= wxRect(wxPoint(rc
.left
, rc
.top
), wxPoint(rc
.right
, rc
.bottom
));
1639 // couldn't retrieve rect: for example, item isn't visible
1644 // ----------------------------------------------------------------------------
1646 // ----------------------------------------------------------------------------
1648 static int CALLBACK
TreeView_CompareCallback(wxTreeItemData
*pItem1
,
1649 wxTreeItemData
*pItem2
,
1652 wxCHECK_MSG( pItem1
&& pItem2
, 0,
1653 wxT("sorting tree without data doesn't make sense") );
1655 return tree
->OnCompareItems(pItem1
->GetId(), pItem2
->GetId());
1658 int wxTreeCtrl
::OnCompareItems(const wxTreeItemId
& item1
,
1659 const wxTreeItemId
& item2
)
1661 return wxStrcmp(GetItemText(item1
), GetItemText(item2
));
1664 void wxTreeCtrl
::SortChildren(const wxTreeItemId
& item
)
1666 // rely on the fact that TreeView_SortChildren does the same thing as our
1667 // default behaviour, i.e. sorts items alphabetically and so call it
1668 // directly if we're not in derived class (much more efficient!)
1669 if ( GetClassInfo() == CLASSINFO(wxTreeCtrl
) )
1671 TreeView_SortChildren(GetHwnd(), HITEM(item
), 0);
1676 tvSort
.hParent
= HITEM(item
);
1677 tvSort
.lpfnCompare
= (PFNTVCOMPARE
)TreeView_CompareCallback
;
1678 tvSort
.lParam
= (LPARAM
)this;
1679 TreeView_SortChildrenCB(GetHwnd(), &tvSort
, 0 /* reserved */);
1683 // ----------------------------------------------------------------------------
1685 // ----------------------------------------------------------------------------
1687 bool wxTreeCtrl
::MSWCommand(WXUINT cmd
, WXWORD id
)
1689 if ( cmd
== EN_UPDATE
)
1691 wxCommandEvent
event(wxEVT_COMMAND_TEXT_UPDATED
, id
);
1692 event
.SetEventObject( this );
1693 ProcessCommand(event
);
1695 else if ( cmd
== EN_KILLFOCUS
)
1697 wxCommandEvent
event(wxEVT_KILL_FOCUS
, id
);
1698 event
.SetEventObject( this );
1699 ProcessCommand(event
);
1707 // command processed
1711 // we hook into WndProc to process WM_MOUSEMOVE/WM_BUTTONUP messages - as we
1712 // only do it during dragging, minimize wxWin overhead (this is important for
1713 // WM_MOUSEMOVE as they're a lot of them) by catching Windows messages directly
1714 // instead of passing by wxWin events
1715 long wxTreeCtrl
::MSWWindowProc(WXUINT nMsg
, WXWPARAM wParam
, WXLPARAM lParam
)
1717 bool processed
= FALSE
;
1720 bool isMultiple
= (GetWindowStyle() & wxTR_MULTIPLE
) != 0;
1722 if ( (nMsg
>= WM_MOUSEFIRST
) && (nMsg
<= WM_MOUSELAST
) )
1724 // we only process mouse messages here and these parameters have the same
1725 // meaning for all of them
1726 int x
= GET_X_LPARAM(lParam
),
1727 y
= GET_Y_LPARAM(lParam
);
1728 HTREEITEM htItem
= GetItemFromPoint(GetHwnd(), x
, y
);
1732 #if !wxUSE_CHECKBOXES_IN_MULTI_SEL_TREE
1733 case WM_LBUTTONDOWN
:
1734 if ( htItem
&& isMultiple
)
1736 if ( wParam
& MK_CONTROL
)
1740 // toggle selected state
1741 ToggleItemSelection(GetHwnd(), htItem
);
1743 ::SetFocus(GetHwnd(), htItem
);
1745 // reset on any click without Shift
1750 else if ( wParam
& MK_SHIFT
)
1752 // this selects all items between the starting one and
1755 if ( !m_htSelStart
)
1757 // take the focused item
1758 m_htSelStart
= (WXHTREEITEM
)
1759 TreeView_GetSelection(GetHwnd());
1762 SelectRange(GetHwnd(), HITEM(m_htSelStart
), htItem
,
1763 !(wParam
& MK_CONTROL
));
1765 ::SetFocus(GetHwnd(), htItem
);
1769 else // normal click
1771 // clear the selection and then let the default handler
1775 // prevent the click from starting in-place editing
1776 // when there was no selection in the control
1777 TreeView_SelectItem(GetHwnd(), 0);
1779 // reset on any click without Shift
1784 #endif // wxUSE_CHECKBOXES_IN_MULTI_SEL_TREE
1789 m_dragImage
->Move(wxPoint(x
, y
));
1792 // highlight the item as target (hiding drag image is
1793 // necessary - otherwise the display will be corrupted)
1794 m_dragImage
->Hide();
1795 TreeView_SelectDropTarget(GetHwnd(), htItem
);
1796 m_dragImage
->Show();
1805 m_dragImage
->EndDrag();
1809 // generate the drag end event
1810 wxTreeEvent
event(wxEVT_COMMAND_TREE_END_DRAG
, m_windowId
);
1812 event
.m_item
= (WXHTREEITEM
)htItem
;
1813 event
.m_pointDrag
= wxPoint(x
, y
);
1814 event
.SetEventObject(this);
1816 (void)GetEventHandler()->ProcessEvent(event
);
1818 // if we don't do it, the tree seems to think that 2 items
1819 // are selected simultaneously which is quite weird
1820 TreeView_SelectDropTarget(GetHwnd(), 0);
1825 #if !wxUSE_CHECKBOXES_IN_MULTI_SEL_TREE
1826 else if ( (nMsg
== WM_SETFOCUS
|| nMsg
== WM_KILLFOCUS
) && isMultiple
)
1828 // the tree control greys out the selected item when it loses focus and
1829 // paints it as selected again when it regains it, but it won't do it
1830 // for the other items itself - help it
1831 wxArrayTreeItemIds selections
;
1832 size_t count
= GetSelections(selections
);
1834 for ( size_t n
= 0; n
< count
; n
++ )
1836 // TreeView_GetItemRect() will return FALSE if item is not visible,
1837 // which may happen perfectly well
1838 if ( TreeView_GetItemRect(GetHwnd(), HITEM(selections
[n
]),
1841 ::InvalidateRect(GetHwnd(), &rect
, FALSE
);
1845 else if ( nMsg
== WM_KEYDOWN
&& isMultiple
)
1847 bool bCtrl
= wxIsCtrlDown(),
1848 bShift
= wxIsShiftDown();
1850 // we handle.arrows and space, but not page up/down and home/end: the
1851 // latter should be easy, but not the former
1853 HTREEITEM htSel
= (HTREEITEM
)TreeView_GetSelection(GetHwnd());
1854 if ( !m_htSelStart
)
1856 m_htSelStart
= (WXHTREEITEM
)htSel
;
1859 if ( wParam
== VK_SPACE
)
1863 ToggleItemSelection(GetHwnd(), htSel
);
1869 ::SelectItem(GetHwnd(), htSel
);
1874 else if ( wParam
== VK_UP
|| wParam
== VK_DOWN
)
1876 if ( !bCtrl
&& !bShift
)
1878 // no modifiers, just clear selection and then let the default
1879 // processing to take place
1884 (void)wxControl
::MSWWindowProc(nMsg
, wParam
, lParam
);
1886 HTREEITEM htNext
= (HTREEITEM
)(wParam
== VK_UP
1887 ?
TreeView_GetPrevVisible(GetHwnd(), htSel
)
1888 : TreeView_GetNextVisible(GetHwnd(), htSel
));
1892 // at the top/bottom
1898 SelectRange(GetHwnd(), HITEM(m_htSelStart
), htNext
);
1902 // without changing selection
1903 ::SetFocus(GetHwnd(), htNext
);
1910 #endif // !wxUSE_CHECKBOXES_IN_MULTI_SEL_TREE
1913 rc
= wxControl
::MSWWindowProc(nMsg
, wParam
, lParam
);
1918 // process WM_NOTIFY Windows message
1919 bool wxTreeCtrl
::MSWOnNotify(int idCtrl
, WXLPARAM lParam
, WXLPARAM
*result
)
1921 wxTreeEvent
event(wxEVT_NULL
, m_windowId
);
1922 wxEventType eventType
= wxEVT_NULL
;
1923 NMHDR
*hdr
= (NMHDR
*)lParam
;
1925 switch ( hdr
->code
)
1929 if ( wxControl
::MSWOnNotify(idCtrl
, lParam
, result
) )
1932 TV_HITTESTINFO tvhti
;
1933 ::GetCursorPos(&(tvhti
.pt
));
1934 ::ScreenToClient(GetHwnd(),&(tvhti
.pt
));
1935 if ( TreeView_HitTest(GetHwnd(),&tvhti
) )
1937 if( tvhti
.flags
& TVHT_ONITEM
)
1939 event
.m_item
= (WXHTREEITEM
) tvhti
.hItem
;
1940 eventType
= wxEVT_COMMAND_TREE_ITEM_RIGHT_CLICK
;
1947 eventType
= wxEVT_COMMAND_TREE_BEGIN_DRAG
;
1950 case TVN_BEGINRDRAG
:
1952 if ( eventType
== wxEVT_NULL
)
1953 eventType
= wxEVT_COMMAND_TREE_BEGIN_RDRAG
;
1954 //else: left drag, already set above
1956 NM_TREEVIEW
*tv
= (NM_TREEVIEW
*)lParam
;
1958 event
.m_item
= (WXHTREEITEM
) tv
->itemNew
.hItem
;
1959 event
.m_pointDrag
= wxPoint(tv
->ptDrag
.x
, tv
->ptDrag
.y
);
1961 // don't allow dragging by default: the user code must
1962 // explicitly say that it wants to allow it to avoid breaking
1968 case TVN_BEGINLABELEDIT
:
1970 eventType
= wxEVT_COMMAND_TREE_BEGIN_LABEL_EDIT
;
1971 TV_DISPINFO
*info
= (TV_DISPINFO
*)lParam
;
1973 event
.m_item
= (WXHTREEITEM
) info
->item
.hItem
;
1974 event
.m_label
= info
->item
.pszText
;
1978 case TVN_DELETEITEM
:
1980 eventType
= wxEVT_COMMAND_TREE_DELETE_ITEM
;
1981 NM_TREEVIEW
*tv
= (NM_TREEVIEW
*)lParam
;
1983 event
.m_item
= (WXHTREEITEM
)tv
->itemOld
.hItem
;
1987 delete (wxTreeItemAttr
*)m_attrs
.
1988 Delete((long)tv
->itemOld
.hItem
);
1993 case TVN_ENDLABELEDIT
:
1995 eventType
= wxEVT_COMMAND_TREE_END_LABEL_EDIT
;
1996 TV_DISPINFO
*info
= (TV_DISPINFO
*)lParam
;
1998 event
.m_item
= (WXHTREEITEM
)info
->item
.hItem
;
1999 event
.m_label
= info
->item
.pszText
;
2000 if (info
->item
.pszText
== NULL
)
2005 case TVN_GETDISPINFO
:
2006 eventType
= wxEVT_COMMAND_TREE_GET_INFO
;
2009 case TVN_SETDISPINFO
:
2011 if ( eventType
== wxEVT_NULL
)
2012 eventType
= wxEVT_COMMAND_TREE_SET_INFO
;
2013 //else: get, already set above
2015 TV_DISPINFO
*info
= (TV_DISPINFO
*)lParam
;
2017 event
.m_item
= (WXHTREEITEM
) info
->item
.hItem
;
2021 case TVN_ITEMEXPANDING
:
2022 event
.m_code
= FALSE
;
2025 case TVN_ITEMEXPANDED
:
2027 NM_TREEVIEW
* tv
= (NM_TREEVIEW
*)lParam
;
2029 bool expand
= FALSE
;
2030 switch ( tv
->action
)
2041 wxLogDebug(wxT("unexpected code %d in TVN_ITEMEXPAND "
2042 "message"), tv
->action
);
2045 bool ing
= ((int)hdr
->code
== TVN_ITEMEXPANDING
);
2046 eventType
= g_events
[expand
][ing
];
2048 event
.m_item
= (WXHTREEITEM
) tv
->itemNew
.hItem
;
2054 eventType
= wxEVT_COMMAND_TREE_KEY_DOWN
;
2055 TV_KEYDOWN
*info
= (TV_KEYDOWN
*)lParam
;
2057 event
.m_code
= wxCharCodeMSWToWX(info
->wVKey
);
2059 // a separate event for Space/Return
2060 if ( !wxIsCtrlDown() && !wxIsShiftDown() &&
2061 ((info
->wVKey
== VK_SPACE
) || (info
->wVKey
== VK_RETURN
)) )
2063 wxTreeEvent
event2(wxEVT_COMMAND_TREE_ITEM_ACTIVATED
,
2065 event2
.SetEventObject(this);
2066 if ( !(GetWindowStyle() & wxTR_MULTIPLE
) )
2068 event2
.m_item
= GetSelection();
2070 //else: don't know how to get it
2072 (void)GetEventHandler()->ProcessEvent(event2
);
2077 case TVN_SELCHANGED
:
2078 eventType
= wxEVT_COMMAND_TREE_SEL_CHANGED
;
2081 case TVN_SELCHANGING
:
2083 if ( eventType
== wxEVT_NULL
)
2084 eventType
= wxEVT_COMMAND_TREE_SEL_CHANGING
;
2085 //else: already set above
2087 NM_TREEVIEW
* tv
= (NM_TREEVIEW
*)lParam
;
2089 event
.m_item
= (WXHTREEITEM
) tv
->itemNew
.hItem
;
2090 event
.m_itemOld
= (WXHTREEITEM
) tv
->itemOld
.hItem
;
2094 #if defined(_WIN32_IE) && _WIN32_IE >= 0x300
2097 LPNMTVCUSTOMDRAW lptvcd
= (LPNMTVCUSTOMDRAW
)lParam
;
2098 NMCUSTOMDRAW
& nmcd
= lptvcd
->nmcd
;
2099 switch( nmcd
.dwDrawStage
)
2102 // if we've got any items with non standard attributes,
2103 // notify us before painting each item
2104 *result
= m_hasAnyAttr ? CDRF_NOTIFYITEMDRAW
2108 case CDDS_ITEMPREPAINT
:
2110 wxTreeItemAttr
*attr
=
2111 (wxTreeItemAttr
*)m_attrs
.Get(nmcd
.dwItemSpec
);
2115 // nothing to do for this item
2116 return CDRF_DODEFAULT
;
2120 wxColour colText
, colBack
;
2121 if ( attr
->HasFont() )
2123 wxFont font
= attr
->GetFont();
2124 hFont
= (HFONT
)font
.GetResourceHandle();
2131 if ( attr
->HasTextColour() )
2133 colText
= attr
->GetTextColour();
2137 colText
= GetForegroundColour();
2140 // selection colours should override ours
2141 if ( nmcd
.uItemState
& CDIS_SELECTED
)
2143 DWORD clrBk
= ::GetSysColor(COLOR_HIGHLIGHT
);
2144 lptvcd
->clrTextBk
= clrBk
;
2146 // try to make the text visible
2147 lptvcd
->clrText
= wxColourToRGB(colText
);
2148 lptvcd
->clrText
|= ~clrBk
;
2149 lptvcd
->clrText
&= 0x00ffffff;
2153 if ( attr
->HasBackgroundColour() )
2155 colBack
= attr
->GetBackgroundColour();
2159 colBack
= GetBackgroundColour();
2162 lptvcd
->clrText
= wxColourToRGB(colText
);
2163 lptvcd
->clrTextBk
= wxColourToRGB(colBack
);
2166 // note that if we wanted to set colours for
2167 // individual columns (subitems), we would have
2168 // returned CDRF_NOTIFYSUBITEMREDRAW from here
2171 ::SelectObject(nmcd
.hdc
, hFont
);
2173 *result
= CDRF_NEWFONT
;
2177 *result
= CDRF_DODEFAULT
;
2184 *result
= CDRF_DODEFAULT
;
2189 #endif // _WIN32_IE >= 0x300
2192 return wxControl
::MSWOnNotify(idCtrl
, lParam
, result
);
2195 event
.SetEventObject(this);
2196 event
.SetEventType(eventType
);
2198 bool processed
= GetEventHandler()->ProcessEvent(event
);
2201 switch ( hdr
->code
)
2204 case TVN_BEGINRDRAG
:
2205 if ( event
.IsAllowed() )
2207 // normally this is impossible because the m_dragImage is
2208 // deleted once the drag operation is over
2209 wxASSERT_MSG( !m_dragImage
, _T("starting to drag once again?") );
2211 m_dragImage
= new wxDragImage(*this, event
.m_item
);
2212 m_dragImage
->BeginDrag(wxPoint(0, 0), this);
2213 m_dragImage
->Show();
2217 case TVN_DELETEITEM
:
2219 // NB: we might process this message using wxWindows event
2220 // tables, but due to overhead of wxWin event system we
2221 // prefer to do it here ourself (otherwise deleting a tree
2222 // with many items is just too slow)
2223 NM_TREEVIEW
* tv
= (NM_TREEVIEW
*)lParam
;
2225 wxTreeItemId item
= event
.m_item
;
2226 if ( HasIndirectData(item
) )
2228 wxTreeItemIndirectData
*data
= (wxTreeItemIndirectData
*)
2230 delete data
; // can't be NULL here
2232 m_itemsWithIndirectData
.Remove(item
);
2236 wxTreeItemData
*data
= (wxTreeItemData
*)tv
->itemOld
.lParam
;
2237 delete data
; // may be NULL, ok
2240 processed
= TRUE
; // Make sure we don't get called twice
2244 case TVN_BEGINLABELEDIT
:
2245 // return TRUE to cancel label editing
2246 *result
= !event
.IsAllowed();
2249 case TVN_ENDLABELEDIT
:
2250 // return TRUE to set the label to the new string
2251 *result
= event
.IsAllowed();
2253 // ensure that we don't have the text ctrl which is going to be
2258 case TVN_SELCHANGING
:
2259 case TVN_ITEMEXPANDING
:
2260 // return TRUE to prevent the action from happening
2261 *result
= !event
.IsAllowed();
2264 case TVN_GETDISPINFO
:
2265 // NB: so far the user can't set the image himself anyhow, so do it
2266 // anyway - but this may change later
2267 if ( /* !processed && */ 1 )
2269 wxTreeItemId item
= event
.m_item
;
2270 TV_DISPINFO
*info
= (TV_DISPINFO
*)lParam
;
2271 if ( info
->item
.mask
& TVIF_IMAGE
)
2274 DoGetItemImageFromData
2277 IsExpanded(item
) ? wxTreeItemIcon_Expanded
2278 : wxTreeItemIcon_Normal
2281 if ( info
->item
.mask
& TVIF_SELECTEDIMAGE
)
2283 info
->item
.iSelectedImage
=
2284 DoGetItemImageFromData
2287 IsExpanded(item
) ? wxTreeItemIcon_SelectedExpanded
2288 : wxTreeItemIcon_Selected
2295 // for the other messages the return value is ignored and there is
2296 // nothing special to do
2302 // ----------------------------------------------------------------------------
2304 // ----------------------------------------------------------------------------
2306 IMPLEMENT_DYNAMIC_CLASS(wxTreeEvent
, wxNotifyEvent
)
2308 wxTreeEvent
::wxTreeEvent(wxEventType commandType
, int id
)
2309 : wxNotifyEvent(commandType
, id
)