/////////////////////////////////////////////////////////////////////////////
-// 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
-// Licence: wxWindows licence
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
#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;
+// ----------------------------------------------------------------------------
+// simple types
+// ----------------------------------------------------------------------------
#if wxUSE_OWNER_DRAWN
- class WXDLLEXPORT wxOwnerDrawn;
+ class WXDLLIMPEXP_FWD_CORE wxOwnerDrawn;
// define the array of list box items
- #include <wx/dynarray.h>
+ #include "wx/dynarray.h"
- #undef WXDLLEXPORTLOCAL
- #define WXDLLEXPORTLOCAL WXDLLEXPORT
- WX_DEFINE_ARRAY(wxOwnerDrawn *, wxListBoxItemsArray);
- #undef WXDLLEXPORTLOCAL
- #define WXDLLEXPORTLOCAL
-
-#endif
+ 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, 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)
- {
- Create(parent, id, pos, size, n, 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);
-
- ~wxListBox();
-
- bool MSWCommand(WXUINT param, WXWORD id);
-
+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
- bool MSWOnMeasure(WXMEASUREITEMSTRUCT *item);
- bool MSWOnDraw(WXDRAWITEMSTRUCT *item);
+ // override base class virtuals
+ virtual bool SetFont(const wxFont &font);
- // plug-in for derived classes
- virtual wxOwnerDrawn *CreateItem(size_t n);
+ bool MSWOnMeasure(WXMEASUREITEMSTRUCT *item);
+ bool MSWOnDraw(WXDRAWITEMSTRUCT *item);
- // allows to get the item and use SetXXX functions to set it's appearance
- wxOwnerDrawn *GetItem(size_t n) const { return m_aItems[n]; }
-#endif
+ // 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;
- virtual void Append(const wxString& item);
- virtual void Append(const wxString& item, char *clientData);
- virtual void Set(int n, const wxString* choices, char **clientData = NULL);
- virtual int FindString(const wxString& s) const ;
- virtual void Clear(void);
- virtual void SetSelection(int n, bool select = TRUE);
+ // redraw the given item
+ bool RefreshItem(size_t n);
+#endif // wxUSE_OWNER_DRAWN
- virtual void Deselect(int n);
+ // 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);
- // For single choice list item only
- virtual int GetSelection() const ;
- virtual void Delete(int n);
- virtual char *GetClientData(int n) const ;
- virtual void SetClientData(int n, char *clientData);
- virtual void SetString(int n, const wxString& s);
+ // Windows callbacks
+ bool MSWCommand(WXUINT param, WXWORD id);
+ WXDWORD MSWGetStyle(long style, WXDWORD *exstyle) const;
- // For single or multiple choice list item
- virtual int GetSelections(wxArrayInt& aSelections) const;
- virtual bool Selected(int n) const ;
- virtual wxString GetString(int n) const ;
- virtual void SetSize(int x, int y, int width, int height, int sizeFlags = wxSIZE_AUTO);
- void SetSize(const wxRect& rect, int sizeFlags = wxSIZE_AUTO)
- { wxWindow::SetSize(rect, sizeFlags); }
- void SetSize(const wxSize& size) { wxWindow::SetSize(size); }
+ // 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;
+ }
- // Set the specified item at the first visible item
- // or scroll to max range.
- virtual void SetFirstItem(int n) ;
- virtual void SetFirstItem(const wxString& s) ;
+ virtual wxVisualAttributes GetDefaultAttributes() const
+ {
+ return GetClassDefaultAttributes(GetWindowVariant());
+ }
- virtual void InsertItems(int nItems, const wxString items[], int pos);
+ static wxVisualAttributes
+ GetClassDefaultAttributes(wxWindowVariant variant = wxWINDOW_VARIANT_NORMAL)
+ {
+ return GetCompositeControlsDefaultAttributes(variant);
+ }
- virtual wxString GetStringSelection(void) const ;
- virtual bool SetStringSelection(const wxString& s, bool flag = TRUE);
- virtual int Number(void) const ;
+ // returns true if the platform should explicitly apply a theme border
+ virtual bool CanApplyThemeBorder() const { return false; }
- void Command(wxCommandEvent& event);
+ virtual void OnInternalIdle();
- // 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);
+protected:
+ virtual wxSize DoGetBestClientSize() const;
- virtual WXHBRUSH OnCtlColor(WXHDC pDC, WXHWND pWnd, WXUINT nCtlColor,
- WXUINT message, WXWPARAM wParam, WXLPARAM lParam);
+ virtual void DoClear();
+ virtual void DoDeleteOneItem(unsigned int n);
- virtual long MSWWindowProc(WXUINT nMsg, WXWPARAM wParam, WXLPARAM lParam);
- virtual void SetupColours(void);
+ virtual void DoSetSelection(int n, bool select);
- protected:
- int m_noItems;
- int m_selected;
+ 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;
+
+ // this can't be called DoHitTest() because wxWindow already has this method
+ virtual int DoHitTestList(const wxPoint& point) const;
+
+ // free memory (common part of Clear() and dtor)
+ void Free();
+
+ unsigned int m_noItems;
#if wxUSE_OWNER_DRAWN
- // control items
- wxListBoxItemsArray m_aItems;
+ // control items
+ wxListBoxItemsArray m_aItems;
#endif
+private:
+ // common part of all ctors
+ void Init();
+
+ // call this when items are added to or deleted from the listbox or an
+ // items text changes
+ void MSWOnItemsChanged();
+
+ // flag indicating whether the max horizontal extent should be updated,
+ // i.e. if we need to call SetHorizontalExtent() from OnInternalIdle()
+ bool m_updateHorizontalExtent;
+
+
+ DECLARE_DYNAMIC_CLASS_NO_COPY(wxListBox)
};
+#endif // wxUSE_LISTBOX
+
#endif
// _WX_LISTBOX_H_