X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/f65a786ffdf52306b8440b3f7a9fc029c4bf3561..a6ab05be988523913fb6bdcb33238c83129f80ee:/include/wx/html/htmlcell.h diff --git a/include/wx/html/htmlcell.h b/include/wx/html/htmlcell.h index 390af0c9ea..982e42f4f9 100644 --- a/include/wx/html/htmlcell.h +++ b/include/wx/html/htmlcell.h @@ -4,7 +4,7 @@ // as a basic visual element of HTML page // Author: Vaclav Slavik // RCS-ID: $Id$ -// Copyright: (c) 1999 Vaclav Slavik +// Copyright: (c) 1999-2003 Vaclav Slavik // Licence: wxWindows Licence ///////////////////////////////////////////////////////////////////////////// @@ -38,31 +38,35 @@ class WXDLLEXPORT wxHtmlSelection public: wxHtmlSelection() : m_fromPos(wxDefaultPosition), m_toPos(wxDefaultPosition), + m_fromPrivPos(wxDefaultPosition), m_toPrivPos(wxDefaultPosition), m_fromCell(NULL), m_toCell(NULL) {} - void Set(const wxPoint& fromPos, wxHtmlCell *fromCell, - const wxPoint& toPos, wxHtmlCell *toCell) - { - m_fromCell = fromCell; - m_toCell = toCell; - m_fromPos = fromPos; - m_toPos = toPos; - } + void Set(const wxPoint& fromPos, const wxHtmlCell *fromCell, + const wxPoint& toPos, const wxHtmlCell *toCell); + void Set(const wxHtmlCell *fromCell, const wxHtmlCell *toCell); - wxHtmlCell *GetFromCell() const { return m_fromCell; } - wxHtmlCell *GetToCell() const { return m_toCell; } + const wxHtmlCell *GetFromCell() const { return m_fromCell; } + const wxHtmlCell *GetToCell() const { return m_toCell; } - // these values are *relative* to From/To cell's origin: + // these values are in absolute coordinates: const wxPoint& GetFromPos() const { return m_fromPos; } const wxPoint& GetToPos() const { return m_toPos; } + + // these are From/ToCell's private data + const wxPoint& GetFromPrivPos() const { return m_fromPrivPos; } + const wxPoint& GetToPrivPos() const { return m_toPrivPos; } + void SetFromPrivPos(const wxPoint& pos) { m_fromPrivPos = pos; } + void SetToPrivPos(const wxPoint& pos) { m_toPrivPos = pos; } + void ClearPrivPos() { m_toPrivPos = m_fromPrivPos = wxDefaultPosition; } const bool IsEmpty() const { return m_fromPos == wxDefaultPosition && m_toPos == wxDefaultPosition; } private: - wxPoint m_fromPos, m_toPos; - wxHtmlCell *m_fromCell, *m_toCell; + wxPoint m_fromPos, m_toPos; + wxPoint m_fromPrivPos, m_toPrivPos; + const wxHtmlCell *m_fromCell, *m_toCell; }; @@ -79,9 +83,7 @@ enum wxHtmlSelectionState class WXDLLEXPORT wxHtmlRenderingState { public: - wxHtmlRenderingState(wxHtmlSelection *s) - : m_selection(s), m_selState(wxHTML_SEL_OUT) {} - wxHtmlSelection *GetSelection() const { return m_selection; } + wxHtmlRenderingState() : m_selState(wxHTML_SEL_OUT) {} void SetSelectionState(wxHtmlSelectionState s) { m_selState = s; } wxHtmlSelectionState GetSelectionState() const { return m_selState; } @@ -92,19 +94,63 @@ public: const wxColour& GetBgColour() const { return m_bgColour; } private: - wxHtmlSelection *m_selection; wxHtmlSelectionState m_selState; wxColour m_fgColour, m_bgColour; }; + +// HTML rendering customization. This class is used when rendering wxHtmlCells +// as a callback: +class WXDLLEXPORT wxHtmlRenderingStyle +{ +public: + virtual wxColour GetSelectedTextColour(const wxColour& clr) = 0; + virtual wxColour GetSelectedTextBgColour(const wxColour& clr) = 0; +}; + +// Standard style: +class WXDLLEXPORT wxDefaultHtmlRenderingStyle : public wxHtmlRenderingStyle +{ +public: + virtual wxColour GetSelectedTextColour(const wxColour& clr); + virtual wxColour GetSelectedTextBgColour(const wxColour& clr); +}; + + +// Information given to cells when drawing them. Contains rendering state, +// selection information and rendering style object that can be used to +// customize the output. +class WXDLLEXPORT wxHtmlRenderingInfo +{ +public: + wxHtmlRenderingInfo() : m_selection(NULL), m_style(NULL) {} + + void SetSelection(wxHtmlSelection *s) { m_selection = s; } + wxHtmlSelection *GetSelection() const { return m_selection; } + + void SetStyle(wxHtmlRenderingStyle *style) { m_style = style; } + wxHtmlRenderingStyle& GetStyle() { return *m_style; } + + wxHtmlRenderingState& GetState() { return m_state; } + +protected: + wxHtmlSelection *m_selection; + wxHtmlRenderingStyle *m_style; + wxHtmlRenderingState m_state; +}; + + // Flags for wxHtmlCell::FindCellByPos enum { - wxHTML_FIND_TERMINAL = 0x0001, - wxHTML_FIND_NONTERMINAL = 0x0002 + wxHTML_FIND_EXACT = 1, + wxHTML_FIND_NEAREST_BEFORE = 2, + wxHTML_FIND_NEAREST_AFTER = 4 }; + + // --------------------------------------------------------------------------- // wxHtmlCell // Internal data structure. It represents fragments of parsed @@ -134,11 +180,17 @@ public: // returns the link associated with this cell. The position is position // within the cell so it varies from 0 to m_Width, from 0 to m_Height - virtual wxHtmlLinkInfo* GetLink(int WXUNUSED(x) = 0, int WXUNUSED(y) = 0) const + virtual wxHtmlLinkInfo* GetLink(int WXUNUSED(x) = 0, + int WXUNUSED(y) = 0) const { return m_Link; } - // members access methods + // Returns cursor to be used when mouse is over the cell: + virtual wxCursor GetCursor() const; + + // return next cell among parent's cells wxHtmlCell *GetNext() const {return m_Next;} + // returns first child cell (if there are any, i.e. if this is container): + virtual wxHtmlCell* GetFirstChild() const { return NULL; } // members writing methods virtual void SetPos(int x, int y) {m_PosX = x, m_PosY = y;} @@ -156,13 +208,13 @@ public: virtual void Draw(wxDC& WXUNUSED(dc), int WXUNUSED(x), int WXUNUSED(y), int WXUNUSED(view_y1), int WXUNUSED(view_y2), - wxHtmlRenderingState& WXUNUSED(state)) {} + wxHtmlRenderingInfo& WXUNUSED(info)) {} // proceed drawing actions in case the cell is not visible (scrolled out of // screen). This is needed to change fonts, colors and so on. virtual void DrawInvisible(wxDC& WXUNUSED(dc), int WXUNUSED(x), int WXUNUSED(y), - wxHtmlRenderingState& WXUNUSED(state)) {} + wxHtmlRenderingInfo& WXUNUSED(info)) {} // This method returns pointer to the FIRST cell for that // the condition @@ -215,7 +267,31 @@ public: // nonterminal cells or both. In either case, returned cell is deepest // cell in cells tree that contains [x,y]. virtual wxHtmlCell *FindCellByPos(wxCoord x, wxCoord y, - unsigned flags = wxHTML_FIND_TERMINAL) const; + unsigned flags = wxHTML_FIND_EXACT) const; + + // Returns absolute position of the cell on HTML canvas + wxPoint GetAbsPos() const; + + // Returns first (last) terminal cell inside this cell. It may return NULL, + // but it is rare -- only if there are no terminals in the tree. + virtual wxHtmlCell *GetFirstTerminal() const + { return wxConstCast(this, wxHtmlCell); } + virtual wxHtmlCell *GetLastTerminal() const + { return wxConstCast(this, wxHtmlCell); } + + // Returns cell's depth, i.e. how far under the root cell it is + // (if it is the root, depth is 0) + unsigned GetDepth() const; + + // Returns true if the cell appears before 'cell' in natural order of + // cells (= as they are read). If cell A is (grand)parent of cell B, + // then both A.IsBefore(B) and B.IsBefore(A) always return true. + bool IsBefore(wxHtmlCell *cell) const; + + // Converts the cell into text representation. If sel != NULL then + // only part of the cell inside the selection is converted. + virtual wxString ConvertToText(wxHtmlSelection *WXUNUSED(sel)) const + { return wxEmptyString; } protected: wxHtmlCell *m_Next; @@ -240,24 +316,31 @@ protected: -//-------------------------------------------------------------------------------- +// ---------------------------------------------------------------------------- // Inherited cells: -//-------------------------------------------------------------------------------- +// ---------------------------------------------------------------------------- -//-------------------------------------------------------------------------------- +// ---------------------------------------------------------------------------- // wxHtmlWordCell // Single word in input stream. -//-------------------------------------------------------------------------------- +// ---------------------------------------------------------------------------- class WXDLLEXPORT wxHtmlWordCell : public wxHtmlCell { public: wxHtmlWordCell(const wxString& word, wxDC& dc); void Draw(wxDC& dc, int x, int y, int view_y1, int view_y2, - wxHtmlRenderingState& state); + wxHtmlRenderingInfo& info); + wxCursor GetCursor() const; + wxString ConvertToText(wxHtmlSelection *sel) const; protected: + void SetSelectionPrivPos(wxDC& dc, wxHtmlSelection *s) const; + void Split(wxDC& dc, + const wxPoint& selFrom, const wxPoint& selTo, + unsigned& pos1, unsigned& pos2) const; + wxString m_Word; }; @@ -275,9 +358,9 @@ public: virtual void Layout(int w); virtual void Draw(wxDC& dc, int x, int y, int view_y1, int view_y2, - wxHtmlRenderingState& state); + wxHtmlRenderingInfo& info); virtual void DrawInvisible(wxDC& dc, int x, int y, - wxHtmlRenderingState& state); + wxHtmlRenderingInfo& info); virtual bool AdjustPagebreak(int *pagebreak, int *known_pagebreaks = NULL, int number_of_pages = 0) const; // insert cell at the end of m_Cells list @@ -317,19 +400,24 @@ public: virtual void OnMouseClick(wxWindow *parent, int x, int y, const wxMouseEvent& event); virtual void GetHorizontalConstraints(int *left, int *right) const; - // returns pointer to the first cell in container or NULL - wxHtmlCell* GetFirstCell() const {return m_Cells;} + virtual wxHtmlCell* GetFirstChild() const { return m_Cells; } +#if WXWIN_COMPATIBILITY_2_4 + wxDEPRECATED( wxHtmlCell* GetFirstCell() const ); +#endif // see comment in wxHtmlCell about this method virtual bool IsTerminalCell() const { return FALSE; } virtual wxHtmlCell *FindCellByPos(wxCoord x, wxCoord y, - unsigned flags = wxHTML_FIND_TERMINAL) const; + unsigned flags = wxHTML_FIND_EXACT) const; + + virtual wxHtmlCell *GetFirstTerminal() const; + virtual wxHtmlCell *GetLastTerminal() const; protected: - void UpdateRenderingStatePre(wxHtmlRenderingState& state, + void UpdateRenderingStatePre(wxHtmlRenderingInfo& info, wxHtmlCell *cell) const; - void UpdateRenderingStatePost(wxHtmlRenderingState& state, + void UpdateRenderingStatePost(wxHtmlRenderingInfo& info, wxHtmlCell *cell) const; protected: @@ -359,23 +447,27 @@ protected: DECLARE_NO_COPY_CLASS(wxHtmlContainerCell) }; +#if WXWIN_COMPATIBILITY_2_4 +inline wxHtmlCell* wxHtmlContainerCell::GetFirstCell() const + { return GetFirstChild(); } +#endif -//-------------------------------------------------------------------------------- +// --------------------------------------------------------------------------- // wxHtmlColourCell // Color changer. -//-------------------------------------------------------------------------------- +// --------------------------------------------------------------------------- class WXDLLEXPORT wxHtmlColourCell : public wxHtmlCell { public: wxHtmlColourCell(const wxColour& clr, int flags = wxHTML_CLR_FOREGROUND) : wxHtmlCell() {m_Colour = clr; m_Flags = flags;} virtual void Draw(wxDC& dc, int x, int y, int view_y1, int view_y2, - wxHtmlRenderingState& state); + wxHtmlRenderingInfo& info); virtual void DrawInvisible(wxDC& dc, int x, int y, - wxHtmlRenderingState& state); + wxHtmlRenderingInfo& info); protected: wxColour m_Colour; @@ -395,9 +487,9 @@ class WXDLLEXPORT wxHtmlFontCell : public wxHtmlCell public: wxHtmlFontCell(wxFont *font) : wxHtmlCell() { m_Font = (*font); } virtual void Draw(wxDC& dc, int x, int y, int view_y1, int view_y2, - wxHtmlRenderingState& state); + wxHtmlRenderingInfo& info); virtual void DrawInvisible(wxDC& dc, int x, int y, - wxHtmlRenderingState& state); + wxHtmlRenderingInfo& info); protected: wxFont m_Font; @@ -425,9 +517,9 @@ public: wxHtmlWidgetCell(wxWindow *wnd, int w = 0); ~wxHtmlWidgetCell() { m_Wnd->Destroy(); } virtual void Draw(wxDC& dc, int x, int y, int view_y1, int view_y2, - wxHtmlRenderingState& state); + wxHtmlRenderingInfo& info); virtual void DrawInvisible(wxDC& dc, int x, int y, - wxHtmlRenderingState& state); + wxHtmlRenderingInfo& info); virtual void Layout(int w); protected: @@ -475,6 +567,26 @@ private: +// ---------------------------------------------------------------------------- +// wxHtmlTerminalCellsInterator +// ---------------------------------------------------------------------------- + +class WXDLLEXPORT wxHtmlTerminalCellsInterator +{ +public: + wxHtmlTerminalCellsInterator(const wxHtmlCell *from, const wxHtmlCell *to) + : m_to(to), m_pos(from) {} + + operator bool() const { return m_pos != NULL; } + const wxHtmlCell* operator++(); + const wxHtmlCell* operator->() const { return m_pos; } + const wxHtmlCell* operator*() const { return m_pos; } + +private: + const wxHtmlCell *m_to, *m_pos; +}; + + #endif // wxUSE_HTML