mirror of https://github.com/BOINC/boinc.git
197 lines
7.5 KiB
C
197 lines
7.5 KiB
C
|
// This file is part of BOINC.
|
||
|
|
// http://boinc.berkeley.edu
|
||
|
|
// Copyright (C) 2008 University of California
|
||
|
|
//
|
||
|
|
// BOINC is free software; you can redistribute it and/or modify it
|
||
|
|
// under the terms of the GNU Lesser General Public License
|
||
|
|
// as published by the Free Software Foundation,
|
||
|
|
// either version 3 of the License, or (at your option) any later version.
|
||
|
|
//
|
||
|
|
// BOINC is distributed in the hope that it will be useful,
|
||
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
||
|
|
// See the GNU Lesser General Public License for more details.
|
||
|
|
//
|
||
|
|
// You should have received a copy of the GNU Lesser General Public License
|
||
|
|
// along with BOINC. If not, see <http://www.gnu.org/licenses/>.
|
||
|
|
|
||
|
|
// Adapted from htmllbox.h by Vadim Zeitlin <vadim@wxwindows.org>
|
||
|
|
|
||
|
|
#ifndef _HTMLLBOX_H_
|
||
|
|
#define _HTMLLBOX_H_
|
||
|
|
|
||
|
|
#include "BOINCVListBox.h" // base class
|
||
|
|
|
||
|
|
class WXDLLIMPEXP_FWD_HTML wxHtmlCell;
|
||
|
|
class WXDLLIMPEXP_FWD_HTML wxHtmlWinParser;
|
||
|
|
class WXDLLIMPEXP_FWD_HTML CBOINCHtmlListBoxCache;
|
||
|
|
class WXDLLIMPEXP_FWD_HTML CBOINCHtmlListBoxStyle;
|
||
|
|
|
||
|
|
extern WXDLLIMPEXP_DATA_HTML(const wxChar) BOINCHtmlListBoxNameStr[];
|
||
|
|
|
||
|
|
// ----------------------------------------------------------------------------
|
||
|
|
// CBOINCHtmlListBox
|
||
|
|
// ----------------------------------------------------------------------------
|
||
|
|
|
||
|
|
// small border always added to the cells:
|
||
|
|
#define CELL_BORDER 2
|
||
|
|
|
||
|
|
class WXDLLIMPEXP_HTML CBOINCHtmlListBox : public CBOINCVListBox,
|
||
|
|
public wxHtmlWindowInterface,
|
||
|
|
public wxHtmlWindowMouseHelper
|
||
|
|
{
|
||
|
|
DECLARE_ABSTRACT_CLASS(CBOINCHtmlListBox)
|
||
|
|
public:
|
||
|
|
// constructors and such
|
||
|
|
// ---------------------
|
||
|
|
|
||
|
|
// default constructor, you must call Create() later
|
||
|
|
CBOINCHtmlListBox();
|
||
|
|
|
||
|
|
// normal constructor which calls Create() internally
|
||
|
|
CBOINCHtmlListBox(wxWindow *parent,
|
||
|
|
wxWindowID id = wxID_ANY,
|
||
|
|
const wxPoint& pos = wxDefaultPosition,
|
||
|
|
const wxSize& size = wxDefaultSize,
|
||
|
|
long style = 0,
|
||
|
|
const wxString& name = BOINCHtmlListBoxNameStr);
|
||
|
|
|
||
|
|
// really creates the control and sets the initial number of items in it
|
||
|
|
// (which may be changed later with SetItemCount())
|
||
|
|
//
|
||
|
|
// the only special style which may be specified here is wxLB_MULTIPLE
|
||
|
|
//
|
||
|
|
// returns true on success or false if the control couldn't be created
|
||
|
|
bool Create(wxWindow *parent,
|
||
|
|
wxWindowID id = wxID_ANY,
|
||
|
|
const wxPoint& pos = wxDefaultPosition,
|
||
|
|
const wxSize& size = wxDefaultSize,
|
||
|
|
long style = 0,
|
||
|
|
const wxString& name = BOINCHtmlListBoxNameStr);
|
||
|
|
|
||
|
|
// destructor cleans up whatever resources we use
|
||
|
|
virtual ~CBOINCHtmlListBox();
|
||
|
|
|
||
|
|
// override some base class virtuals
|
||
|
|
virtual void RefreshItem(size_t line);
|
||
|
|
virtual void RefreshItems(size_t from, size_t to);
|
||
|
|
virtual void SetItemCount(size_t count);
|
||
|
|
|
||
|
|
#if wxUSE_FILESYSTEM
|
||
|
|
// retrieve the file system used by the wxHtmlWinParser: if you use
|
||
|
|
// relative paths in your HTML, you should use its ChangePathTo() method
|
||
|
|
wxFileSystem& GetFileSystem() { return m_filesystem; }
|
||
|
|
const wxFileSystem& GetFileSystem() const { return m_filesystem; }
|
||
|
|
#endif // wxUSE_FILESYSTEM
|
||
|
|
|
||
|
|
virtual void OnInternalIdle();
|
||
|
|
|
||
|
|
int HitTest(const wxPoint& pos);
|
||
|
|
|
||
|
|
void GetItemRect(size_t item, wxRect& rect) ;
|
||
|
|
|
||
|
|
protected:
|
||
|
|
// this method must be implemented in the derived class and should return
|
||
|
|
// the body (i.e. without <html>) of the HTML for the given item
|
||
|
|
virtual wxString OnGetItem(size_t n) const = 0;
|
||
|
|
|
||
|
|
// this function may be overridden to decorate HTML returned by OnGetItem()
|
||
|
|
virtual wxString OnGetItemMarkup(size_t n) const;
|
||
|
|
|
||
|
|
|
||
|
|
// this method allows to customize the selection appearance: it may be used
|
||
|
|
// to specify the colour of the text which normally has the given colour
|
||
|
|
// colFg when it is inside the selection
|
||
|
|
//
|
||
|
|
// by default, the original colour is not used at all and all text has the
|
||
|
|
// same (default for this system) colour inside selection
|
||
|
|
virtual wxColour GetSelectedTextColour(const wxColour& colFg) const;
|
||
|
|
|
||
|
|
// this is the same as GetSelectedTextColour() but allows to customize the
|
||
|
|
// background colour -- this is even more rarely used as you can change it
|
||
|
|
// globally using SetSelectionBackground()
|
||
|
|
virtual wxColour GetSelectedTextBgColour(const wxColour& colBg) const;
|
||
|
|
|
||
|
|
|
||
|
|
// These functions are not supposed to be overridden by our descendants
|
||
|
|
virtual void OnDrawItem(wxDC& dc, const wxRect& rect, size_t n) const;
|
||
|
|
virtual wxCoord OnMeasureItem(size_t n) const;
|
||
|
|
virtual wxCoord GetMaxItemWidth() const;
|
||
|
|
|
||
|
|
// This method may be overriden to handle clicking on a link in
|
||
|
|
// the listbox. By default, clicking links is ignored.
|
||
|
|
virtual void OnLinkClicked(size_t n, const wxHtmlLinkInfo& link);
|
||
|
|
|
||
|
|
// event handlers
|
||
|
|
void OnSize(wxSizeEvent& event);
|
||
|
|
void OnMouseMove(wxMouseEvent& event);
|
||
|
|
void OnLeftDown(wxMouseEvent& event);
|
||
|
|
|
||
|
|
|
||
|
|
// common part of all ctors
|
||
|
|
void Init();
|
||
|
|
|
||
|
|
// ensure that the given item is cached
|
||
|
|
void CacheItem(size_t n) const;
|
||
|
|
|
||
|
|
private:
|
||
|
|
// wxHtmlWindowInterface methods:
|
||
|
|
virtual void SetHTMLWindowTitle(const wxString& title);
|
||
|
|
virtual void OnHTMLLinkClicked(const wxHtmlLinkInfo& link);
|
||
|
|
virtual wxHtmlOpeningStatus OnHTMLOpeningURL(wxHtmlURLType type,
|
||
|
|
const wxString& url,
|
||
|
|
wxString *redirect) const;
|
||
|
|
virtual wxPoint HTMLCoordsToWindow(wxHtmlCell *cell,
|
||
|
|
const wxPoint& pos) const;
|
||
|
|
virtual wxWindow* GetHTMLWindow();
|
||
|
|
virtual wxColour GetHTMLBackgroundColour() const;
|
||
|
|
virtual void SetHTMLBackgroundColour(const wxColour& clr);
|
||
|
|
virtual void SetHTMLBackgroundImage(const wxBitmap& bmpBg);
|
||
|
|
virtual void SetHTMLStatusText(const wxString& text);
|
||
|
|
virtual wxCursor GetHTMLCursor(HTMLCursor type) const;
|
||
|
|
|
||
|
|
// returns index of item that contains given HTML cell
|
||
|
|
size_t GetItemForCell(const wxHtmlCell *cell) const;
|
||
|
|
|
||
|
|
// return physical coordinates of root wxHtmlCell of n-th item
|
||
|
|
wxPoint GetRootCellCoords(size_t n) const;
|
||
|
|
|
||
|
|
// Converts physical coordinates stored in @a pos into coordinates
|
||
|
|
// relative to the root cell of the item under mouse cursor, if any. If no
|
||
|
|
// cell is found under the cursor, returns false. Otherwise stores the new
|
||
|
|
// coordinates back into @a pos and pointer to the cell under cursor into
|
||
|
|
// @a cell and returns true.
|
||
|
|
bool PhysicalCoordsToCell(wxPoint& pos, wxHtmlCell*& cell) const;
|
||
|
|
|
||
|
|
// The opposite of PhysicalCoordsToCell: converts coordinates relative to
|
||
|
|
// given cell to physical coordinates in the window
|
||
|
|
wxPoint CellCoordsToPhysical(const wxPoint& pos, wxHtmlCell *cell) const;
|
||
|
|
|
||
|
|
private:
|
||
|
|
// this class caches the pre-parsed HTML to speed up display
|
||
|
|
CBOINCHtmlListBoxCache *m_cache;
|
||
|
|
|
||
|
|
// HTML parser we use
|
||
|
|
wxHtmlWinParser *m_htmlParser;
|
||
|
|
|
||
|
|
#if wxUSE_FILESYSTEM
|
||
|
|
// file system used by m_htmlParser
|
||
|
|
wxFileSystem m_filesystem;
|
||
|
|
#endif // wxUSE_FILESYSTEM
|
||
|
|
|
||
|
|
// rendering style for the parser which allows us to customize our colours
|
||
|
|
CBOINCHtmlListBoxStyle *m_htmlRendStyle;
|
||
|
|
|
||
|
|
|
||
|
|
// it calls our GetSelectedTextColour() and GetSelectedTextBgColour()
|
||
|
|
friend class CBOINCHtmlListBoxStyle;
|
||
|
|
friend class wxHtmlListBoxWinInterface;
|
||
|
|
|
||
|
|
|
||
|
|
DECLARE_EVENT_TABLE()
|
||
|
|
DECLARE_NO_COPY_CLASS(CBOINCHtmlListBox)
|
||
|
|
};
|
||
|
|
|
||
|
|
#endif // _WX_HTMLLBOX_H_
|
||
|
|
|