1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: wxListBox class
4 // Author: David Webster
8 // Copyright: (c) David Webster
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 #ifndef _WX_LISTBOX_H_
13 #define _WX_LISTBOX_H_
15 // ----------------------------------------------------------------------------
17 // ----------------------------------------------------------------------------
20 class WXDLLEXPORT wxOwnerDrawn
;
22 // define the array of list box items
23 #include <wx/dynarray.h>
25 WX_DEFINE_EXPORTED_ARRAY(wxOwnerDrawn
*, wxListBoxItemsArray
);
26 #endif // wxUSE_OWNER_DRAWN
28 // forward decl for GetSelections()
31 // ----------------------------------------------------------------------------
33 // ----------------------------------------------------------------------------
35 class WXDLLEXPORT wxListBox
: public wxListBoxBase
40 wxListBox(wxWindow
*parent
, wxWindowID id
,
41 const wxPoint
& pos
= wxDefaultPosition
,
42 const wxSize
& size
= wxDefaultSize
,
43 int n
= 0, const wxString choices
[] = NULL
,
45 const wxValidator
& validator
= wxDefaultValidator
,
46 const wxString
& name
= wxListBoxNameStr
)
48 Create(parent
, id
, pos
, size
, n
, choices
, style
, validator
, name
);
51 bool Create(wxWindow
*parent
, wxWindowID id
,
52 const wxPoint
& pos
= wxDefaultPosition
,
53 const wxSize
& size
= wxDefaultSize
,
54 int n
= 0, const wxString choices
[] = NULL
,
56 const wxValidator
& validator
= wxDefaultValidator
,
57 const wxString
& name
= wxListBoxNameStr
);
61 // implement base class pure virtuals
63 virtual void Delete(int n
);
65 virtual int GetCount() const;
66 virtual wxString
GetString(int n
) const;
67 virtual void SetString(int n
, const wxString
& s
);
68 virtual int FindString(const wxString
& s
) const;
70 virtual bool IsSelected(int n
) const;
71 virtual void SetSelection(int n
, bool select
= TRUE
);
72 virtual int GetSelection() const;
73 virtual int GetSelections(wxArrayInt
& aSelections
) const;
75 virtual int DoAppend(const wxString
& item
);
76 virtual void DoInsertItems(const wxArrayString
& items
, int pos
);
77 virtual void DoSetItems(const wxArrayString
& items
, void **clientData
);
79 virtual void DoSetFirstItem(int n
);
81 virtual void DoSetItemClientData(int n
, void* clientData
);
82 virtual void* DoGetItemClientData(int n
) const;
83 virtual void DoSetItemClientObject(int n
, wxClientData
* clientData
);
84 virtual wxClientData
* DoGetItemClientObject(int n
) const;
86 // wxCheckListBox support
88 bool OS2OnMeasure(WXMEASUREITEMSTRUCT
*item
);
89 bool OS2OnDraw(WXDRAWITEMSTRUCT
*item
);
91 // plug-in for derived classes
92 virtual wxOwnerDrawn
*CreateItem(size_t n
);
94 // allows to get the item and use SetXXX functions to set it's appearance
95 wxOwnerDrawn
*GetItem(size_t n
) const { return m_aItems
[n
]; }
97 // get the index of the given item
98 int GetItemIndex(wxOwnerDrawn
*item
) const { return m_aItems
.Index(item
); }
99 #endif // wxUSE_OWNER_DRAWN
101 // Windows-specific code to set the horizontal extent of the listbox, if
102 // necessary. If s is non-NULL, it's used to calculate the horizontal
103 // extent. Otherwise, all strings are used.
104 virtual void SetHorizontalExtent(const wxString
& s
= wxEmptyString
);
107 virtual WXHBRUSH
OnCtlColor(WXHDC pDC
, WXHWND pWnd
, WXUINT nCtlColor
,
109 WXWPARAM wParam
, WXLPARAM lParam
);
111 bool OS2Command(WXUINT param
, WXWORD id
);
113 virtual void SetupColours();
116 // do we have multiple selections?
117 bool HasMultipleSelection() const;
122 virtual wxSize
DoGetBestSize();
124 #if wxUSE_OWNER_DRAWN
126 wxListBoxItemsArray m_aItems
;
130 #if wxUSE_WX_RESOURCES
131 # if wxUSE_OWNER_DRAWN
132 virtual wxControl
*CreateItem(const wxItemResource
* childResource
,
133 const wxItemResource
* parentResource
,
134 const wxResourceTable
*table
= (const wxResourceTable
*) NULL
)
135 { return(wxWindowBase::CreateItem(childResource
, parentResource
, table
)); }
138 DECLARE_DYNAMIC_CLASS(wxListBox
)