X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/499f945e997aca1af732adb861addb2d7edc0ca5..db7035e48a4ccc6265fa01949cb92db3c6b6c17f:/include/wx/html/htmltag.h diff --git a/include/wx/html/htmltag.h b/include/wx/html/htmltag.h index 750a2e8477..40bcf48871 100644 --- a/include/wx/html/htmltag.h +++ b/include/wx/html/htmltag.h @@ -2,63 +2,53 @@ // Name: htmltag.h // Purpose: wxHtmlTag class (represents single tag) // Author: Vaclav Slavik +// RCS-ID: $Id$ // Copyright: (c) 1999 Vaclav Slavik -// Licence: wxWindows Licence +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// - -#ifndef __HTMLTAG_H__ -#define __HTMLTAG_H__ - -#ifdef __GNUG__ -#pragma interface -#endif +#ifndef _WX_HTMLTAG_H_ +#define _WX_HTMLTAG_H_ #include "wx/defs.h" -#if wxUSE_HTML +#if wxUSE_HTML -//-------------------------------------------------------------------------------- -// wxHtmlTagsCache -// !! INTERNAL STRUCTURE !! Do not use in your program! -// This structure contains information on positions of tags -// in the string being parsed -//-------------------------------------------------------------------------------- +#include "wx/object.h" +#include "wx/arrstr.h" -typedef struct { - int Key; - // this is "pos" value passed to wxHtmlTag's constructor. - // it is position of '<' character of the tag - int End1, End2; - // end positions for the tag: - // end1 is '<' of ending tag, - // end2 is '>' or both are - // -1 if there is no ending tag for this one... - // or -2 if this is ending tag - char *Name; - // name of this tag - } sCacheItem; +class WXDLLIMPEXP_FWD_CORE wxColour; +class WXDLLIMPEXP_FWD_HTML wxHtmlEntitiesParser; +//----------------------------------------------------------------------------- +// wxHtmlTagsCache +// - internal wxHTML class, do not use! +//----------------------------------------------------------------------------- +class wxHtmlTagsCacheData; -class wxHtmlTagsCache : public wxObject +class WXDLLIMPEXP_HTML wxHtmlTagsCache { - DECLARE_DYNAMIC_CLASS(wxHtmlTagsCache) +private: + wxHtmlTagsCacheData *m_Cache; + int m_CachePos; - private: - sCacheItem *m_Cache; - int m_CacheSize; - int m_CachePos; + wxHtmlTagsCacheData& Cache() { return *m_Cache; } - public: - wxHtmlTagsCache() : wxObject() {m_CacheSize = 0; m_Cache = NULL;} - wxHtmlTagsCache(const wxString& source); - ~wxHtmlTagsCache() {free(m_Cache);} +public: + wxHtmlTagsCache() {m_Cache = NULL;} + wxHtmlTagsCache(const wxString& source); + virtual ~wxHtmlTagsCache(); - void QueryTag(int at, int* end1, int* end2); - // Finds parameters for tag starting at at and fills the variables -}; + // Finds parameters for tag starting at at and fills the variables + void QueryTag(const wxString::const_iterator& at, + const wxString::const_iterator& inputEnd, + wxString::const_iterator *end1, + wxString::const_iterator *end2, + bool *hasEnding); + DECLARE_NO_COPY_CLASS(wxHtmlTagsCache) +}; //-------------------------------------------------------------------------------- @@ -67,71 +57,119 @@ class wxHtmlTagsCache : public wxObject // by wxHtmlParser. //-------------------------------------------------------------------------------- -class WXDLLEXPORT wxHtmlTag : public wxObject +class WXDLLIMPEXP_HTML wxHtmlTag { - DECLARE_CLASS(wxHtmlTag) - - private: - wxString m_Name, m_Params; - int m_Begin, m_End1, m_End2; - bool m_Ending; - - public: - wxHtmlTag(const wxString& source, int pos, int end_pos, wxHtmlTagsCache* cache); - // constructs wxHtmlTag object based on HTML tag. - // The tag begins (with '<' character) at position pos in source - // end_pos is position where parsing ends (usually end of document) - - inline wxString GetName() const {return m_Name;}; - // Returns tag's name in uppercase. - - bool HasParam(const wxString& par) const; - // Returns TRUE if the tag has given parameter. Parameter - // should always be in uppercase. - // Example : HasParam("SRC") returns TRUE - - wxString GetParam(const wxString& par, bool with_commas = FALSE) const; - // Returns value of the param. Value is in uppercase unless it is - // enclosed with " - // Example :
GetParam("ALIGN") returns (RIGHT) - //
GetParam("SRC") returns (WhaT.jpg)
- // (or ("WhaT.jpg") if with_commas == TRUE)
-
- int ScanParam(const wxString& par, char *format, ...) const;
- // Scans param like scanf() functions family do.
- // Example : ScanParam("COLOR", "\"#%X\"", &clr);
- // This is always with with_commas=FALSE
- // Returns number of scanned values
- // (like sscanf() does)
-
- inline const wxString& GetAllParams() const {return m_Params;};
- // Returns string containing all params.
-
- inline bool IsEnding() const {return m_Ending;};
- // return TRUE if this is ending tag () or FALSE
- // if it isn't ( GetParam("ALIGN") returns (RIGHT)
+ // GetParam("SRC") returns (WhaT.jpg)
+ // (or ("WhaT.jpg") if with_quotes == true)
+ wxString GetParam(const wxString& par, bool with_quotes = false) const;
+
+ // Convenience functions:
+ bool GetParamAsColour(const wxString& par, wxColour *clr) const;
+ bool GetParamAsInt(const wxString& par, int *clr) const;
+
+ // Scans param like scanf() functions family does.
+ // Example : ScanParam("COLOR", "\"#%X\"", &clr);
+ // This is always with with_quotes=false
+ // Returns number of scanned values
+ // (like sscanf() does)
+ // NOTE: unlike scanf family, this function only accepts
+ // *one* parameter !
+ int ScanParam(const wxString& par, const char *format, void *param) const;
+ int ScanParam(const wxString& par, const wchar_t *format, void *param) const;
+
+ // Returns string containing all params.
+ wxString GetAllParams() const;
+
+ // return true if there is matching ending tag
+ inline bool HasEnding() const {return m_hasEnding;}
+
+ // returns beginning position of _internal_ block of text as iterator
+ // into parser's source string (see wxHtmlParser::GetSource())
+ // See explanation (returned value is marked with *):
+ // bla bla bla