]> git.saurik.com Git - wxWidgets.git/blame - include/wx/htmllbox.h
Compilation fix.
[wxWidgets.git] / include / wx / htmllbox.h
CommitLineData
e0c6027b
VZ
1///////////////////////////////////////////////////////////////////////////////
2// Name: wx/htmllbox.h
3// Purpose: wxHtmlListBox is a listbox whose items are wxHtmlCells
4// Author: Vadim Zeitlin
5// Modified by:
6// Created: 31.05.03
7// RCS-ID: $Id$
77ffb593 8// Copyright: (c) 2003 Vadim Zeitlin <vadim@wxwidgets.org>
65571936 9// Licence: wxWindows licence
e0c6027b
VZ
10///////////////////////////////////////////////////////////////////////////////
11
12#ifndef _WX_HTMLLBOX_H_
13#define _WX_HTMLLBOX_H_
14
15#include "wx/vlbox.h" // base class
bc55e31b 16#include "wx/html/htmlwin.h"
9ebb7cad 17#include "wx/ctrlsub.h"
e0c6027b 18
2d814c19
VZ
19#if wxUSE_FILESYSTEM
20 #include "wx/filesys.h"
21#endif // wxUSE_FILESYSTEM
22
b5dbe15d
VS
23class WXDLLIMPEXP_FWD_HTML wxHtmlCell;
24class WXDLLIMPEXP_FWD_HTML wxHtmlWinParser;
25class WXDLLIMPEXP_FWD_HTML wxHtmlListBoxCache;
26class WXDLLIMPEXP_FWD_HTML wxHtmlListBoxStyle;
e0c6027b 27
14d8546a
MW
28extern WXDLLIMPEXP_DATA_HTML(const wxChar) wxHtmlListBoxNameStr[];
29extern WXDLLIMPEXP_DATA_HTML(const wxChar) wxSimpleHtmlListBoxNameStr[];
9ebb7cad 30
e0c6027b
VZ
31// ----------------------------------------------------------------------------
32// wxHtmlListBox
33// ----------------------------------------------------------------------------
34
bc55e31b
VS
35class WXDLLIMPEXP_HTML wxHtmlListBox : public wxVListBox,
36 public wxHtmlWindowInterface,
31297dbb 37 public wxHtmlWindowMouseHelper
e0c6027b 38{
0c8392ca 39 DECLARE_ABSTRACT_CLASS(wxHtmlListBox)
e0c6027b
VZ
40public:
41 // constructors and such
42 // ---------------------
43
44 // default constructor, you must call Create() later
bc55e31b 45 wxHtmlListBox();
e0c6027b
VZ
46
47 // normal constructor which calls Create() internally
48 wxHtmlListBox(wxWindow *parent,
49 wxWindowID id = wxID_ANY,
50 const wxPoint& pos = wxDefaultPosition,
51 const wxSize& size = wxDefaultSize,
e0c6027b 52 long style = 0,
9ebb7cad 53 const wxString& name = wxHtmlListBoxNameStr);
e0c6027b
VZ
54
55 // really creates the control and sets the initial number of items in it
56 // (which may be changed later with SetItemCount())
57 //
43e319a3 58 // the only special style which may be specified here is wxLB_MULTIPLE
e0c6027b
VZ
59 //
60 // returns true on success or false if the control couldn't be created
61 bool Create(wxWindow *parent,
62 wxWindowID id = wxID_ANY,
63 const wxPoint& pos = wxDefaultPosition,
64 const wxSize& size = wxDefaultSize,
e0c6027b 65 long style = 0,
9ebb7cad 66 const wxString& name = wxHtmlListBoxNameStr);
e0c6027b
VZ
67
68 // destructor cleans up whatever resources we use
69 virtual ~wxHtmlListBox();
70
03495767 71 // override some base class virtuals
e02c72fa
VZ
72 virtual void RefreshRow(size_t line);
73 virtual void RefreshRows(size_t from, size_t to);
5ecdc7ab 74 virtual void RefreshAll();
03495767 75 virtual void SetItemCount(size_t count);
5ecdc7ab 76
2d814c19
VZ
77#if wxUSE_FILESYSTEM
78 // retrieve the file system used by the wxHtmlWinParser: if you use
79 // relative paths in your HTML, you should use its ChangePathTo() method
80 wxFileSystem& GetFileSystem() { return m_filesystem; }
81 const wxFileSystem& GetFileSystem() const { return m_filesystem; }
82#endif // wxUSE_FILESYSTEM
83
bc55e31b
VS
84 virtual void OnInternalIdle();
85
e0c6027b
VZ
86protected:
87 // this method must be implemented in the derived class and should return
88 // the body (i.e. without <html>) of the HTML for the given item
89 virtual wxString OnGetItem(size_t n) const = 0;
90
91 // this function may be overridden to decorate HTML returned by OnGetItem()
92 virtual wxString OnGetItemMarkup(size_t n) const;
93
94
9a9b4940
VZ
95 // this method allows to customize the selection appearance: it may be used
96 // to specify the colour of the text which normally has the given colour
97 // colFg when it is inside the selection
98 //
99 // by default, the original colour is not used at all and all text has the
100 // same (default for this system) colour inside selection
101 virtual wxColour GetSelectedTextColour(const wxColour& colFg) const;
102
103 // this is the same as GetSelectedTextColour() but allows to customize the
104 // background colour -- this is even more rarely used as you can change it
105 // globally using SetSelectionBackground()
106 virtual wxColour GetSelectedTextBgColour(const wxColour& colBg) const;
107
108
e0c6027b
VZ
109 // we implement both of these functions in terms of OnGetItem(), they are
110 // not supposed to be overridden by our descendants
111 virtual void OnDrawItem(wxDC& dc, const wxRect& rect, size_t n) const;
112 virtual wxCoord OnMeasureItem(size_t n) const;
113
c848185a
VZ
114 // override this one to draw custom background for selected items correctly
115 virtual void OnDrawBackground(wxDC& dc, const wxRect& rect, size_t n) const;
116
117 // this method may be overridden to handle clicking on a link in the
118 // listbox (by default, clicks on links are simply ignored)
a1c3cdc4 119 virtual void OnLinkClicked(size_t n, const wxHtmlLinkInfo& link);
e0c6027b 120
5ecdc7ab
VZ
121 // event handlers
122 void OnSize(wxSizeEvent& event);
bc55e31b
VS
123 void OnMouseMove(wxMouseEvent& event);
124 void OnLeftDown(wxMouseEvent& event);
5ecdc7ab
VZ
125
126
e0c6027b
VZ
127 // common part of all ctors
128 void Init();
129
130 // ensure that the given item is cached
131 void CacheItem(size_t n) const;
132
bc55e31b
VS
133private:
134 // wxHtmlWindowInterface methods:
135 virtual void SetHTMLWindowTitle(const wxString& title);
136 virtual void OnHTMLLinkClicked(const wxHtmlLinkInfo& link);
137 virtual wxHtmlOpeningStatus OnHTMLOpeningURL(wxHtmlURLType type,
138 const wxString& url,
139 wxString *redirect) const;
140 virtual wxPoint HTMLCoordsToWindow(wxHtmlCell *cell,
141 const wxPoint& pos) const;
142 virtual wxWindow* GetHTMLWindow();
143 virtual wxColour GetHTMLBackgroundColour() const;
144 virtual void SetHTMLBackgroundColour(const wxColour& clr);
145 virtual void SetHTMLBackgroundImage(const wxBitmap& bmpBg);
146 virtual void SetHTMLStatusText(const wxString& text);
88a1b648 147 virtual wxCursor GetHTMLCursor(HTMLCursor type) const;
bc55e31b
VS
148
149 // returns index of item that contains given HTML cell
150 size_t GetItemForCell(const wxHtmlCell *cell) const;
151
152 // return physical coordinates of root wxHtmlCell of n-th item
153 wxPoint GetRootCellCoords(size_t n) const;
154
155 // Converts physical coordinates stored in @a pos into coordinates
156 // relative to the root cell of the item under mouse cursor, if any. If no
157 // cell is found under the cursor, returns false. Otherwise stores the new
158 // coordinates back into @a pos and pointer to the cell under cursor into
159 // @a cell and returns true.
160 bool PhysicalCoordsToCell(wxPoint& pos, wxHtmlCell*& cell) const;
161
162 // The opposite of PhysicalCoordsToCell: converts coordinates relative to
163 // given cell to physical coordinates in the window
164 wxPoint CellCoordsToPhysical(const wxPoint& pos, wxHtmlCell *cell) const;
165
e0c6027b 166private:
9a9b4940 167 // this class caches the pre-parsed HTML to speed up display
e0c6027b
VZ
168 wxHtmlListBoxCache *m_cache;
169
170 // HTML parser we use
171 wxHtmlWinParser *m_htmlParser;
5ecdc7ab 172
2d814c19
VZ
173#if wxUSE_FILESYSTEM
174 // file system used by m_htmlParser
175 wxFileSystem m_filesystem;
176#endif // wxUSE_FILESYSTEM
177
9a9b4940
VZ
178 // rendering style for the parser which allows us to customize our colours
179 wxHtmlListBoxStyle *m_htmlRendStyle;
180
181
182 // it calls our GetSelectedTextColour() and GetSelectedTextBgColour()
183 friend class wxHtmlListBoxStyle;
bc55e31b 184 friend class wxHtmlListBoxWinInterface;
9a9b4940 185
5ecdc7ab
VZ
186
187 DECLARE_EVENT_TABLE()
27d0dcd0 188 DECLARE_NO_COPY_CLASS(wxHtmlListBox)
e0c6027b
VZ
189};
190
9ebb7cad
VZ
191
192// ----------------------------------------------------------------------------
193// wxSimpleHtmlListBox
194// ----------------------------------------------------------------------------
195
196#define wxHLB_DEFAULT_STYLE wxBORDER_SUNKEN
197#define wxHLB_MULTIPLE wxLB_MULTIPLE
198
199class WXDLLIMPEXP_HTML wxSimpleHtmlListBox : public wxHtmlListBox,
200 public wxItemContainer
201{
202public:
203 // wxListbox-compatible constructors
204 // ---------------------------------
205
206 wxSimpleHtmlListBox() { }
207
208 wxSimpleHtmlListBox(wxWindow *parent,
209 wxWindowID id,
210 const wxPoint& pos = wxDefaultPosition,
211 const wxSize& size = wxDefaultSize,
212 int n = 0, const wxString choices[] = NULL,
213 long style = wxHLB_DEFAULT_STYLE,
214 const wxValidator& validator = wxDefaultValidator,
215 const wxString& name = wxSimpleHtmlListBoxNameStr)
216 {
217 Create(parent, id, pos, size, n, choices, style, validator, name);
218 }
219
220 wxSimpleHtmlListBox(wxWindow *parent,
221 wxWindowID id,
222 const wxPoint& pos,
223 const wxSize& size,
224 const wxArrayString& choices,
225 long style = wxHLB_DEFAULT_STYLE,
226 const wxValidator& validator = wxDefaultValidator,
227 const wxString& name = wxSimpleHtmlListBoxNameStr)
228 {
229 Create(parent, id, pos, size, choices, style, validator, name);
230 }
231
232 bool Create(wxWindow *parent, wxWindowID id,
233 const wxPoint& pos = wxDefaultPosition,
234 const wxSize& size = wxDefaultSize,
235 int n = 0, const wxString choices[] = NULL,
236 long style = wxHLB_DEFAULT_STYLE,
237 const wxValidator& validator = wxDefaultValidator,
238 const wxString& name = wxSimpleHtmlListBoxNameStr);
239 bool Create(wxWindow *parent, wxWindowID id,
240 const wxPoint& pos,
241 const wxSize& size,
242 const wxArrayString& choices,
243 long style = wxHLB_DEFAULT_STYLE,
244 const wxValidator& validator = wxDefaultValidator,
245 const wxString& name = wxSimpleHtmlListBoxNameStr);
d54b227f 246
9ebb7cad
VZ
247 virtual ~wxSimpleHtmlListBox();
248
249 // these must be overloaded otherwise the compiler will complain
250 // about wxItemContainerImmutable::[G|S]etSelection being pure virtuals...
251 void SetSelection(int n)
d54b227f 252 { wxVListBox::SetSelection(n); }
9ebb7cad
VZ
253 int GetSelection() const
254 { return wxVListBox::GetSelection(); }
255
256 // see ctrlsub.h for more info about this:
257 wxCONTROL_ITEMCONTAINER_CLIENTDATAOBJECT_RECAST
258
259
260 // accessing strings
261 // -----------------
262
263 virtual unsigned int GetCount() const
264 { return m_items.GetCount(); }
265
266 virtual wxString GetString(unsigned int n) const;
267
268 // override default unoptimized wxItemContainer::GetStrings() function
269 wxArrayString GetStrings() const
270 { return m_items; }
271
272 virtual void SetString(unsigned int n, const wxString& s);
273
e52cd41e
VZ
274 // resolve ambiguity between wxItemContainer and wxVListBox versions
275 void Clear();
9ebb7cad
VZ
276
277protected:
a236aa20
VZ
278 virtual int DoInsertItems(const wxArrayStringsAdapter & items,
279 unsigned int pos,
280 void **clientData, wxClientDataType type);
9ebb7cad
VZ
281
282 virtual void DoSetItemClientData(unsigned int n, void *clientData)
9d8f8138 283 { m_HTMLclientData[n] = clientData; }
9ebb7cad
VZ
284
285 virtual void *DoGetItemClientData(unsigned int n) const
9d8f8138 286 { return m_HTMLclientData[n]; }
9ebb7cad 287
e52cd41e
VZ
288 // wxItemContainer methods
289 virtual void DoClear();
290 virtual void DoDeleteOneItem(unsigned int n);
291
9ebb7cad
VZ
292 // calls wxHtmlListBox::SetItemCount() and RefreshAll()
293 void UpdateCount();
294
e52cd41e 295 // override these functions just to change their visibility: users of
9ebb7cad
VZ
296 // wxSimpleHtmlListBox shouldn't be allowed to call them directly!
297 virtual void SetItemCount(size_t count)
d54b227f 298 { wxHtmlListBox::SetItemCount(count); }
f18eaf26
VZ
299 virtual void SetRowCount(size_t count)
300 { wxHtmlListBox::SetRowCount(count); }
9ebb7cad
VZ
301
302 virtual wxString OnGetItem(size_t n) const
303 { return m_items[n]; }
304
67339f7d
JS
305 wxArrayString m_items;
306 wxArrayPtrVoid m_HTMLclientData;
307
9d8f8138
SN
308 // Note: For the benefit of old compilers (like gcc-2.8) this should
309 // not be named m_clientdata as that clashes with the name of an
310 // anonymous struct member in wxEvtHandler, which we derive from.
9ebb7cad
VZ
311
312 DECLARE_NO_COPY_CLASS(wxSimpleHtmlListBox)
313};
314
e0c6027b
VZ
315#endif // _WX_HTMLLBOX_H_
316