]>
Commit | Line | Data |
---|---|---|
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 |
23 | class WXDLLIMPEXP_FWD_HTML wxHtmlCell; |
24 | class WXDLLIMPEXP_FWD_HTML wxHtmlWinParser; | |
25 | class WXDLLIMPEXP_FWD_HTML wxHtmlListBoxCache; | |
26 | class WXDLLIMPEXP_FWD_HTML wxHtmlListBoxStyle; | |
e0c6027b | 27 | |
14d8546a MW |
28 | extern WXDLLIMPEXP_DATA_HTML(const wxChar) wxHtmlListBoxNameStr[]; |
29 | extern WXDLLIMPEXP_DATA_HTML(const wxChar) wxSimpleHtmlListBoxNameStr[]; | |
9ebb7cad | 30 | |
e0c6027b VZ |
31 | // ---------------------------------------------------------------------------- |
32 | // wxHtmlListBox | |
33 | // ---------------------------------------------------------------------------- | |
34 | ||
bc55e31b VS |
35 | class WXDLLIMPEXP_HTML wxHtmlListBox : public wxVListBox, |
36 | public wxHtmlWindowInterface, | |
31297dbb | 37 | public wxHtmlWindowMouseHelper |
e0c6027b | 38 | { |
0c8392ca | 39 | DECLARE_ABSTRACT_CLASS(wxHtmlListBox) |
e0c6027b VZ |
40 | public: |
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 |
86 | protected: |
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 |
133 | private: |
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 | 166 | private: |
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 | ||
199 | class WXDLLIMPEXP_HTML wxSimpleHtmlListBox : public wxHtmlListBox, | |
200 | public wxItemContainer | |
201 | { | |
202 | public: | |
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 | |
277 | protected: | |
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 |