027d45e8fc
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@38351 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
696 lines
22 KiB
C++
696 lines
22 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/os2/treectrl.h
|
|
// Purpose: wxTreeCtrl class
|
|
// Author: David Webster
|
|
// Modified by:
|
|
// Created: 01/23/03
|
|
// RCS-ID: $Id$
|
|
// Copyright: (c) David Webster
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_TREECTRL_H_
|
|
#define _WX_TREECTRL_H_
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// headers
|
|
// ----------------------------------------------------------------------------
|
|
|
|
#if wxUSE_TREECTRL
|
|
|
|
#include "wx/textctrl.h"
|
|
#include "wx/dynarray.h"
|
|
#include "wx/treebase.h"
|
|
#include "wx/hashmap.h"
|
|
|
|
// the type for "untyped" data
|
|
typedef long wxDataType;
|
|
|
|
// fwd decl
|
|
class WXDLLEXPORT wxImageList;
|
|
class WXDLLEXPORT wxDragImage;
|
|
struct WXDLLEXPORT wxTreeViewItem;
|
|
|
|
// a callback function used for sorting tree items, it should return -1 if the
|
|
// first item precedes the second, +1 if the second precedes the first or 0 if
|
|
// they're equivalent
|
|
class wxTreeItemData;
|
|
|
|
// flags for deprecated InsertItem() variant
|
|
#define wxTREE_INSERT_FIRST 0xFFFF0001
|
|
#define wxTREE_INSERT_LAST 0xFFFF0002
|
|
|
|
// hash storing attributes for our items
|
|
WX_DECLARE_EXPORTED_VOIDPTR_HASH_MAP(wxTreeItemAttr *, wxMapTreeAttr);
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// wxTreeCtrl
|
|
// ----------------------------------------------------------------------------
|
|
class WXDLLEXPORT wxTreeCtrl : public wxControl
|
|
{
|
|
public:
|
|
// creation
|
|
// --------
|
|
wxTreeCtrl() { Init(); }
|
|
|
|
wxTreeCtrl( wxWindow* pParent
|
|
,wxWindowID vId = wxID_ANY
|
|
,const wxPoint& rPos = wxDefaultPosition
|
|
,const wxSize& rSize = wxDefaultSize
|
|
,long lStyle = wxTR_HAS_BUTTONS | wxTR_LINES_AT_ROOT
|
|
,const wxValidator& rValidator = wxDefaultValidator
|
|
,const wxString& rsName = wxTreeCtrlNameStr
|
|
)
|
|
{
|
|
Create( pParent
|
|
,vId
|
|
,rPos
|
|
,rSize
|
|
,lStyle
|
|
,rValidator
|
|
,rsName
|
|
);
|
|
}
|
|
virtual ~wxTreeCtrl();
|
|
|
|
bool Create( wxWindow* pParent
|
|
,wxWindowID vId = wxID_ANY
|
|
,const wxPoint& rPos = wxDefaultPosition
|
|
,const wxSize& rSize = wxDefaultSize
|
|
,long lStyle = wxTR_HAS_BUTTONS | wxTR_LINES_AT_ROOT
|
|
,const wxValidator& rValidator = wxDefaultValidator
|
|
,const wxString& rsName = wxTreeCtrlNameStr
|
|
);
|
|
|
|
//
|
|
// Accessors
|
|
// ---------
|
|
//
|
|
|
|
//
|
|
// Get the total number of items in the control
|
|
//
|
|
virtual unsigned int GetCount(void) const;
|
|
|
|
//
|
|
// Indent is the number of pixels the children are indented relative to
|
|
// the parents position. SetIndent() also redraws the control
|
|
// immediately.
|
|
//
|
|
unsigned int GetIndent(void) const;
|
|
void SetIndent(unsigned int uIndent);
|
|
|
|
//
|
|
// Spacing is the number of pixels between the start and the Text
|
|
//
|
|
unsigned int GetSpacing(void) const { return 18; } // return wxGTK default
|
|
void SetSpacing(unsigned int uSpacing) { }
|
|
|
|
//
|
|
// Image list: these functions allow to associate an image list with
|
|
// the control and retrieve it. Note that the control does _not_ delete
|
|
// the associated image list when it's deleted in order to allow image
|
|
// lists to be shared between different controls.
|
|
//
|
|
// OS/2 doesn't really use imagelists as MSW does, but since the MSW
|
|
// control is the basis for this one, until I decide how to get rid of
|
|
// the need for them they are here for now.
|
|
//
|
|
wxImageList* GetImageList(void) const;
|
|
wxImageList* GetStateImageList(void) const;
|
|
|
|
void AssignImageList(wxImageList* pImageList);
|
|
void AssignStateImageList(wxImageList* pImageList);
|
|
void SetImageList(wxImageList* pImageList);
|
|
void SetStateImageList(wxImageList* pImageList);
|
|
|
|
//
|
|
// Functions to work with tree ctrl items. Unfortunately, they can _not_ be
|
|
// member functions of wxTreeItem because they must know the tree the item
|
|
// belongs to for Windows implementation and storing the pointer to
|
|
// wxTreeCtrl in each wxTreeItem is just too much waste.
|
|
|
|
//
|
|
// Item's label
|
|
//
|
|
wxString GetItemText(const wxTreeItemId& rItem) const;
|
|
void SetItemText( const wxTreeItemId& rItem
|
|
,const wxString& rsText
|
|
);
|
|
|
|
//
|
|
// One of the images associated with the item (normal by default)
|
|
//
|
|
int GetItemImage( const wxTreeItemId& rItem
|
|
,wxTreeItemIcon vWhich = wxTreeItemIcon_Normal
|
|
) const;
|
|
void SetItemImage( const wxTreeItemId& rItem
|
|
,int nImage
|
|
,wxTreeItemIcon vWhich = wxTreeItemIcon_Normal
|
|
);
|
|
|
|
//
|
|
// Data associated with the item
|
|
//
|
|
wxTreeItemData* GetItemData(const wxTreeItemId& rItem) const;
|
|
void SetItemData( const wxTreeItemId& rItem
|
|
,wxTreeItemData* pData
|
|
);
|
|
|
|
//
|
|
// Item's text colour
|
|
//
|
|
wxColour GetItemTextColour(const wxTreeItemId& rItem) const;
|
|
void SetItemTextColour( const wxTreeItemId& rItem
|
|
,const wxColour& rColor
|
|
);
|
|
|
|
//
|
|
// Item's background colour
|
|
//
|
|
wxColour GetItemBackgroundColour(const wxTreeItemId& rItem) const;
|
|
void SetItemBackgroundColour( const wxTreeItemId& rItem
|
|
,const wxColour& rColour
|
|
);
|
|
|
|
//
|
|
// Item's font
|
|
//
|
|
wxFont GetItemFont(const wxTreeItemId& rItem) const;
|
|
void SetItemFont( const wxTreeItemId& rItem
|
|
,const wxFont& rFont
|
|
);
|
|
|
|
//
|
|
// Force appearance of [+] button near the item. This is useful to
|
|
// allow the user to expand the items which don't have any children now
|
|
// - but instead add them only when needed, thus minimizing memory
|
|
// usage and loading time.
|
|
//
|
|
void SetItemHasChildren( const wxTreeItemId& rItem
|
|
,bool bHas = true
|
|
);
|
|
|
|
//
|
|
// The item will be shown in bold
|
|
//
|
|
void SetItemBold( const wxTreeItemId& rItem
|
|
,bool bBold = true
|
|
);
|
|
|
|
//
|
|
// The item will be shown with a drop highlight
|
|
//
|
|
void SetItemDropHighlight( const wxTreeItemId& rItem
|
|
,bool bHighlight = true
|
|
);
|
|
|
|
//
|
|
// Item status inquiries
|
|
// ---------------------
|
|
//
|
|
|
|
//
|
|
// Is the item visible (it might be outside the view or not expanded)?
|
|
//
|
|
bool IsVisible(const wxTreeItemId& rItem) const;
|
|
|
|
//
|
|
// Does the item has any children?
|
|
//
|
|
bool ItemHasChildren(const wxTreeItemId& rItem) const;
|
|
|
|
//
|
|
// Is the item expanded (only makes sense if HasChildren())?
|
|
//
|
|
bool IsExpanded(const wxTreeItemId& rItem) const;
|
|
|
|
//
|
|
// Is this item currently selected (the same as has focus)?
|
|
//
|
|
bool IsSelected(const wxTreeItemId& rItem) const;
|
|
|
|
//
|
|
// Is item text in bold font?
|
|
//
|
|
bool IsBold(const wxTreeItemId& rItem) const;
|
|
|
|
//
|
|
// Number of children
|
|
// ------------------
|
|
//
|
|
|
|
//
|
|
// If 'bRecursively' is false, only immediate children count, otherwise
|
|
// the returned number is the number of all items in this branch
|
|
//
|
|
size_t GetChildrenCount( const wxTreeItemId& rItem
|
|
,bool bRecursively = true
|
|
) const;
|
|
|
|
//
|
|
// Navigation
|
|
// ----------
|
|
//
|
|
|
|
//
|
|
// Get the root tree item
|
|
//
|
|
wxTreeItemId GetRootItem(void) const;
|
|
|
|
//
|
|
// Get the item currently selected (may return NULL if no selection)
|
|
//
|
|
wxTreeItemId GetSelection(void) const;
|
|
|
|
//
|
|
// Get the items currently selected, return the number of such item
|
|
//
|
|
size_t GetSelections(wxArrayTreeItemIds& rSelections) const;
|
|
|
|
//
|
|
// Get the parent of this item (may return NULL if root)
|
|
//
|
|
wxTreeItemId GetItemParent(const wxTreeItemId& rItem) const;
|
|
|
|
// for this enumeration function you must pass in a "cookie" parameter
|
|
// which is opaque for the application but is necessary for the library
|
|
// to make these functions reentrant (i.e. allow more than one
|
|
// enumeration on one and the same object simultaneously). Of course,
|
|
// the "cookie" passed to GetFirstChild() and GetNextChild() should be
|
|
// the same!
|
|
|
|
// get the first child of this item
|
|
wxTreeItemId GetFirstChild(const wxTreeItemId& item,
|
|
wxTreeItemIdValue& cookie) const;
|
|
// get the next child
|
|
wxTreeItemId GetNextChild(const wxTreeItemId& item,
|
|
wxTreeItemIdValue& cookie) const;
|
|
|
|
//
|
|
// Get the last child of this item - this method doesn't use cookies
|
|
//
|
|
wxTreeItemId GetLastChild(const wxTreeItemId& rItem) const;
|
|
|
|
//
|
|
// Get the next sibling of this item
|
|
//
|
|
wxTreeItemId GetNextSibling(const wxTreeItemId& rItem) const;
|
|
|
|
//
|
|
// Get the previous sibling
|
|
//
|
|
wxTreeItemId GetPrevSibling(const wxTreeItemId& rItem) const;
|
|
|
|
//
|
|
// Get first visible item
|
|
//
|
|
wxTreeItemId GetFirstVisibleItem(void) const;
|
|
|
|
//
|
|
// Get the next visible item: item must be visible itself!
|
|
// see IsVisible() and wxTreeCtrl::GetFirstVisibleItem()
|
|
//
|
|
wxTreeItemId GetNextVisible(const wxTreeItemId& rItem) const;
|
|
|
|
//
|
|
// Get the previous visible item: item must be visible itself!
|
|
//
|
|
wxTreeItemId GetPrevVisible(const wxTreeItemId& rItem) const;
|
|
|
|
//
|
|
// Operations
|
|
// ----------
|
|
//
|
|
|
|
//
|
|
// Add the root node to the tree
|
|
//
|
|
wxTreeItemId AddRoot( const wxString& rsText
|
|
,int nImage = -1
|
|
,int nSelectedImage = -1
|
|
,wxTreeItemData* pData = NULL
|
|
);
|
|
|
|
//
|
|
// Insert a new item in as the first child of the parent
|
|
//
|
|
wxTreeItemId PrependItem( const wxTreeItemId& rParent
|
|
,const wxString& rsText
|
|
,int nImage = -1
|
|
,int nSelectedImage = -1
|
|
,wxTreeItemData* pData = NULL
|
|
);
|
|
|
|
//
|
|
// Insert a new item after a given one
|
|
//
|
|
wxTreeItemId InsertItem( const wxTreeItemId& rParent
|
|
,const wxTreeItemId& rIdPrevious
|
|
,const wxString& rsText
|
|
,int nImage = -1
|
|
,int nSelectedImage = -1
|
|
,wxTreeItemData* pData = NULL
|
|
);
|
|
|
|
//
|
|
// Insert a new item before the one with the given index
|
|
//
|
|
wxTreeItemId InsertItem( const wxTreeItemId& pParent
|
|
,size_t nIndex
|
|
,const wxString& rsText
|
|
,int nImage = -1
|
|
,int nSelectedImage = -1
|
|
,wxTreeItemData* pData = NULL
|
|
);
|
|
|
|
//
|
|
// Insert a new item in as the last child of the parent
|
|
//
|
|
wxTreeItemId AppendItem( const wxTreeItemId& rParent
|
|
,const wxString& rsText
|
|
,int nImage = -1
|
|
,int nSelectedImage = -1
|
|
,wxTreeItemData* pData = NULL
|
|
);
|
|
|
|
//
|
|
// Delete this item and associated data if any
|
|
//
|
|
void Delete(const wxTreeItemId& rItem);
|
|
|
|
//
|
|
// Delete all children (but don't delete the item itself)
|
|
//
|
|
void DeleteChildren(const wxTreeItemId& rItem);
|
|
|
|
//
|
|
// Delete all items from the tree
|
|
//
|
|
void DeleteAllItems(void);
|
|
|
|
//
|
|
// Expand this item
|
|
//
|
|
void Expand(const wxTreeItemId& rItem);
|
|
|
|
//
|
|
// Collapse the item without removing its children
|
|
//
|
|
void Collapse(const wxTreeItemId& rItem);
|
|
|
|
//
|
|
// Collapse the item and remove all children
|
|
//
|
|
void CollapseAndReset(const wxTreeItemId& rItem);
|
|
|
|
//
|
|
// Toggles the current state
|
|
//
|
|
void Toggle(const wxTreeItemId& rItem);
|
|
|
|
//
|
|
// Remove the selection from currently selected item (if any)
|
|
//
|
|
void Unselect(void);
|
|
|
|
//
|
|
// Unselect all items (only makes sense for multiple selection control)
|
|
//
|
|
void UnselectAll(void);
|
|
|
|
//
|
|
// Select this item
|
|
//
|
|
void SelectItem(const wxTreeItemId& rItem);
|
|
|
|
//
|
|
// Make sure this item is visible (expanding the parent item and/or
|
|
// scrolling to this item if necessary)
|
|
//
|
|
void EnsureVisible(const wxTreeItemId& rItem);
|
|
|
|
//
|
|
// Scroll to this item (but don't expand its parent)
|
|
//
|
|
void ScrollTo(const wxTreeItemId& rItem);
|
|
|
|
//
|
|
// OS/2 does not use a separate edit field for editting text. Here for
|
|
// interface compatibility, only.
|
|
//
|
|
wxTextCtrl* EditLabel( const wxTreeItemId& rItem
|
|
,wxClassInfo* pTextCtrlClass = CLASSINFO(wxTextCtrl)
|
|
);
|
|
|
|
//
|
|
// returns NULL for OS/2 in ALL cases
|
|
//
|
|
wxTextCtrl* GetEditControl(void) const {return (wxTextCtrl*)NULL;}
|
|
|
|
//
|
|
// End editing and accept or discard the changes to item label
|
|
//
|
|
void EndEditLabel( const wxTreeItemId& rItem
|
|
,bool bDiscardChanges = false
|
|
);
|
|
|
|
//
|
|
// Sorting
|
|
// -------
|
|
//
|
|
|
|
//
|
|
// This function is called to compare 2 items and should return -1, 0
|
|
// or +1 if the first item is less than, equal to or greater than the
|
|
// second one. The base class version performs alphabetic comparaison
|
|
// of item labels (GetText)
|
|
//
|
|
virtual int OnCompareItems( const wxTreeItemId& rItem1
|
|
,const wxTreeItemId& rItem2
|
|
);
|
|
|
|
//
|
|
// Sort the children of this item using OnCompareItems
|
|
//
|
|
void SortChildren(const wxTreeItemId& rItem);
|
|
|
|
//
|
|
// Helpers
|
|
// -------
|
|
//
|
|
|
|
//
|
|
// Determine to which item (if any) belongs the given point (the
|
|
// coordinates specified are relative to the client area of tree ctrl)
|
|
// and fill the flags parameter with a bitmask of wxTREE_HITTEST_xxx
|
|
// constants.
|
|
|
|
//
|
|
// The first function is more portable (because easier to implement
|
|
// on other platforms), but the second one returns some extra info.
|
|
//
|
|
wxTreeItemId HitTest(const wxPoint& rPoint)
|
|
{ int nDummy = 0; return HitTest(rPoint, nDummy); }
|
|
wxTreeItemId HitTest( const wxPoint& rPoint
|
|
,int& rFlags
|
|
);
|
|
|
|
//
|
|
// Get the bounding rectangle of the item (or of its label only)
|
|
//
|
|
bool GetBoundingRect( const wxTreeItemId& rItem
|
|
,wxRect& rRect
|
|
,bool bTextOnly = false
|
|
) const;
|
|
|
|
//
|
|
// Deprecated
|
|
// ----------
|
|
|
|
#if WXWIN_COMPATIBILITY_2_4
|
|
// These methods are deprecated and will be removed in future versions of
|
|
// wxWidgets, they're here for compatibility only, don't use them in new
|
|
// code (the comments indicate why these methods are now useless and how to
|
|
// replace them)
|
|
//
|
|
|
|
//
|
|
// Use Expand, Collapse, CollapseAndReset or Toggle
|
|
//
|
|
wxDEPRECATED( void ExpandItem( const wxTreeItemId& rItem
|
|
,int nAction
|
|
) );
|
|
|
|
//
|
|
// Use AddRoot, PrependItem or AppendItem
|
|
//
|
|
wxDEPRECATED( wxTreeItemId InsertItem( const wxTreeItemId& pParent
|
|
,const wxString& rsText
|
|
,int nImage = -1
|
|
,int nSelImage = -1
|
|
,long lInsertAfter = wxTREE_INSERT_LAST
|
|
) );
|
|
|
|
//
|
|
// Use Set/GetImageList and Set/GetStateImageList
|
|
//
|
|
wxDEPRECATED( wxImageList* GetImageList(int nVal) const );
|
|
wxDEPRECATED( void SetImageList(wxImageList* pImageList, int nVal) );
|
|
|
|
//
|
|
// Use Set/GetItemImage directly
|
|
//
|
|
wxDEPRECATED( int GetItemSelectedImage(const wxTreeItemId& rItem) const );
|
|
wxDEPRECATED( void SetItemSelectedImage(const wxTreeItemId& rItem, int nImage) );
|
|
|
|
//
|
|
// For this enumeration function you must pass in a "cookie" parameter
|
|
// which is opaque for the application but is necessary for the library
|
|
// to make these functions reentrant (i.e. allow more than one
|
|
// enumeration on one and the same object simultaneously). Of course,
|
|
// the "cookie" passed to GetFirstChild() and GetNextChild() should be
|
|
// the same!
|
|
//
|
|
|
|
//
|
|
// Get the first child of this item
|
|
//
|
|
wxDEPRECATED( wxTreeItemId GetFirstChild( const wxTreeItemId& rItem
|
|
,long& rCookie
|
|
) const );
|
|
|
|
//
|
|
// Get the next child
|
|
//
|
|
wxDEPRECATED( wxTreeItemId GetNextChild( const wxTreeItemId& rItem
|
|
,long& rCookie
|
|
) const );
|
|
#endif // WXWIN_COMPATIBILITY_2_4
|
|
|
|
//
|
|
// Implementation
|
|
// --------------
|
|
//
|
|
|
|
virtual MRESULT OS2WindowProc( WXUINT uMsg
|
|
,WXWPARAM wParam
|
|
,WXLPARAM lParam
|
|
);
|
|
virtual bool OS2Command( WXUINT uParam
|
|
,WXWORD wId
|
|
);
|
|
// virtual bool OMSWOnNotify(int idCtrl, WXLPARAM lParam, WXLPARAM *result);
|
|
|
|
//
|
|
// Override some base class virtuals
|
|
//
|
|
virtual bool SetBackgroundColour(const wxColour& rColour);
|
|
virtual bool SetForegroundColour(const wxColour& rColour);
|
|
|
|
//
|
|
// Get/set the check state for the item (only for wxTR_MULTIPLE)
|
|
//
|
|
bool IsItemChecked(const wxTreeItemId& rItem) const;
|
|
void SetItemCheck( const wxTreeItemId& rItem
|
|
,bool bCheck = true
|
|
);
|
|
|
|
protected:
|
|
//
|
|
// SetImageList helper
|
|
//
|
|
void SetAnyImageList( wxImageList* pImageList
|
|
,int nWhich
|
|
);
|
|
|
|
//
|
|
// Refresh a single item
|
|
//
|
|
void RefreshItem(const wxTreeItemId& rItem);
|
|
|
|
wxImageList* m_pImageListNormal; // images for tree elements
|
|
wxImageList* m_pImageListState; // special images for app defined states
|
|
bool m_bOwnsImageListNormal;
|
|
bool m_bOwnsImageListState;
|
|
|
|
private:
|
|
|
|
//
|
|
// The common part of all ctors
|
|
//
|
|
void Init(void);
|
|
|
|
//
|
|
// Helper functions
|
|
//
|
|
inline bool DoGetItem(wxTreeViewItem* pTvItem) const;
|
|
inline void DoSetItem(wxTreeViewItem* pTvItem);
|
|
|
|
inline void DoExpand( const wxTreeItemId& rItem
|
|
,int nFlag
|
|
);
|
|
wxTreeItemId DoInsertItem( const wxTreeItemId& pParent
|
|
,wxTreeItemId hInsertAfter
|
|
,const wxString& rsText
|
|
,int nImage
|
|
,int nSelectedImage
|
|
,wxTreeItemData* pData
|
|
);
|
|
int DoGetItemImageFromData( const wxTreeItemId& rItem
|
|
,wxTreeItemIcon vWhich
|
|
) const;
|
|
void DoSetItemImageFromData( const wxTreeItemId& rItem
|
|
,int nImage
|
|
,wxTreeItemIcon vWhich
|
|
) const;
|
|
void DoSetItemImages( const wxTreeItemId& rItem
|
|
,int nImage
|
|
,int nImageSel
|
|
);
|
|
void DeleteTextCtrl() { };
|
|
|
|
//
|
|
// support for additional item images which we implement using
|
|
// wxTreeItemIndirectData technique - see the comments in msw/treectrl.cpp
|
|
//
|
|
void SetIndirectItemData( const wxTreeItemId& rItem
|
|
,class wxTreeItemIndirectData* pData
|
|
);
|
|
bool HasIndirectData(const wxTreeItemId& rItem) const;
|
|
bool IsDataIndirect(wxTreeItemData* pData) const
|
|
{ return pData && pData->GetId().m_pItem == 0; }
|
|
|
|
//
|
|
// The hash storing the items attributes (indexed by items ids)
|
|
//
|
|
wxMapTreeAttr m_vAttrs;
|
|
|
|
//
|
|
// true if the hash above is not empty
|
|
//
|
|
bool m_bHasAnyAttr;
|
|
|
|
//
|
|
// Used for dragging
|
|
//
|
|
wxDragImage* m_pDragImage;
|
|
|
|
// Virtual root item, if wxTR_HIDE_ROOT is set.
|
|
// void* m_pVirtualRoot;
|
|
|
|
// the starting item for selection with Shift
|
|
// WXHTREEITEM m_htSelStart;
|
|
//
|
|
friend class wxTreeItemIndirectData;
|
|
friend class wxTreeSortHelper;
|
|
|
|
DECLARE_DYNAMIC_CLASS(wxTreeCtrl)
|
|
DECLARE_NO_COPY_CLASS(wxTreeCtrl)
|
|
}; // end of CLASS wxTreeCtrl
|
|
|
|
#endif // wxUSE_TREECTRL
|
|
|
|
#endif
|
|
// _WX_TREECTRL_H_
|