// Purpose: interface of wxHtmlTagHandler
// Author: wxWidgets team
// RCS-ID: $Id$
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
+enum wxHtmlURLType
+{
+ wxHTML_URL_PAGE,
+ wxHTML_URL_IMAGE,
+ wxHTML_URL_OTHER
+};
+
+
+
/**
@class wxHtmlTagHandler
*/
virtual bool HandleTag(const wxHtmlTag& tag) = 0;
+ /**
+ Assigns @a parser to this handler. Each @b instance of handler
+ is guaranteed to be called only from the one parser.
+ */
+ virtual void SetParser(wxHtmlParser* parser);
+
+ /**
+ Returns the parser associated with this tag handler.
+
+ @since 2.9.5
+ */
+ wxHtmlParser* GetParser() const;
+
+
+protected:
+
/**
This method calls parser's wxHtmlParser::DoParsing method
for the string between this tag and the paired ending tag:
void ParseInner(const wxHtmlTag& tag);
/**
- Assigns @a parser to this handler. Each @b instance of handler
- is guaranteed to be called only from the parser.
+ 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 SetParser(wxHtmlParser* parser);
+ void ParseInnerSource(const wxString& source);
-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.
*/
wxHtmlParser();
- /**
- This may (and may not) be overwritten in derived class.
-
- This method is called each time new tag is about to be added.
- @a tag contains information about the tag. (See wxHtmlTag for details.)
-
- Default (wxHtmlParser) behaviour is this: first it finds a handler capable
- of handling this tag and then it calls handler's HandleTag() method.
- */
- virtual void AddTag(const wxHtmlTag& tag);
-
/**
Adds handler to the internal list ( hash table) of handlers.
This method should not be called directly by user but rather by derived class'
/**
Parses the m_Source from @a begin_pos to @a end_pos - 1.
*/
- void DoParsing(int begin_pos, int end_pos);
+ void DoParsing(const const_iterator& begin_pos, const const_iterator& end_pos);
/**
Parses the whole m_Source.
from Parse() or any function called by it (i.e. from tag handlers).
*/
virtual void StopParsing();
+
+protected:
+
+ /**
+ This may (and may not) be overwritten in derived class.
+
+ This method is called each time new tag is about to be added.
+ @a tag contains information about the tag. (See wxHtmlTag for details.)
+
+ Default (wxHtmlParser) behaviour is this: first it finds a handler capable
+ of handling this tag and then it calls handler's HandleTag() method.
+ */
+ virtual void AddTag(const wxHtmlTag& tag);
};