1e6feb95a7
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@10673 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
334 lines
12 KiB
C++
334 lines
12 KiB
C++
///////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/univ/listbox.h
|
|
// Purpose: the universal listbox
|
|
// Author: Vadim Zeitlin
|
|
// Modified by:
|
|
// Created: 30.08.00
|
|
// RCS-ID: $Id$
|
|
// Copyright: (c) 2000 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
|
|
// Licence: wxWindows licence
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_UNIV_LISTBOX_H_
|
|
#define _WX_UNIV_LISTBOX_H_
|
|
|
|
#ifdef __GNUG__
|
|
#pragma implementation "univlistbox.h"
|
|
#endif
|
|
|
|
#include "wx/scrolwin.h" // for wxScrollHelper
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// the actions supported by this control
|
|
// ----------------------------------------------------------------------------
|
|
|
|
// change the current item
|
|
#define wxACTION_LISTBOX_SETFOCUS _T("setfocus") // select the item
|
|
#define wxACTION_LISTBOX_MOVEDOWN _T("down") // select item below
|
|
#define wxACTION_LISTBOX_MOVEUP _T("up") // select item above
|
|
#define wxACTION_LISTBOX_PAGEDOWN _T("pagedown") // go page down
|
|
#define wxACTION_LISTBOX_PAGEUP _T("pageup") // go page up
|
|
#define wxACTION_LISTBOX_START _T("start") // go to first item
|
|
#define wxACTION_LISTBOX_END _T("end") // go to last item
|
|
#define wxACTION_LISTBOX_FIND _T("find") // find item by 1st letter
|
|
|
|
// do something with the current item
|
|
#define wxACTION_LISTBOX_ACTIVATE _T("activate") // activate (choose)
|
|
#define wxACTION_LISTBOX_TOGGLE _T("toggle") // togglee selected state
|
|
#define wxACTION_LISTBOX_SELECT _T("select") // sel this, unsel others
|
|
#define wxACTION_LISTBOX_SELECTADD _T("selectadd") // add to selection
|
|
#define wxACTION_LISTBOX_UNSELECT _T("unselect") // unselect
|
|
#define wxACTION_LISTBOX_ANCHOR _T("selanchor") // anchor selection
|
|
|
|
// do something with the selection globally (not for single selection ones)
|
|
#define wxACTION_LISTBOX_SELECTALL _T("selectall") // select all items
|
|
#define wxACTION_LISTBOX_UNSELECTALL _T("unselectall") // unselect all items
|
|
#define wxACTION_LISTBOX_SELTOGGLE _T("togglesel") // invert the selection
|
|
#define wxACTION_LISTBOX_EXTENDSEL _T("extend") // extend to item
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// wxListBox: a list of selectable items
|
|
// ----------------------------------------------------------------------------
|
|
|
|
class wxListBox : public wxListBoxBase, public wxScrollHelper
|
|
{
|
|
public:
|
|
// ctors and such
|
|
wxListBox() { Init(); }
|
|
wxListBox(wxWindow *parent,
|
|
wxWindowID id,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
int n = 0, const wxString choices[] = (const wxString *) NULL,
|
|
long style = 0,
|
|
const wxValidator& validator = wxDefaultValidator,
|
|
const wxString& name = wxListBoxNameStr )
|
|
{
|
|
Init();
|
|
|
|
Create(parent, id, pos, size, n, choices, style, validator, name);
|
|
}
|
|
|
|
virtual ~wxListBox();
|
|
|
|
bool Create(wxWindow *parent,
|
|
wxWindowID id,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
int n = 0, const wxString choices[] = (const wxString *) NULL,
|
|
long style = 0,
|
|
const wxValidator& validator = wxDefaultValidator,
|
|
const wxString& name = wxListBoxNameStr);
|
|
|
|
// implement the listbox interface defined by wxListBoxBase
|
|
virtual void Clear();
|
|
virtual void Delete(int n);
|
|
|
|
virtual int GetCount() const { return (int)m_strings.GetCount(); }
|
|
virtual wxString GetString(int n) const { return m_strings[n]; }
|
|
virtual void SetString(int n, const wxString& s);
|
|
virtual int FindString(const wxString& s) const
|
|
{ return m_strings.Index(s); }
|
|
|
|
virtual bool IsSelected(int n) const
|
|
{ return m_selections.Index(n) != wxNOT_FOUND; }
|
|
virtual void SetSelection(int n, bool select = TRUE);
|
|
virtual int GetSelection() const;
|
|
virtual int GetSelections(wxArrayInt& aSelections) const;
|
|
|
|
protected:
|
|
virtual int DoAppend(const wxString& item);
|
|
virtual void DoInsertItems(const wxArrayString& items, int pos);
|
|
virtual void DoSetItems(const wxArrayString& items, void **clientData);
|
|
|
|
virtual void DoSetFirstItem(int n);
|
|
|
|
virtual void DoSetItemClientData(int n, void* clientData);
|
|
virtual void* DoGetItemClientData(int n) const;
|
|
virtual void DoSetItemClientObject(int n, wxClientData* clientData);
|
|
virtual wxClientData* DoGetItemClientObject(int n) const;
|
|
|
|
public:
|
|
// override some more base class methods
|
|
virtual bool SetFont(const wxFont& font);
|
|
|
|
// the wxUniversal-specific methods
|
|
// --------------------------------
|
|
|
|
// the current item is the same as the selected one for wxLB_SINGLE
|
|
// listboxes but for the other ones it is just the focused item which may
|
|
// be selected or not
|
|
int GetCurrentItem() const { return m_current; }
|
|
void SetCurrentItem(int n);
|
|
|
|
// select the item which is diff items below the current one
|
|
void ChangeCurrent(int diff);
|
|
|
|
// activate (i.e. send a LISTBOX_DOUBLECLICKED message) the specified or
|
|
// current (if -1) item
|
|
void Activate(int item = -1);
|
|
|
|
// select or unselect the specified or current (if -1) item
|
|
void Select(bool sel = TRUE, int item = -1);
|
|
|
|
// more readable wrapper
|
|
void Unselect(int item) { Select(FALSE, item); }
|
|
|
|
// select an item and send a notification about it
|
|
void SelectAndNotify(int item);
|
|
|
|
// ensure that the given item is visible by scrolling it into view
|
|
virtual void EnsureVisible(int n);
|
|
|
|
// find the first item [strictly] after the current one which starts with
|
|
// the given string and make it the current one, return TRUE if the current
|
|
// item changed
|
|
bool FindItem(const wxString& prefix, bool strictlyAfter = FALSE);
|
|
bool FindNextItem(const wxString& prefix) { return FindItem(prefix, TRUE); }
|
|
|
|
// extend the selection to span the range from the anchor (see below) to
|
|
// the specified or current item
|
|
void ExtendSelection(int itemTo = -1);
|
|
|
|
// make this item the new selection anchor: extending selection with
|
|
// ExtendSelection() will work with it
|
|
void AnchorSelection(int itemFrom) { m_selAnchor = itemFrom; }
|
|
|
|
// get, calculating it if necessary, the number of items per page, the
|
|
// height of each line and the max width of an item
|
|
int GetItemsPerPage() const;
|
|
wxCoord GetLineHeight() const;
|
|
wxCoord GetMaxWidth() const;
|
|
|
|
// override the wxControl virtual methods
|
|
virtual bool PerformAction(const wxControlAction& action,
|
|
long numArg = 0l,
|
|
const wxString& strArg = wxEmptyString);
|
|
|
|
// let wxColourScheme choose the right colours for us
|
|
virtual bool IsContainerWindow() const { return TRUE; }
|
|
|
|
protected:
|
|
// geometry
|
|
virtual wxSize DoGetBestClientSize() const;
|
|
virtual void DoSetSize(int x, int y,
|
|
int width, int height,
|
|
int sizeFlags = wxSIZE_AUTO);
|
|
|
|
virtual void DoDraw(wxControlRenderer *renderer);
|
|
virtual wxBorder GetDefaultBorder() const;
|
|
|
|
// common part of all ctors
|
|
void Init();
|
|
|
|
// event handlers
|
|
void OnIdle(wxIdleEvent& event);
|
|
void OnSize(wxSizeEvent& event);
|
|
|
|
// common part of Clear() and DoSetItems(): clears everything
|
|
virtual void DoClear();
|
|
|
|
// refresh the given item(s) or everything
|
|
void RefreshItems(int from, int count);
|
|
void RefreshItem(int n);
|
|
void RefreshFromItemToEnd(int n);
|
|
void RefreshAll();
|
|
|
|
// send an event of the given type (using m_current by default)
|
|
bool SendEvent(wxEventType type, int item = -1);
|
|
|
|
// calculate the number of items per page using our current size
|
|
void CalcItemsPerPage();
|
|
|
|
// can/should we have a horz scrollbar?
|
|
bool HasHorzScrollbar() const
|
|
{ return (m_windowStyle & wxLB_HSCROLL) != 0; }
|
|
|
|
// redraw the items in the given range only: called from DoDraw()
|
|
virtual void DoDrawRange(wxControlRenderer *renderer,
|
|
int itemFirst, int itemLast);
|
|
|
|
// update the scrollbars and then ensure that the item is visible
|
|
void DoEnsureVisible(int n);
|
|
|
|
// mark horz scrollbar for updating
|
|
void RefreshHorzScrollbar();
|
|
|
|
// update (show/hide/adjust) the scrollbars
|
|
void UpdateScrollbars();
|
|
|
|
// refresh the items specified by m_updateCount and m_updateFrom
|
|
void UpdateItems();
|
|
|
|
// the array containing all items (it is sorted if the listbox has
|
|
// wxLB_SORT style)
|
|
wxArrayString m_strings;
|
|
|
|
// this array contains the indices of the selected items (for the single
|
|
// selection listboxes only the first element of it is used and contains
|
|
// the current selection)
|
|
wxArrayInt m_selections;
|
|
|
|
// and this one the client data (either void or wxClientData)
|
|
wxArrayPtrVoid m_itemsClientData;
|
|
|
|
// the current item
|
|
int m_current;
|
|
|
|
private:
|
|
// the range of elements which must be updated: if m_updateCount is 0 no
|
|
// update is needed, if it is -1 everything must be updated, otherwise
|
|
// m_updateCount items starting from m_updateFrom have to be redrawn
|
|
int m_updateFrom,
|
|
m_updateCount;
|
|
|
|
// the height of one line in the listbox (all lines have the same height)
|
|
wxCoord m_lineHeight;
|
|
|
|
// the maximal width of a listbox item and the item which has it
|
|
wxCoord m_maxWidth;
|
|
int m_maxWidthItem;
|
|
|
|
// the extents of horz and vert scrollbars
|
|
int m_scrollRangeX,
|
|
m_scrollRangeY;
|
|
|
|
// the number of items per page
|
|
size_t m_itemsPerPage;
|
|
|
|
// if the number of items has changed we may need to show/hide the
|
|
// scrollbar
|
|
bool m_updateScrollbarX, m_updateScrollbarY,
|
|
m_showScrollbarX, m_showScrollbarY;
|
|
|
|
// if the current item has changed, we might need to scroll if it went out
|
|
// of the window
|
|
bool m_currentChanged;
|
|
|
|
// the anchor from which the selection is extended for the listboxes with
|
|
// wxLB_EXTENDED style - this is set to the last item which was selected
|
|
// by not extending the selection but by choosing it directly
|
|
int m_selAnchor;
|
|
|
|
DECLARE_EVENT_TABLE()
|
|
DECLARE_DYNAMIC_CLASS(wxListBox)
|
|
};
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// wxStdListboxInputHandler: handles mouse and kbd in a single or multi
|
|
// selection listbox
|
|
// ----------------------------------------------------------------------------
|
|
|
|
class WXDLLEXPORT wxStdListboxInputHandler : public wxStdInputHandler
|
|
{
|
|
public:
|
|
// if pressing the mouse button in a multiselection listbox should toggle
|
|
// the item under mouse immediately, then specify TRUE as the second
|
|
// parameter (this is the standard behaviour, under GTK the item is toggled
|
|
// only when the mouse is released in the multi selection listbox)
|
|
wxStdListboxInputHandler(wxInputHandler *inphand,
|
|
bool toggleOnPressAlways = TRUE);
|
|
|
|
// base class methods
|
|
virtual bool HandleKey(wxControl *control,
|
|
const wxKeyEvent& event,
|
|
bool pressed);
|
|
virtual bool HandleMouse(wxControl *control,
|
|
const wxMouseEvent& event);
|
|
virtual bool HandleMouseMove(wxControl *control,
|
|
const wxMouseEvent& event);
|
|
|
|
protected:
|
|
// return the item under mouse, 0 if the mouse is above the listbox or
|
|
// GetCount() if it is below it
|
|
int HitTest(const wxListBox *listbox, const wxMouseEvent& event);
|
|
|
|
// parts of HitTest(): first finds the pseudo (because not in range) index
|
|
// of the item and the second one adjusts it if necessary - that is if the
|
|
// third one returns FALSE
|
|
int HitTestUnsafe(const wxListBox *listbox, const wxMouseEvent& event);
|
|
int FixItemIndex(const wxListBox *listbox, int item);
|
|
bool IsValidIndex(const wxListBox *listbox, int item);
|
|
|
|
// init m_btnCapture and m_actionMouse
|
|
wxControlAction SetupCapture(wxListBox *lbox,
|
|
const wxMouseEvent& event,
|
|
int item);
|
|
|
|
wxRenderer *m_renderer;
|
|
|
|
// the button which initiated the mouse capture (currently 0 or 1)
|
|
int m_btnCapture;
|
|
|
|
// the action to perform when the mouse moves while we capture it
|
|
wxControlAction m_actionMouse;
|
|
|
|
// the ctor parameter toggleOnPressAlways (see comments near it)
|
|
bool m_toggleOnPressAlways;
|
|
|
|
// do we track the mouse outside the window when it is captured?
|
|
bool m_trackMouseOutside;
|
|
};
|
|
|
|
#endif // _WX_UNIV_LISTBOX_H_
|