///////////////////////////////////////////////////////////////////////////// // Name: wx/msw/treectrl.h // Purpose: wxTreeCtrl class // Author: Julian Smart // Modified by: Vadim Zeitlin to be less MSW-specific on 10/10/98 // Created: 01/02/97 // Copyright: (c) Julian Smart // Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// #ifndef _WX_MSW_TREECTRL_H_ #define _WX_MSW_TREECTRL_H_ // ---------------------------------------------------------------------------- // headers // ---------------------------------------------------------------------------- #if wxUSE_TREECTRL #include "wx/textctrl.h" #include "wx/dynarray.h" #include "wx/treebase.h" #include "wx/hashmap.h" #ifdef __GNUWIN32__ // Cygwin windows.h defines these identifiers #undef GetFirstChild #undef GetNextSibling #endif // Cygwin // fwd decl class WXDLLIMPEXP_FWD_CORE wxImageList; class WXDLLIMPEXP_FWD_CORE wxDragImage; struct WXDLLIMPEXP_FWD_CORE wxTreeViewItem; // hash storing attributes for our items class wxItemAttr; WX_DECLARE_EXPORTED_VOIDPTR_HASH_MAP(wxItemAttr *, wxMapTreeAttr); // ---------------------------------------------------------------------------- // wxTreeCtrl // ---------------------------------------------------------------------------- class WXDLLIMPEXP_CORE wxTreeCtrl : public wxTreeCtrlBase { public: // creation // -------- wxTreeCtrl() { Init(); } wxTreeCtrl(wxWindow *parent, wxWindowID id = wxID_ANY, const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize, long style = wxTR_HAS_BUTTONS | wxTR_LINES_AT_ROOT, const wxValidator& validator = wxDefaultValidator, const wxString& name = wxASCII_STR(wxTreeCtrlNameStr)) { Create(parent, id, pos, size, style, validator, name); } virtual ~wxTreeCtrl(); bool Create(wxWindow *parent, wxWindowID id = wxID_ANY, const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize, long style = wxTR_HAS_BUTTONS | wxTR_LINES_AT_ROOT, const wxValidator& validator = wxDefaultValidator, const wxString& name = wxASCII_STR(wxTreeCtrlNameStr)); // implement base class pure virtuals // ---------------------------------- virtual unsigned int GetCount() const wxOVERRIDE; virtual unsigned int GetIndent() const wxOVERRIDE; virtual void SetIndent(unsigned int indent) wxOVERRIDE; virtual void SetImageList(wxImageList *imageList) wxOVERRIDE; virtual void SetStateImageList(wxImageList *imageList) wxOVERRIDE; virtual wxString GetItemText(const wxTreeItemId& item) const wxOVERRIDE; virtual int GetItemImage(const wxTreeItemId& item, wxTreeItemIcon which = wxTreeItemIcon_Normal) const wxOVERRIDE; virtual wxTreeItemData *GetItemData(const wxTreeItemId& item) const wxOVERRIDE; virtual wxColour GetItemTextColour(const wxTreeItemId& item) const wxOVERRIDE; virtual wxColour GetItemBackgroundColour(const wxTreeItemId& item) const wxOVERRIDE; virtual wxFont GetItemFont(const wxTreeItemId& item) const wxOVERRIDE; virtual void SetItemText(const wxTreeItemId& item, const wxString& text) wxOVERRIDE; virtual void SetItemImage(const wxTreeItemId& item, int image, wxTreeItemIcon which = wxTreeItemIcon_Normal) wxOVERRIDE; virtual void SetItemData(const wxTreeItemId& item, wxTreeItemData *data) wxOVERRIDE; virtual void SetItemHasChildren(const wxTreeItemId& item, bool has = true) wxOVERRIDE; virtual void SetItemBold(const wxTreeItemId& item, bool bold = true) wxOVERRIDE; virtual void SetItemDropHighlight(const wxTreeItemId& item, bool highlight = true) wxOVERRIDE; virtual void SetItemTextColour(const wxTreeItemId& item, const wxColour& col) wxOVERRIDE; virtual void SetItemBackgroundColour(const wxTreeItemId& item, const wxColour& col) wxOVERRIDE; virtual void SetItemFont(const wxTreeItemId& item, const wxFont& font) wxOVERRIDE; // item status inquiries // --------------------- virtual bool IsVisible(const wxTreeItemId& item) const wxOVERRIDE; virtual bool ItemHasChildren(const wxTreeItemId& item) const wxOVERRIDE; virtual bool IsExpanded(const wxTreeItemId& item) const wxOVERRIDE; virtual bool IsSelected(const wxTreeItemId& item) const wxOVERRIDE; virtual bool IsBold(const wxTreeItemId& item) const wxOVERRIDE; virtual size_t GetChildrenCount(const wxTreeItemId& item, bool recursively = true) const wxOVERRIDE; // navigation // ---------- virtual wxTreeItemId GetRootItem() const wxOVERRIDE; virtual wxTreeItemId GetSelection() const wxOVERRIDE; virtual size_t GetSelections(wxArrayTreeItemIds& selections) const wxOVERRIDE; virtual wxTreeItemId GetFocusedItem() const wxOVERRIDE; virtual void ClearFocusedItem() wxOVERRIDE; virtual void SetFocusedItem(const wxTreeItemId& item) wxOVERRIDE; virtual wxTreeItemId GetItemParent(const wxTreeItemId& item) const wxOVERRIDE; virtual wxTreeItemId GetFirstChild(const wxTreeItemId& item, wxTreeItemIdValue& cookie) const wxOVERRIDE; virtual wxTreeItemId GetNextChild(const wxTreeItemId& item, wxTreeItemIdValue& cookie) const wxOVERRIDE; virtual wxTreeItemId GetLastChild(const wxTreeItemId& item) const wxOVERRIDE; virtual wxTreeItemId GetNextSibling(const wxTreeItemId& item) const wxOVERRIDE; virtual wxTreeItemId GetPrevSibling(const wxTreeItemId& item) const wxOVERRIDE; virtual wxTreeItemId GetFirstVisibleItem() const wxOVERRIDE; virtual wxTreeItemId GetNextVisible(const wxTreeItemId& item) const wxOVERRIDE; virtual wxTreeItemId GetPrevVisible(const wxTreeItemId& item) const wxOVERRIDE; // operations // ---------- virtual wxTreeItemId AddRoot(const wxString& text, int image = -1, int selectedImage = -1, wxTreeItemData *data = NULL) wxOVERRIDE; virtual void Delete(const wxTreeItemId& item) wxOVERRIDE; virtual void DeleteChildren(const wxTreeItemId& item) wxOVERRIDE; virtual void DeleteAllItems() wxOVERRIDE; virtual void Expand(const wxTreeItemId& item) wxOVERRIDE; virtual void Collapse(const wxTreeItemId& item) wxOVERRIDE; virtual void CollapseAndReset(const wxTreeItemId& item) wxOVERRIDE; virtual void Toggle(const wxTreeItemId& item) wxOVERRIDE; virtual void Unselect() wxOVERRIDE; virtual void UnselectAll() wxOVERRIDE; virtual void SelectItem(const wxTreeItemId& item, bool select = true) wxOVERRIDE; virtual void SelectChildren(const wxTreeItemId& parent) wxOVERRIDE; virtual void EnsureVisible(const wxTreeItemId& item) wxOVERRIDE; virtual void ScrollTo(const wxTreeItemId& item) wxOVERRIDE; virtual wxTextCtrl *EditLabel(const wxTreeItemId& item, wxClassInfo* textCtrlClass = wxCLASSINFO(wxTextCtrl)) wxOVERRIDE; virtual wxTextCtrl *GetEditControl() const wxOVERRIDE; virtual void EndEditLabel(const wxTreeItemId& WXUNUSED(item), bool discardChanges = false) wxOVERRIDE { DoEndEditLabel(discardChanges); } virtual void SortChildren(const wxTreeItemId& item) wxOVERRIDE; virtual bool GetBoundingRect(const wxTreeItemId& item, wxRect& rect, bool textOnly = false) const wxOVERRIDE; // implementation // -------------- virtual wxVisualAttributes GetDefaultAttributes() const wxOVERRIDE { return GetClassDefaultAttributes(GetWindowVariant()); } static wxVisualAttributes GetClassDefaultAttributes(wxWindowVariant variant = wxWINDOW_VARIANT_NORMAL); virtual WXLRESULT MSWWindowProc(WXUINT nMsg, WXWPARAM wParam, WXLPARAM lParam) wxOVERRIDE; virtual WXLRESULT MSWDefWindowProc(WXUINT nMsg, WXWPARAM wParam, WXLPARAM lParam) wxOVERRIDE; virtual bool MSWCommand(WXUINT param, WXWORD id) wxOVERRIDE; virtual bool MSWOnNotify(int idCtrl, WXLPARAM lParam, WXLPARAM *result) wxOVERRIDE; virtual bool MSWShouldPreProcessMessage(WXMSG* msg) wxOVERRIDE; // override some base class virtuals virtual bool SetBackgroundColour(const wxColour &colour) wxOVERRIDE; virtual bool SetForegroundColour(const wxColour &colour) wxOVERRIDE; // returns true if the platform should explicitly apply a theme border virtual bool CanApplyThemeBorder() const wxOVERRIDE { return false; } virtual bool IsDoubleBuffered() const wxOVERRIDE; virtual void SetDoubleBuffered(bool on) wxOVERRIDE; protected: // Implement "update locking" in a custom way for this control. virtual void DoFreeze() wxOVERRIDE; virtual void DoThaw() wxOVERRIDE; virtual bool MSWShouldSetDefaultFont() const wxOVERRIDE { return false; } // SetImageList helper void SetAnyImageList(wxImageList *imageList, int which); // refresh a single item void RefreshItem(const wxTreeItemId& item); // end edit label void DoEndEditLabel(bool discardChanges = false); virtual int DoGetItemState(const wxTreeItemId& item) const wxOVERRIDE; virtual void DoSetItemState(const wxTreeItemId& item, int state) wxOVERRIDE; virtual wxTreeItemId DoInsertItem(const wxTreeItemId& parent, size_t pos, const wxString& text, int image, int selectedImage, wxTreeItemData *data) wxOVERRIDE; virtual wxTreeItemId DoInsertAfter(const wxTreeItemId& parent, const wxTreeItemId& idPrevious, const wxString& text, int image = -1, int selImage = -1, wxTreeItemData *data = NULL) wxOVERRIDE; virtual wxTreeItemId DoTreeHitTest(const wxPoint& point, int& flags) const wxOVERRIDE; // obtain the user data for the lParam member of TV_ITEM class wxTreeItemParam *GetItemParam(const wxTreeItemId& item) const; // update the event to include the items client data and pass it to // HandleWindowEvent(), return true if it processed it bool HandleTreeEvent(wxTreeEvent& event) const; // pass the event to HandleTreeEvent() and return true if the event was // either unprocessed or not vetoed bool IsTreeEventAllowed(wxTreeEvent& event) const { return !HandleTreeEvent(event) || event.IsAllowed(); } // generate a wxEVT_KEY_DOWN event from the specified WPARAM/LPARAM values // having the same meaning as for WM_KEYDOWN, return true if it was // processed bool MSWHandleTreeKeyDownEvent(WXWPARAM wParam, WXLPARAM lParam); // handle a key event in a multi-selection control, should be only called // for keys which can be used to change the selection // // return true if the key was processed, false otherwise bool MSWHandleSelectionKey(unsigned vkey); virtual void MSWUpdateFontOnDPIChange(const wxSize& newDPI) wxOVERRIDE; // data used only while editing the item label: wxTextCtrl *m_textCtrl; // text control in which it is edited wxTreeItemId m_idEdited; // the item being edited private: // the common part of all ctors void Init(); // helper functions bool DoGetItem(wxTreeViewItem *tvItem) const; void DoSetItem(wxTreeViewItem *tvItem); void DoExpand(const wxTreeItemId& item, int flag); void DoSelectItem(const wxTreeItemId& item, bool select = true); void DoUnselectItem(const wxTreeItemId& item); void DoToggleItemSelection(const wxTreeItemId& item); void DoUnselectAll(); void DoSelectChildren(const wxTreeItemId& parent); void DeleteTextCtrl(); // return true if the item is the hidden root one (i.e. it's the root item // and the tree has wxTR_HIDE_ROOT style) bool IsHiddenRoot(const wxTreeItemId& item) const; // check if the given flags (taken from TV_HITTESTINFO structure) // indicate a position "on item": this is less trivial than just checking // for TVHT_ONITEM because we consider that points to the left and right of // item text are also "on item" when wxTR_FULL_ROW_HIGHLIGHT is used as the // item visually spans the entire breadth of the window then bool MSWIsOnItem(unsigned flags) const; // Delete the given item from the native control. bool MSWDeleteItem(const wxTreeItemId& item); // the hash storing the items attributes (indexed by item ids) wxMapTreeAttr m_attrs; // true if the hash above is not empty bool m_hasAnyAttr; #if wxUSE_DRAGIMAGE // used for dragging wxDragImage *m_dragImage; #endif // Virtual root item, if wxTR_HIDE_ROOT is set. void* m_pVirtualRoot; // Item to call EnsureVisible() on when the tree is thawed, if necessary. wxTreeItemId m_htEnsureVisibleOnThaw; // the starting item for selection with Shift wxTreeItemId m_htSelStart, m_htClickedItem; wxPoint m_ptClick; // whether dragging has started bool m_dragStarted; // whether focus was lost between subsequent clicks of a single item bool m_focusLost; // set when we are changing selection ourselves (only used in multi // selection mode) bool m_changingSelection; // whether we need to trigger a state image click event bool m_triggerStateImageClick; // whether we need to deselect other items on mouse up bool m_mouseUpDeselect; friend class wxTreeItemIndirectData; friend class wxTreeSortHelper; wxDECLARE_DYNAMIC_CLASS(wxTreeCtrl); wxDECLARE_NO_COPY_CLASS(wxTreeCtrl); }; #endif // wxUSE_TREECTRL #endif // _WX_MSW_TREECTRL_H_