4f4c5fcfdf
This is a combination of running clang-tidy with modernize-use-nullptr check for some ports (GTK, X11, OSX) and manual changes to the ports for which it couldn't be used easily (MSW, DFB) and also manually updating the docs. Also replace NULL with null or nullptr in the comments as this is more consistent with the use of nullptr in the code and makes it simpler to grep for the remaining occurrences of NULL itself. And also use null in the assert messages. Only a few occurrences of "NULL" are still left in non-C files, mostly corresponding to unclear comments or string output which it might not be safe to change.
330 lines
13 KiB
C++
330 lines
13 KiB
C++
///////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/htmllbox.h
|
|
// Purpose: wxHtmlListBox is a listbox whose items are wxHtmlCells
|
|
// Author: Vadim Zeitlin
|
|
// Modified by:
|
|
// Created: 31.05.03
|
|
// Copyright: (c) 2003 Vadim Zeitlin <vadim@wxwidgets.org>
|
|
// Licence: wxWindows licence
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_HTMLLBOX_H_
|
|
#define _WX_HTMLLBOX_H_
|
|
|
|
#include "wx/defs.h"
|
|
|
|
#if wxUSE_HTML
|
|
|
|
#include "wx/vlbox.h" // base class
|
|
#include "wx/html/htmlwin.h"
|
|
#include "wx/ctrlsub.h"
|
|
|
|
#if wxUSE_FILESYSTEM
|
|
#include "wx/filesys.h"
|
|
#endif // wxUSE_FILESYSTEM
|
|
|
|
class WXDLLIMPEXP_FWD_HTML wxHtmlCell;
|
|
class WXDLLIMPEXP_FWD_HTML wxHtmlWinParser;
|
|
class WXDLLIMPEXP_FWD_HTML wxHtmlListBoxCache;
|
|
class WXDLLIMPEXP_FWD_HTML wxHtmlListBoxStyle;
|
|
|
|
extern WXDLLIMPEXP_DATA_HTML(const char) wxHtmlListBoxNameStr[];
|
|
extern WXDLLIMPEXP_DATA_HTML(const char) wxSimpleHtmlListBoxNameStr[];
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// wxHtmlListBox
|
|
// ----------------------------------------------------------------------------
|
|
|
|
class WXDLLIMPEXP_HTML wxHtmlListBox : public wxVListBox,
|
|
public wxHtmlWindowInterface,
|
|
public wxHtmlWindowMouseHelper
|
|
{
|
|
wxDECLARE_ABSTRACT_CLASS(wxHtmlListBox);
|
|
public:
|
|
// constructors and such
|
|
// ---------------------
|
|
|
|
// default constructor, you must call Create() later
|
|
wxHtmlListBox();
|
|
|
|
// normal constructor which calls Create() internally
|
|
wxHtmlListBox(wxWindow *parent,
|
|
wxWindowID id = wxID_ANY,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = 0,
|
|
const wxString& name = wxASCII_STR(wxHtmlListBoxNameStr));
|
|
|
|
// 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 = wxASCII_STR(wxHtmlListBoxNameStr));
|
|
|
|
// destructor cleans up whatever resources we use
|
|
virtual ~wxHtmlListBox();
|
|
|
|
// override some base class virtuals
|
|
virtual void RefreshRow(size_t line) override;
|
|
virtual void RefreshRows(size_t from, size_t to) override;
|
|
virtual void RefreshAll() override;
|
|
virtual void SetItemCount(size_t count) override;
|
|
|
|
#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() override;
|
|
|
|
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;
|
|
|
|
|
|
// we implement both of these functions in terms of OnGetItem(), they are
|
|
// not supposed to be overridden by our descendants
|
|
virtual void OnDrawItem(wxDC& dc, const wxRect& rect, size_t n) const override;
|
|
virtual wxCoord OnMeasureItem(size_t n) const override;
|
|
|
|
// override this one to draw custom background for selected items correctly
|
|
virtual void OnDrawBackground(wxDC& dc, const wxRect& rect, size_t n) const override;
|
|
|
|
// this method may be overridden to handle clicking on a link in the
|
|
// listbox (by default, clicks on links are simply 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) override;
|
|
virtual void OnHTMLLinkClicked(const wxHtmlLinkInfo& link) override;
|
|
virtual wxHtmlOpeningStatus OnHTMLOpeningURL(wxHtmlURLType type,
|
|
const wxString& url,
|
|
wxString *redirect) const override;
|
|
virtual wxPoint HTMLCoordsToWindow(wxHtmlCell *cell,
|
|
const wxPoint& pos) const override;
|
|
virtual wxWindow* GetHTMLWindow() override;
|
|
virtual wxColour GetHTMLBackgroundColour() const override;
|
|
virtual void SetHTMLBackgroundColour(const wxColour& clr) override;
|
|
virtual void SetHTMLBackgroundImage(const wxBitmapBundle& bmpBg) override;
|
|
virtual void SetHTMLStatusText(const wxString& text) override;
|
|
virtual wxCursor GetHTMLCursor(HTMLCursor type) const override;
|
|
|
|
// returns index of item that contains given HTML cell
|
|
size_t GetItemForCell(const wxHtmlCell *cell) const;
|
|
|
|
// Create the cell for the given item, caller is responsible for freeing it.
|
|
wxHtmlCell* CreateCellForItem(size_t n) 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
|
|
wxHtmlListBoxCache *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
|
|
wxHtmlListBoxStyle *m_htmlRendStyle;
|
|
|
|
|
|
// it calls our GetSelectedTextColour() and GetSelectedTextBgColour()
|
|
friend class wxHtmlListBoxStyle;
|
|
friend class wxHtmlListBoxWinInterface;
|
|
|
|
|
|
wxDECLARE_EVENT_TABLE();
|
|
wxDECLARE_NO_COPY_CLASS(wxHtmlListBox);
|
|
};
|
|
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// wxSimpleHtmlListBox
|
|
// ----------------------------------------------------------------------------
|
|
|
|
#define wxHLB_DEFAULT_STYLE wxBORDER_SUNKEN
|
|
#define wxHLB_MULTIPLE wxLB_MULTIPLE
|
|
|
|
class WXDLLIMPEXP_HTML wxSimpleHtmlListBox :
|
|
public wxWindowWithItems<wxHtmlListBox, wxItemContainer>
|
|
{
|
|
wxDECLARE_ABSTRACT_CLASS(wxSimpleHtmlListBox);
|
|
public:
|
|
// wxListbox-compatible constructors
|
|
// ---------------------------------
|
|
|
|
wxSimpleHtmlListBox() { }
|
|
|
|
wxSimpleHtmlListBox(wxWindow *parent,
|
|
wxWindowID id,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
int n = 0, const wxString choices[] = nullptr,
|
|
long style = wxHLB_DEFAULT_STYLE,
|
|
const wxValidator& validator = wxDefaultValidator,
|
|
const wxString& name = wxASCII_STR(wxSimpleHtmlListBoxNameStr))
|
|
{
|
|
Create(parent, id, pos, size, n, choices, style, validator, name);
|
|
}
|
|
|
|
wxSimpleHtmlListBox(wxWindow *parent,
|
|
wxWindowID id,
|
|
const wxPoint& pos,
|
|
const wxSize& size,
|
|
const wxArrayString& choices,
|
|
long style = wxHLB_DEFAULT_STYLE,
|
|
const wxValidator& validator = wxDefaultValidator,
|
|
const wxString& name = wxASCII_STR(wxSimpleHtmlListBoxNameStr))
|
|
{
|
|
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[] = nullptr,
|
|
long style = wxHLB_DEFAULT_STYLE,
|
|
const wxValidator& validator = wxDefaultValidator,
|
|
const wxString& name = wxASCII_STR(wxSimpleHtmlListBoxNameStr));
|
|
bool Create(wxWindow *parent, wxWindowID id,
|
|
const wxPoint& pos,
|
|
const wxSize& size,
|
|
const wxArrayString& choices,
|
|
long style = wxHLB_DEFAULT_STYLE,
|
|
const wxValidator& validator = wxDefaultValidator,
|
|
const wxString& name = wxASCII_STR(wxSimpleHtmlListBoxNameStr));
|
|
|
|
virtual ~wxSimpleHtmlListBox();
|
|
|
|
// these must be overloaded otherwise the compiler will complain
|
|
// about wxItemContainerImmutable::[G|S]etSelection being pure virtuals...
|
|
void SetSelection(int n) override
|
|
{ wxVListBox::SetSelection(n); }
|
|
int GetSelection() const override
|
|
{ return wxVListBox::GetSelection(); }
|
|
|
|
|
|
// accessing strings
|
|
// -----------------
|
|
|
|
virtual unsigned int GetCount() const override
|
|
{ return static_cast<unsigned int>(m_items.GetCount()); }
|
|
|
|
virtual wxString GetString(unsigned int n) const override;
|
|
|
|
// override default unoptimized wxItemContainer::GetStrings() function
|
|
wxArrayString GetStrings() const
|
|
{ return m_items; }
|
|
|
|
virtual void SetString(unsigned int n, const wxString& s) override;
|
|
|
|
// resolve ambiguity between wxItemContainer and wxVListBox versions
|
|
void Clear() override;
|
|
|
|
protected:
|
|
virtual int DoInsertItems(const wxArrayStringsAdapter & items,
|
|
unsigned int pos,
|
|
void **clientData, wxClientDataType type) override;
|
|
|
|
virtual void DoSetItemClientData(unsigned int n, void *clientData) override
|
|
{ m_HTMLclientData[n] = clientData; }
|
|
|
|
virtual void *DoGetItemClientData(unsigned int n) const override
|
|
{ return m_HTMLclientData[n]; }
|
|
|
|
// wxItemContainer methods
|
|
virtual void DoClear() override;
|
|
virtual void DoDeleteOneItem(unsigned int n) override;
|
|
|
|
// calls wxHtmlListBox::SetItemCount() and RefreshAll()
|
|
void UpdateCount();
|
|
|
|
// override these functions just to change their visibility: users of
|
|
// wxSimpleHtmlListBox shouldn't be allowed to call them directly!
|
|
virtual void SetItemCount(size_t count) override
|
|
{ wxHtmlListBox::SetItemCount(count); }
|
|
virtual void SetRowCount(size_t count)
|
|
{ wxHtmlListBox::SetRowCount(count); }
|
|
|
|
virtual wxString OnGetItem(size_t n) const override
|
|
{ return m_items[n]; }
|
|
|
|
virtual void InitEvent(wxCommandEvent& event, int n) override
|
|
{
|
|
// we're not a virtual control and we can include the string
|
|
// of the item which was clicked:
|
|
event.SetString(m_items[n]);
|
|
wxVListBox::InitEvent(event, n);
|
|
}
|
|
|
|
wxArrayString m_items;
|
|
wxArrayPtrVoid m_HTMLclientData;
|
|
|
|
// Note: For the benefit of old compilers (like gcc-2.8) this should
|
|
// not be named m_clientdata as that clashes with the name of an
|
|
// anonymous struct member in wxEvtHandler, which we derive from.
|
|
|
|
wxDECLARE_NO_COPY_CLASS(wxSimpleHtmlListBox);
|
|
};
|
|
|
|
#endif // wxUSE_HTML
|
|
|
|
#endif // _WX_HTMLLBOX_H_
|
|
|