1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: wxHtmlTag class (represents single tag)
4 // Author: Vaclav Slavik
6 // Copyright: (c) 1999 Vaclav Slavik
7 // Licence: wxWindows licence
8 /////////////////////////////////////////////////////////////////////////////
10 #ifndef _WX_HTMLTAG_H_
11 #define _WX_HTMLTAG_H_
17 #include "wx/object.h"
18 #include "wx/arrstr.h"
20 class WXDLLIMPEXP_FWD_CORE wxColour
;
21 class WXDLLIMPEXP_FWD_HTML wxHtmlEntitiesParser
;
23 //-----------------------------------------------------------------------------
25 // - internal wxHTML class, do not use!
26 //-----------------------------------------------------------------------------
28 class wxHtmlTagsCacheData
;
30 class WXDLLIMPEXP_HTML wxHtmlTagsCache
: public wxObject
32 DECLARE_DYNAMIC_CLASS(wxHtmlTagsCache
)
35 wxHtmlTagsCacheData
*m_Cache
;
38 wxHtmlTagsCacheData
& Cache() { return *m_Cache
; }
41 wxHtmlTagsCache() {m_Cache
= NULL
;}
42 wxHtmlTagsCache(const wxString
& source
);
43 virtual ~wxHtmlTagsCache();
45 // Finds parameters for tag starting at at and fills the variables
46 void QueryTag(int at
, int* end1
, int* end2
);
48 DECLARE_NO_COPY_CLASS(wxHtmlTagsCache
)
52 //--------------------------------------------------------------------------------
54 // This represents single tag. It is used as internal structure
56 //--------------------------------------------------------------------------------
58 class WXDLLIMPEXP_HTML wxHtmlTag
: public wxObject
60 DECLARE_CLASS(wxHtmlTag
)
63 // constructs wxHtmlTag object based on HTML tag.
64 // The tag begins (with '<' character) at position pos in source
65 // end_pos is position where parsing ends (usually end of document)
66 wxHtmlTag(wxHtmlTag
*parent
,
67 const wxString
& source
, int pos
, int end_pos
,
68 wxHtmlTagsCache
*cache
,
69 wxHtmlEntitiesParser
*entParser
);
70 friend class wxHtmlParser
;
74 wxHtmlTag
*GetParent() const {return m_Parent
;}
75 wxHtmlTag
*GetFirstSibling() const;
76 wxHtmlTag
*GetLastSibling() const;
77 wxHtmlTag
*GetChildren() const { return m_FirstChild
; }
78 wxHtmlTag
*GetPreviousSibling() const { return m_Prev
; }
79 wxHtmlTag
*GetNextSibling() const {return m_Next
; }
80 // Return next tag, as if tree had been flattened
81 wxHtmlTag
*GetNextTag() const;
83 // Returns tag's name in uppercase.
84 inline wxString
GetName() const {return m_Name
;}
86 // Returns true if the tag has given parameter. Parameter
87 // should always be in uppercase.
88 // Example : <IMG SRC="test.jpg"> HasParam("SRC") returns true
89 bool HasParam(const wxString
& par
) const;
91 // Returns value of the param. Value is in uppercase unless it is
93 // Example : <P align=right> GetParam("ALIGN") returns (RIGHT)
94 // <P IMG SRC="WhaT.jpg"> GetParam("SRC") returns (WhaT.jpg)
95 // (or ("WhaT.jpg") if with_commas == true)
96 wxString
GetParam(const wxString
& par
, bool with_commas
= false) const;
98 // Convenience functions:
99 bool GetParamAsColour(const wxString
& par
, wxColour
*clr
) const;
100 bool GetParamAsInt(const wxString
& par
, int *clr
) const;
102 // Scans param like scanf() functions family does.
103 // Example : ScanParam("COLOR", "\"#%X\"", &clr);
104 // This is always with with_commas=false
105 // Returns number of scanned values
106 // (like sscanf() does)
107 // NOTE: unlike scanf family, this function only accepts
109 int ScanParam(const wxString
& par
, const char *format
, void *param
) const;
110 int ScanParam(const wxString
& par
, const wchar_t *format
, void *param
) const;
112 // Returns string containing all params.
113 wxString
GetAllParams() const;
115 // return true if this there is matching ending tag
116 inline bool HasEnding() const {return m_End1
>= 0;}
118 // returns beginning position of _internal_ block of text
119 // See explanation (returned value is marked with *):
120 // bla bla bla <MYTAG>* bla bla intenal text</MYTAG> bla bla
121 inline int GetBeginPos() const {return m_Begin
;}
122 // returns ending position of _internal_ block of text.
123 // bla bla bla <MYTAG> bla bla intenal text*</MYTAG> bla bla
124 inline int GetEndPos1() const {return m_End1
;}
125 // returns end position 2 :
126 // bla bla bla <MYTAG> bla bla internal text</MYTAG>* bla bla
127 inline int GetEndPos2() const {return m_End2
;}
131 int m_Begin
, m_End1
, m_End2
;
132 wxArrayString m_ParamNames
, m_ParamValues
;
134 // DOM tree relations:
137 wxHtmlTag
*m_FirstChild
, *m_LastChild
;
140 DECLARE_NO_COPY_CLASS(wxHtmlTag
)
149 #endif // _WX_HTMLTAG_H_