3f66f6a5b3
This keyword is not expanded by Git which means it's not replaced with the correct revision value in the releases made using git-based scripts and it's confusing to have lines with unexpanded "$Id$" in the released files. As expanding them with Git is not that simple (it could be done with git archive and export-subst attribute) and there are not many benefits in having them in the first place, just remove all these lines. If nothing else, this will make an eventual transition to Git simpler. Closes #14487. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@74602 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
396 lines
15 KiB
C++
396 lines
15 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/generic/treectlg.h
|
|
// Purpose: wxTreeCtrl class
|
|
// Author: Robert Roebling
|
|
// Modified by:
|
|
// Created: 01/02/97
|
|
// Copyright: (c) 1997,1998 Robert Roebling
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _GENERIC_TREECTRL_H_
|
|
#define _GENERIC_TREECTRL_H_
|
|
|
|
#if wxUSE_TREECTRL
|
|
|
|
#include "wx/scrolwin.h"
|
|
#include "wx/pen.h"
|
|
|
|
// -----------------------------------------------------------------------------
|
|
// forward declaration
|
|
// -----------------------------------------------------------------------------
|
|
|
|
class WXDLLIMPEXP_FWD_CORE wxGenericTreeItem;
|
|
|
|
class WXDLLIMPEXP_FWD_CORE wxTreeItemData;
|
|
|
|
class WXDLLIMPEXP_FWD_CORE wxTreeRenameTimer;
|
|
class WXDLLIMPEXP_FWD_CORE wxTreeFindTimer;
|
|
class WXDLLIMPEXP_FWD_CORE wxTreeTextCtrl;
|
|
class WXDLLIMPEXP_FWD_CORE wxTextCtrl;
|
|
|
|
// -----------------------------------------------------------------------------
|
|
// wxGenericTreeCtrl - the tree control
|
|
// -----------------------------------------------------------------------------
|
|
|
|
class WXDLLIMPEXP_CORE wxGenericTreeCtrl : public wxTreeCtrlBase,
|
|
public wxScrollHelper
|
|
{
|
|
public:
|
|
// creation
|
|
// --------
|
|
|
|
wxGenericTreeCtrl() : wxTreeCtrlBase(), wxScrollHelper(this) { Init(); }
|
|
|
|
wxGenericTreeCtrl(wxWindow *parent, wxWindowID id = wxID_ANY,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = wxTR_DEFAULT_STYLE,
|
|
const wxValidator &validator = wxDefaultValidator,
|
|
const wxString& name = wxTreeCtrlNameStr)
|
|
: wxTreeCtrlBase(),
|
|
wxScrollHelper(this)
|
|
{
|
|
Init();
|
|
Create(parent, id, pos, size, style, validator, name);
|
|
}
|
|
|
|
virtual ~wxGenericTreeCtrl();
|
|
|
|
bool Create(wxWindow *parent, wxWindowID id = wxID_ANY,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = wxTR_DEFAULT_STYLE,
|
|
const wxValidator &validator = wxDefaultValidator,
|
|
const wxString& name = wxTreeCtrlNameStr);
|
|
|
|
// implement base class pure virtuals
|
|
// ----------------------------------
|
|
|
|
virtual unsigned int GetCount() const;
|
|
|
|
virtual unsigned int GetIndent() const { return m_indent; }
|
|
virtual void SetIndent(unsigned int indent);
|
|
|
|
|
|
virtual void SetImageList(wxImageList *imageList);
|
|
virtual void SetStateImageList(wxImageList *imageList);
|
|
|
|
virtual wxString GetItemText(const wxTreeItemId& item) const;
|
|
virtual int GetItemImage(const wxTreeItemId& item,
|
|
wxTreeItemIcon which = wxTreeItemIcon_Normal) const;
|
|
virtual wxTreeItemData *GetItemData(const wxTreeItemId& item) const;
|
|
virtual wxColour GetItemTextColour(const wxTreeItemId& item) const;
|
|
virtual wxColour GetItemBackgroundColour(const wxTreeItemId& item) const;
|
|
virtual wxFont GetItemFont(const wxTreeItemId& item) const;
|
|
|
|
virtual void SetItemText(const wxTreeItemId& item, const wxString& text);
|
|
virtual void SetItemImage(const wxTreeItemId& item,
|
|
int image,
|
|
wxTreeItemIcon which = wxTreeItemIcon_Normal);
|
|
virtual void SetItemData(const wxTreeItemId& item, wxTreeItemData *data);
|
|
|
|
virtual void SetItemHasChildren(const wxTreeItemId& item, bool has = true);
|
|
virtual void SetItemBold(const wxTreeItemId& item, bool bold = true);
|
|
virtual void SetItemDropHighlight(const wxTreeItemId& item, bool highlight = true);
|
|
virtual void SetItemTextColour(const wxTreeItemId& item, const wxColour& col);
|
|
virtual void SetItemBackgroundColour(const wxTreeItemId& item, const wxColour& col);
|
|
virtual void SetItemFont(const wxTreeItemId& item, const wxFont& font);
|
|
|
|
virtual bool IsVisible(const wxTreeItemId& item) const;
|
|
virtual bool ItemHasChildren(const wxTreeItemId& item) const;
|
|
virtual bool IsExpanded(const wxTreeItemId& item) const;
|
|
virtual bool IsSelected(const wxTreeItemId& item) const;
|
|
virtual bool IsBold(const wxTreeItemId& item) const;
|
|
|
|
virtual size_t GetChildrenCount(const wxTreeItemId& item,
|
|
bool recursively = true) const;
|
|
|
|
// navigation
|
|
// ----------
|
|
|
|
virtual wxTreeItemId GetRootItem() const { return m_anchor; }
|
|
virtual wxTreeItemId GetSelection() const
|
|
{
|
|
wxASSERT_MSG( !HasFlag(wxTR_MULTIPLE),
|
|
wxT("must use GetSelections() with this control") );
|
|
|
|
return m_current;
|
|
}
|
|
virtual size_t GetSelections(wxArrayTreeItemIds&) const;
|
|
virtual wxTreeItemId GetFocusedItem() const { return m_current; }
|
|
|
|
virtual void ClearFocusedItem();
|
|
virtual void SetFocusedItem(const wxTreeItemId& item);
|
|
|
|
virtual wxTreeItemId GetItemParent(const wxTreeItemId& item) const;
|
|
virtual wxTreeItemId GetFirstChild(const wxTreeItemId& item,
|
|
wxTreeItemIdValue& cookie) const;
|
|
virtual wxTreeItemId GetNextChild(const wxTreeItemId& item,
|
|
wxTreeItemIdValue& cookie) const;
|
|
virtual wxTreeItemId GetLastChild(const wxTreeItemId& item) const;
|
|
virtual wxTreeItemId GetNextSibling(const wxTreeItemId& item) const;
|
|
virtual wxTreeItemId GetPrevSibling(const wxTreeItemId& item) const;
|
|
|
|
virtual wxTreeItemId GetFirstVisibleItem() const;
|
|
virtual wxTreeItemId GetNextVisible(const wxTreeItemId& item) const;
|
|
virtual wxTreeItemId GetPrevVisible(const wxTreeItemId& item) const;
|
|
|
|
|
|
// operations
|
|
// ----------
|
|
|
|
virtual wxTreeItemId AddRoot(const wxString& text,
|
|
int image = -1, int selectedImage = -1,
|
|
wxTreeItemData *data = NULL);
|
|
|
|
virtual void Delete(const wxTreeItemId& item);
|
|
virtual void DeleteChildren(const wxTreeItemId& item);
|
|
virtual void DeleteAllItems();
|
|
|
|
virtual void Expand(const wxTreeItemId& item);
|
|
virtual void Collapse(const wxTreeItemId& item);
|
|
virtual void CollapseAndReset(const wxTreeItemId& item);
|
|
virtual void Toggle(const wxTreeItemId& item);
|
|
|
|
virtual void Unselect();
|
|
virtual void UnselectAll();
|
|
virtual void SelectItem(const wxTreeItemId& item, bool select = true);
|
|
virtual void SelectChildren(const wxTreeItemId& parent);
|
|
|
|
virtual void EnsureVisible(const wxTreeItemId& item);
|
|
virtual void ScrollTo(const wxTreeItemId& item);
|
|
|
|
virtual wxTextCtrl *EditLabel(const wxTreeItemId& item,
|
|
wxClassInfo* textCtrlClass = wxCLASSINFO(wxTextCtrl));
|
|
virtual wxTextCtrl *GetEditControl() const;
|
|
virtual void EndEditLabel(const wxTreeItemId& item,
|
|
bool discardChanges = false);
|
|
|
|
virtual void EnableBellOnNoMatch(bool on = true);
|
|
|
|
virtual void SortChildren(const wxTreeItemId& item);
|
|
|
|
// items geometry
|
|
// --------------
|
|
|
|
virtual bool GetBoundingRect(const wxTreeItemId& item,
|
|
wxRect& rect,
|
|
bool textOnly = false) const;
|
|
|
|
|
|
// this version specific methods
|
|
// -----------------------------
|
|
|
|
wxImageList *GetButtonsImageList() const { return m_imageListButtons; }
|
|
void SetButtonsImageList(wxImageList *imageList);
|
|
void AssignButtonsImageList(wxImageList *imageList);
|
|
|
|
void SetDropEffectAboveItem( bool above = false ) { m_dropEffectAboveItem = above; }
|
|
bool GetDropEffectAboveItem() const { return m_dropEffectAboveItem; }
|
|
|
|
wxTreeItemId GetNext(const wxTreeItemId& item) const;
|
|
|
|
#if WXWIN_COMPATIBILITY_2_6
|
|
// use EditLabel() instead
|
|
void Edit( const wxTreeItemId& item ) { EditLabel(item); }
|
|
#endif // WXWIN_COMPATIBILITY_2_6
|
|
|
|
// implementation only from now on
|
|
|
|
// overridden base class virtuals
|
|
virtual bool SetBackgroundColour(const wxColour& colour);
|
|
virtual bool SetForegroundColour(const wxColour& colour);
|
|
|
|
virtual void Refresh(bool eraseBackground = true, const wxRect *rect = NULL);
|
|
|
|
virtual bool SetFont( const wxFont &font );
|
|
virtual void SetWindowStyle(const long styles);
|
|
|
|
// callbacks
|
|
void OnPaint( wxPaintEvent &event );
|
|
void OnSetFocus( wxFocusEvent &event );
|
|
void OnKillFocus( wxFocusEvent &event );
|
|
void OnKeyDown( wxKeyEvent &event );
|
|
void OnChar( wxKeyEvent &event );
|
|
void OnMouse( wxMouseEvent &event );
|
|
void OnGetToolTip( wxTreeEvent &event );
|
|
void OnSize( wxSizeEvent &event );
|
|
void OnInternalIdle( );
|
|
|
|
virtual wxVisualAttributes GetDefaultAttributes() const
|
|
{
|
|
return GetClassDefaultAttributes(GetWindowVariant());
|
|
}
|
|
|
|
static wxVisualAttributes
|
|
GetClassDefaultAttributes(wxWindowVariant variant = wxWINDOW_VARIANT_NORMAL);
|
|
|
|
// implementation helpers
|
|
void AdjustMyScrollbars();
|
|
|
|
WX_FORWARD_TO_SCROLL_HELPER()
|
|
|
|
protected:
|
|
friend class wxGenericTreeItem;
|
|
friend class wxTreeRenameTimer;
|
|
friend class wxTreeFindTimer;
|
|
friend class wxTreeTextCtrl;
|
|
|
|
wxFont m_normalFont;
|
|
wxFont m_boldFont;
|
|
|
|
wxGenericTreeItem *m_anchor;
|
|
wxGenericTreeItem *m_current,
|
|
*m_key_current,
|
|
// A hint to select a parent item after deleting a child
|
|
*m_select_me;
|
|
unsigned short m_indent;
|
|
int m_lineHeight;
|
|
wxPen m_dottedPen;
|
|
wxBrush *m_hilightBrush,
|
|
*m_hilightUnfocusedBrush;
|
|
bool m_hasFocus;
|
|
bool m_dirty;
|
|
bool m_ownsImageListButtons;
|
|
bool m_isDragging; // true between BEGIN/END drag events
|
|
bool m_lastOnSame; // last click on the same item as prev
|
|
wxImageList *m_imageListButtons;
|
|
|
|
int m_dragCount;
|
|
wxPoint m_dragStart;
|
|
wxGenericTreeItem *m_dropTarget;
|
|
wxCursor m_oldCursor; // cursor is changed while dragging
|
|
wxGenericTreeItem *m_oldSelection;
|
|
wxGenericTreeItem *m_underMouse; // for visual effects
|
|
|
|
enum { NoEffect, BorderEffect, AboveEffect, BelowEffect } m_dndEffect;
|
|
wxGenericTreeItem *m_dndEffectItem;
|
|
|
|
wxTreeTextCtrl *m_textCtrl;
|
|
|
|
|
|
wxTimer *m_renameTimer;
|
|
|
|
// incremental search data
|
|
wxString m_findPrefix;
|
|
wxTimer *m_findTimer;
|
|
// This flag is set to 0 if the bell is disabled, 1 if it is enabled and -1
|
|
// if it is globally enabled but has been temporarily disabled because we
|
|
// had already beeped for this particular search.
|
|
int m_findBell;
|
|
|
|
bool m_dropEffectAboveItem;
|
|
|
|
// the common part of all ctors
|
|
void Init();
|
|
|
|
// overridden wxWindow methods
|
|
virtual void DoThaw();
|
|
|
|
// misc helpers
|
|
void SendDeleteEvent(wxGenericTreeItem *itemBeingDeleted);
|
|
|
|
void DrawBorder(const wxTreeItemId& item);
|
|
void DrawLine(const wxTreeItemId& item, bool below);
|
|
void DrawDropEffect(wxGenericTreeItem *item);
|
|
|
|
void DoSelectItem(const wxTreeItemId& id,
|
|
bool unselect_others = true,
|
|
bool extended_select = false);
|
|
|
|
virtual int DoGetItemState(const wxTreeItemId& item) const;
|
|
virtual void DoSetItemState(const wxTreeItemId& item, int state);
|
|
|
|
virtual wxTreeItemId DoInsertItem(const wxTreeItemId& parent,
|
|
size_t previous,
|
|
const wxString& text,
|
|
int image,
|
|
int selectedImage,
|
|
wxTreeItemData *data);
|
|
virtual wxTreeItemId DoInsertAfter(const wxTreeItemId& parent,
|
|
const wxTreeItemId& idPrevious,
|
|
const wxString& text,
|
|
int image = -1, int selImage = -1,
|
|
wxTreeItemData *data = NULL);
|
|
virtual wxTreeItemId DoTreeHitTest(const wxPoint& point, int& flags) const;
|
|
|
|
// called by wxTextTreeCtrl when it marks itself for deletion
|
|
void ResetTextControl();
|
|
|
|
// find the first item starting with the given prefix after the given item
|
|
wxTreeItemId FindItem(const wxTreeItemId& id, const wxString& prefix) const;
|
|
|
|
bool HasButtons() const { return HasFlag(wxTR_HAS_BUTTONS); }
|
|
|
|
void CalculateLineHeight();
|
|
int GetLineHeight(wxGenericTreeItem *item) const;
|
|
void PaintLevel( wxGenericTreeItem *item, wxDC& dc, int level, int &y );
|
|
void PaintItem( wxGenericTreeItem *item, wxDC& dc);
|
|
|
|
void CalculateLevel( wxGenericTreeItem *item, wxDC &dc, int level, int &y );
|
|
void CalculatePositions();
|
|
|
|
void RefreshSubtree( wxGenericTreeItem *item );
|
|
void RefreshLine( wxGenericTreeItem *item );
|
|
|
|
// redraw all selected items
|
|
void RefreshSelected();
|
|
|
|
// RefreshSelected() recursive helper
|
|
void RefreshSelectedUnder(wxGenericTreeItem *item);
|
|
|
|
void OnRenameTimer();
|
|
bool OnRenameAccept(wxGenericTreeItem *item, const wxString& value);
|
|
void OnRenameCancelled(wxGenericTreeItem *item);
|
|
|
|
void FillArray(wxGenericTreeItem*, wxArrayTreeItemIds&) const;
|
|
void SelectItemRange( wxGenericTreeItem *item1, wxGenericTreeItem *item2 );
|
|
bool TagAllChildrenUntilLast(wxGenericTreeItem *crt_item, wxGenericTreeItem *last_item, bool select);
|
|
bool TagNextChildren(wxGenericTreeItem *crt_item, wxGenericTreeItem *last_item, bool select);
|
|
void UnselectAllChildren( wxGenericTreeItem *item );
|
|
void ChildrenClosing(wxGenericTreeItem* item);
|
|
|
|
void DoDirtyProcessing();
|
|
|
|
virtual wxSize DoGetBestSize() const;
|
|
|
|
private:
|
|
// Reset the state of the last find (i.e. keyboard incremental search)
|
|
// operation.
|
|
void ResetFindState();
|
|
|
|
DECLARE_EVENT_TABLE()
|
|
DECLARE_DYNAMIC_CLASS(wxGenericTreeCtrl)
|
|
wxDECLARE_NO_COPY_CLASS(wxGenericTreeCtrl);
|
|
};
|
|
|
|
#if !defined(__WXMSW__) || defined(__WXUNIVERSAL__)
|
|
/*
|
|
* wxTreeCtrl has to be a real class or we have problems with
|
|
* the run-time information.
|
|
*/
|
|
|
|
class WXDLLIMPEXP_CORE wxTreeCtrl: public wxGenericTreeCtrl
|
|
{
|
|
DECLARE_DYNAMIC_CLASS(wxTreeCtrl)
|
|
|
|
public:
|
|
wxTreeCtrl() {}
|
|
|
|
wxTreeCtrl(wxWindow *parent, wxWindowID id = wxID_ANY,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = wxTR_DEFAULT_STYLE,
|
|
const wxValidator &validator = wxDefaultValidator,
|
|
const wxString& name = wxTreeCtrlNameStr)
|
|
: wxGenericTreeCtrl(parent, id, pos, size, style, validator, name)
|
|
{
|
|
}
|
|
};
|
|
#endif // !__WXMSW__ || __WXUNIVERSAL__
|
|
|
|
#endif // wxUSE_TREECTRL
|
|
|
|
#endif // _GENERIC_TREECTRL_H_
|