Version: 3.3.0
wxHtmlWindowInterface Class Referenceabstract

#include <wx/html/htmlwin.h>

+ Inheritance diagram for wxHtmlWindowInterface:

Detailed Description

Abstract interface to a HTML rendering window (such as wxHtmlWindow or wxHtmlListBox) that is passed to wxHtmlWinParser.

It encapsulates all communication from the parser to the window.

Public Types

enum  HTMLCursor {
  HTMLCursor_Default ,
  HTMLCursor_Link ,
  HTMLCursor_Text
}
 Type of mouse cursor. More...
 

Public Member Functions

 wxHtmlWindowInterface ()
 Ctor. More...
 
virtual ~wxHtmlWindowInterface ()
 
virtual void SetHTMLWindowTitle (const wxString &title)=0
 Called by the parser to set window's title to given text. More...
 
virtual void OnHTMLLinkClicked (const wxHtmlLinkInfo &link)=0
 Called when a link is clicked. More...
 
virtual wxHtmlOpeningStatus OnHTMLOpeningURL (wxHtmlURLType type, const wxString &url, wxString *redirect) const =0
 Called when the parser needs to open another URL (e.g. More...
 
virtual wxPoint HTMLCoordsToWindow (wxHtmlCell *cell, const wxPoint &pos) const =0
 Converts coordinates pos relative to given cell to physical coordinates in the window. More...
 
virtual wxWindowGetHTMLWindow ()=0
 Returns the window used for rendering (may be nullptr). More...
 
virtual wxColour GetHTMLBackgroundColour () const =0
 Returns background colour to use by default. More...
 
virtual void SetHTMLBackgroundColour (const wxColour &clr)=0
 Sets window's background to colour clr. More...
 
virtual void SetHTMLBackgroundImage (const wxBitmapBundle &bmpBg)=0
 Sets window's background to given bitmap. More...
 
virtual void SetHTMLStatusText (const wxString &text)=0
 Sets status bar text. More...
 
virtual wxCursor GetHTMLCursor (wxHtmlWindowInterface::HTMLCursor type) const =0
 Returns mouse cursor of given type. More...
 

Member Enumeration Documentation

◆ HTMLCursor

Type of mouse cursor.

Enumerator
HTMLCursor_Default 

Standard mouse cursor (typically an arrow)

HTMLCursor_Link 

Cursor shown over links.

HTMLCursor_Text 

Cursor shown over selectable text.

Constructor & Destructor Documentation

◆ wxHtmlWindowInterface()

wxHtmlWindowInterface::wxHtmlWindowInterface ( )

Ctor.

◆ ~wxHtmlWindowInterface()

virtual wxHtmlWindowInterface::~wxHtmlWindowInterface ( )
virtual

Member Function Documentation

◆ GetHTMLBackgroundColour()

virtual wxColour wxHtmlWindowInterface::GetHTMLBackgroundColour ( ) const
pure virtual

Returns background colour to use by default.

◆ GetHTMLCursor()

virtual wxCursor wxHtmlWindowInterface::GetHTMLCursor ( wxHtmlWindowInterface::HTMLCursor  type) const
pure virtual

Returns mouse cursor of given type.

◆ GetHTMLWindow()

virtual wxWindow* wxHtmlWindowInterface::GetHTMLWindow ( )
pure virtual

Returns the window used for rendering (may be nullptr).

◆ HTMLCoordsToWindow()

virtual wxPoint wxHtmlWindowInterface::HTMLCoordsToWindow ( wxHtmlCell cell,
const wxPoint pos 
) const
pure virtual

Converts coordinates pos relative to given cell to physical coordinates in the window.

◆ OnHTMLLinkClicked()

virtual void wxHtmlWindowInterface::OnHTMLLinkClicked ( const wxHtmlLinkInfo link)
pure virtual

Called when a link is clicked.

Parameters
linkinformation about the clicked link

◆ OnHTMLOpeningURL()

virtual wxHtmlOpeningStatus wxHtmlWindowInterface::OnHTMLOpeningURL ( wxHtmlURLType  type,
const wxString url,
wxString redirect 
) const
pure virtual

Called when the parser needs to open another URL (e.g.

an image).

Parameters
typeType of the URL request (e.g. image)
urlURL the parser wants to open
redirectIf the return value is wxHTML_REDIRECT, then the URL to redirect to will be stored in this variable (the pointer must never be nullptr)
Returns
indicator of how to treat the request

◆ SetHTMLBackgroundColour()

virtual void wxHtmlWindowInterface::SetHTMLBackgroundColour ( const wxColour clr)
pure virtual

Sets window's background to colour clr.

◆ SetHTMLBackgroundImage()

virtual void wxHtmlWindowInterface::SetHTMLBackgroundImage ( const wxBitmapBundle bmpBg)
pure virtual

Sets window's background to given bitmap.

◆ SetHTMLStatusText()

virtual void wxHtmlWindowInterface::SetHTMLStatusText ( const wxString text)
pure virtual

Sets status bar text.

◆ SetHTMLWindowTitle()

virtual void wxHtmlWindowInterface::SetHTMLWindowTitle ( const wxString title)
pure virtual

Called by the parser to set window's title to given text.