Version: 3.1.0
wxHtmlTagHandler Class Referenceabstract

#include <wx/html/htmlpars.h>

+ Inheritance diagram for wxHtmlTagHandler:

Detailed Description

Todo:
describe me

Library:  wxHTML
Category:  HTML
See Also
Tag Handlers, wxHtmlTag

Public Member Functions

 wxHtmlTagHandler ()
 Constructor.
 
virtual wxString GetSupportedTags ()=0
 Returns list of supported tags.
 
virtual bool HandleTag (const wxHtmlTag &tag)=0
 This is the core method of each handler.
 
virtual void SetParser (wxHtmlParser *parser)
 Assigns parser to this handler.
 
wxHtmlParserGetParser () const
 Returns the parser associated with this tag handler.
 
- Public Member Functions inherited from wxObject
 wxObject ()
 Default ctor; initializes to NULL the internal reference data.
 
 wxObject (const wxObject &other)
 Copy ctor.
 
virtual ~wxObject ()
 Destructor.
 
virtual wxClassInfoGetClassInfo () const
 This virtual function is redefined for every class that requires run-time type information, when using the wxDECLARE_CLASS macro (or similar).
 
wxObjectRefDataGetRefData () const
 Returns the wxObject::m_refData pointer, i.e. the data referenced by this object.
 
bool IsKindOf (const wxClassInfo *info) const
 Determines whether this class is a subclass of (or the same class as) the given class.
 
bool IsSameAs (const wxObject &obj) const
 Returns true if this object has the same data pointer as obj.
 
void Ref (const wxObject &clone)
 Makes this object refer to the data in clone.
 
void SetRefData (wxObjectRefData *data)
 Sets the wxObject::m_refData pointer.
 
void UnRef ()
 Decrements the reference count in the associated data, and if it is zero, deletes the data.
 
void UnShare ()
 This is the same of AllocExclusive() but this method is public.
 
void operator delete (void *buf)
 The delete operator is defined for debugging versions of the library only, when the identifier WXDEBUG is defined.
 
void * operator new (size_t size, const wxString &filename=NULL, int lineNum=0)
 The new operator is defined for debugging versions of the library only, when the identifier WXDEBUG is defined.
 

Protected Member Functions

void ParseInner (const wxHtmlTag &tag)
 This method calls parser's wxHtmlParser::DoParsing method for the string between this tag and the paired ending tag:
 
void ParseInnerSource (const wxString &source)
 Parses given source as if it was tag's inner code (see wxHtmlParser::GetInnerSource).
 
- Protected Member Functions inherited from wxObject
void AllocExclusive ()
 Ensure that this object's data is not shared with any other object.
 
virtual wxObjectRefDataCreateRefData () const
 Creates a new instance of the wxObjectRefData-derived class specific to this object and returns it.
 
virtual wxObjectRefDataCloneRefData (const wxObjectRefData *data) const
 Creates a new instance of the wxObjectRefData-derived class specific to this object and initializes it copying data.
 

Protected Attributes

wxHtmlParserm_Parser
 This attribute is used to access parent parser.
 
- Protected Attributes inherited from wxObject
wxObjectRefDatam_refData
 Pointer to an object which is the object's reference-counted data.
 

Constructor & Destructor Documentation

wxHtmlTagHandler::wxHtmlTagHandler ( )

Constructor.

Member Function Documentation

wxHtmlParser* wxHtmlTagHandler::GetParser ( ) const

Returns the parser associated with this tag handler.

Since
2.9.5
virtual wxString wxHtmlTagHandler::GetSupportedTags ( )
pure virtual

Returns list of supported tags.

The list is in uppercase and tags are delimited by ','. Example: "I,B,FONT,P"

virtual bool wxHtmlTagHandler::HandleTag ( const wxHtmlTag tag)
pure virtual

This is the core method of each handler.

It is called each time one of supported tags is detected. tag contains all necessary info (see wxHtmlTag for details).

Example:

bool MyHandler::HandleTag(const wxHtmlTag& tag)
{
...
// change state of parser (e.g. set bold face)
ParseInner(tag);
...
// restore original state of parser
}

You shouldn't call ParseInner() if the tag is not paired with an ending one.

Returns
true if ParseInner() was called, false otherwise.
void wxHtmlTagHandler::ParseInner ( const wxHtmlTag tag)
protected

This method calls parser's wxHtmlParser::DoParsing method for the string between this tag and the paired ending tag:

...<A HREF="x.htm">Hello, world!</A>...

In this example, a call to ParseInner() (with tag pointing to A tag) will parse 'Hello, world!'.

void wxHtmlTagHandler::ParseInnerSource ( const wxString source)
protected

Parses given source as if it was tag's inner code (see wxHtmlParser::GetInnerSource).

Unlike ParseInner(), this method lets you specify the source code to parse. This is useful when you need to modify the inner text before parsing.

virtual void wxHtmlTagHandler::SetParser ( wxHtmlParser parser)
virtual

Assigns parser to this handler.

Each instance of handler is guaranteed to be called only from the one parser.

Member Data Documentation

wxHtmlParser* wxHtmlTagHandler::m_Parser
protected

This attribute is used to access parent parser.

It is protected so that it can't be accessed by user but can be accessed from derived classes.