X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/7f17c6dbbf70365eda8effec5ad68dab70ed78f8..1f0acb435592470b421b80df854fbbb08cd2853f:/include/wx/msw/listbox.h diff --git a/include/wx/msw/listbox.h b/include/wx/msw/listbox.h index 1b6f0001df..0d9982bab8 100644 --- a/include/wx/msw/listbox.h +++ b/include/wx/msw/listbox.h @@ -1,137 +1,208 @@ ///////////////////////////////////////////////////////////////////////////// -// Name: listbox.h +// Name: wx/msw/listbox.h // Purpose: wxListBox class // Author: Julian Smart // Modified by: // Created: 01/02/97 // RCS-ID: $Id$ -// Copyright: (c) Julian Smart and Markus Holzem -// Licence: wxWindows license +// Copyright: (c) Julian Smart +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// -#ifndef __LISTBOXH__ -#define __LISTBOXH__ +#ifndef _WX_LISTBOX_H_ +#define _WX_LISTBOX_H_ -#ifdef __GNUG__ -#pragma interface "listbox.h" -#endif - -#include "wx/control.h" +#if wxUSE_LISTBOX -WXDLLEXPORT_DATA(extern const char*) wxListBoxNameStr; -WXDLLEXPORT_DATA(extern const char*) wxListBoxNameStr; +// ---------------------------------------------------------------------------- +// simple types +// ---------------------------------------------------------------------------- -#if USE_OWNER_DRAWN - class WXDLLEXPORT wxOwnerDrawn; +#if wxUSE_OWNER_DRAWN + class WXDLLIMPEXP_FWD_CORE wxOwnerDrawn; // define the array of list box items - #include - WX_DEFINE_ARRAY(wxOwnerDrawn *, wxListBoxItemsArray); -#endif + #include "wx/dynarray.h" + + WX_DEFINE_EXPORTED_ARRAY_PTR(wxOwnerDrawn *, wxListBoxItemsArray); +#endif // wxUSE_OWNER_DRAWN // forward decl for GetSelections() -class wxArrayInt; +class WXDLLIMPEXP_FWD_BASE wxArrayInt; -WXDLLEXPORT_DATA(extern const char*) wxEmptyString; +// ---------------------------------------------------------------------------- +// List box control +// ---------------------------------------------------------------------------- -// List box item -class WXDLLEXPORT wxListBox: public wxControl +class WXDLLIMPEXP_CORE wxListBox : public wxListBoxBase { - DECLARE_DYNAMIC_CLASS(wxListBox) - public: - - wxListBox(void); - inline wxListBox(wxWindow *parent, const wxWindowID id, - const wxPoint& pos = wxDefaultPosition, - const wxSize& size = wxDefaultSize, - const int n = 0, const wxString choices[] = NULL, - const long style = 0, - const wxValidator& validator = wxDefaultValidator, - const wxString& name = wxListBoxNameStr) - { - Create(parent, id, pos, size, n, choices, style, validator, name); - } - - bool Create(wxWindow *parent, const wxWindowID id, - const wxPoint& pos = wxDefaultPosition, - const wxSize& size = wxDefaultSize, - const int n = 0, const wxString choices[] = NULL, - const long style = 0, - const wxValidator& validator = wxDefaultValidator, - const wxString& name = wxListBoxNameStr); - - ~wxListBox(); - - bool MSWCommand(const WXUINT param, const WXWORD id); - -#if USE_OWNER_DRAWN - bool MSWOnMeasure(WXMEASUREITEMSTRUCT *item); - bool MSWOnDraw(WXDRAWITEMSTRUCT *item); - - // plug-in for derived classes - virtual wxOwnerDrawn *CreateItem(uint n); - - // allows to get the item and use SetXXX functions to set it's appearance - wxOwnerDrawn *GetItem(uint n) const { return m_aItems[n]; } -#endif - - virtual void Append(const wxString& item); - virtual void Append(const wxString& item, char *clientData); - virtual void Set(const int n, const wxString* choices, char **clientData = NULL); - virtual int FindString(const wxString& s) const ; - virtual void Clear(void); - virtual void SetSelection(const int n, const bool select = TRUE); +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[] = NULL, + long style = 0, + const wxValidator& validator = wxDefaultValidator, + const wxString& name = wxListBoxNameStr) + { + Init(); + + Create(parent, id, pos, size, n, choices, style, validator, name); + } + wxListBox(wxWindow *parent, wxWindowID id, + const wxPoint& pos, + const wxSize& size, + const wxArrayString& choices, + long style = 0, + const wxValidator& validator = wxDefaultValidator, + const wxString& name = wxListBoxNameStr) + { + Init(); + + Create(parent, id, pos, size, choices, style, validator, name); + } + + bool Create(wxWindow *parent, wxWindowID id, + const wxPoint& pos = wxDefaultPosition, + const wxSize& size = wxDefaultSize, + int n = 0, const wxString choices[] = NULL, + long style = 0, + const wxValidator& validator = wxDefaultValidator, + const wxString& name = wxListBoxNameStr); + bool Create(wxWindow *parent, wxWindowID id, + const wxPoint& pos, + const wxSize& size, + const wxArrayString& choices, + long style = 0, + const wxValidator& validator = wxDefaultValidator, + const wxString& name = wxListBoxNameStr); + + virtual ~wxListBox(); + + virtual unsigned int GetCount() const; + virtual wxString GetString(unsigned int n) const; + virtual void SetString(unsigned int n, const wxString& s); + virtual int FindString(const wxString& s, bool bCase = false) const; + + virtual bool IsSelected(int n) const; + virtual int GetSelection() const; + virtual int GetSelections(wxArrayInt& aSelections) const; + + // return the index of the item at this position or wxNOT_FOUND + int HitTest(const wxPoint& pt) const { return DoHitTestList(pt); } + int HitTest(wxCoord x, wxCoord y) const { return DoHitTestList(wxPoint(x, y)); } + + // ownerdrawn wxListBox and wxCheckListBox support +#if wxUSE_OWNER_DRAWN + // override base class virtuals + virtual bool SetFont(const wxFont &font); + + bool MSWOnMeasure(WXMEASUREITEMSTRUCT *item); + bool MSWOnDraw(WXDRAWITEMSTRUCT *item); + + // plug-in for derived classes + virtual wxOwnerDrawn *CreateLboxItem(size_t n); + + // allows to get the item and use SetXXX functions to set it's appearance + wxOwnerDrawn *GetItem(size_t n) const { return m_aItems[n]; } + + // get the index of the given item + int GetItemIndex(wxOwnerDrawn *item) const { return m_aItems.Index(item); } + + // get rect of the given item index + bool GetItemRect(size_t n, wxRect& rect) const; + + // redraw the given item + bool RefreshItem(size_t n); +#endif // wxUSE_OWNER_DRAWN + + // Windows-specific code to update the horizontal extent of the listbox, if + // necessary. If s is non-empty, the horizontal extent is increased to the + // length of this string if it's currently too short, otherwise the maximum + // extent of all strings is used. In any case calls InvalidateBestSize() + virtual void SetHorizontalExtent(const wxString& s = wxEmptyString); + + // Windows callbacks + bool MSWCommand(WXUINT param, WXWORD id); + WXDWORD MSWGetStyle(long style, WXDWORD *exstyle) const; + + // under XP when using "transition effect for menus and tooltips" if we + // return true for WM_PRINTCLIENT here then it causes noticable slowdown + virtual bool MSWShouldPropagatePrintChild() + { + return false; + } + + virtual wxVisualAttributes GetDefaultAttributes() const + { + return GetClassDefaultAttributes(GetWindowVariant()); + } + + static wxVisualAttributes + GetClassDefaultAttributes(wxWindowVariant variant = wxWINDOW_VARIANT_NORMAL) + { + return GetCompositeControlsDefaultAttributes(variant); + } + + // returns true if the platform should explicitly apply a theme border + virtual bool CanApplyThemeBorder() const { return false; } + + virtual void OnInternalIdle(); + + virtual WXLRESULT MSWWindowProc(WXUINT nMsg, WXWPARAM wParam, WXLPARAM lParam); + +protected: + virtual wxSize DoGetBestClientSize() const; + + virtual void DoClear(); + virtual void DoDeleteOneItem(unsigned int n); - virtual void Deselect(const int n); + virtual void DoSetSelection(int n, bool select); - // For single choice list item only - virtual int GetSelection() const ; - virtual void Delete(const int n); - virtual char *GetClientData(const int n) const ; - virtual void SetClientData(const int n, char *clientData); - virtual void SetString(const int n, const wxString& s); + virtual int DoInsertItems(const wxArrayStringsAdapter& items, + unsigned int pos, + void **clientData, wxClientDataType type); + + virtual void DoSetFirstItem(int n); + virtual void DoSetItemClientData(unsigned int n, void* clientData); + virtual void* DoGetItemClientData(unsigned int n) const; - // For single or multiple choice list item - virtual int GetSelections(wxArrayInt& aSelections) const; - virtual bool Selected(const int n) const ; - virtual wxString GetString(const int n) const ; - virtual void SetSize(const int x, const int y, const int width, const int height, const int sizeFlags = wxSIZE_AUTO); + // this can't be called DoHitTest() because wxWindow already has this method + virtual int DoHitTestList(const wxPoint& point) const; - // Set the specified item at the first visible item - // or scroll to max range. - virtual void SetFirstItem(const int n) ; - virtual void SetFirstItem(const wxString& s) ; + // free memory (common part of Clear() and dtor) + void Free(); - virtual void InsertItems(const int nItems, const wxString items[], const int pos); + unsigned int m_noItems; - virtual wxString GetStringSelection(void) const ; - virtual bool SetStringSelection(const wxString& s, const bool flag = TRUE); - virtual int Number(void) const ; - - void Command(wxCommandEvent& event); +#if wxUSE_OWNER_DRAWN + // control items + wxListBoxItemsArray m_aItems; +#endif - // Windows-specific code to set the horizontal extent of - // the listbox, if necessary. If s is non-NULL, it's - // used to calculate the horizontal extent. - // Otherwise, all strings are used. - virtual void SetHorizontalExtent(const wxString& s = wxEmptyString); +private: + // common part of all ctors + void Init(); - virtual WXHBRUSH OnCtlColor(const WXHDC pDC, const WXHWND pWnd, const WXUINT nCtlColor, - WXUINT message, WXWPARAM wParam, WXLPARAM lParam); + // call this when items are added to or deleted from the listbox or an + // items text changes + void MSWOnItemsChanged(); - virtual long MSWWindowProc(WXUINT nMsg, WXWPARAM wParam, WXLPARAM lParam); - virtual void SetupColours(void); + // flag indicating whether the max horizontal extent should be updated, + // i.e. if we need to call SetHorizontalExtent() from OnInternalIdle() + bool m_updateHorizontalExtent; - protected: - int m_noItems; - int m_selected; - -#if USE_OWNER_DRAWN - // control items - wxListBoxItemsArray m_aItems; -#endif + // flag set to true when we get a keyboard event and reset to false when we + // get a mouse one: this is used to find the correct item for the selection + // event + bool m_selectedByKeyboard; + DECLARE_DYNAMIC_CLASS_NO_COPY(wxListBox) }; +#endif // wxUSE_LISTBOX + #endif - // __LISTBOXH__ + // _WX_LISTBOX_H_