Customizable Window Layouts

////////////////////////////////////////////////
// xmlfile.h
//
// 2008 Roland Trainor
//


#ifndef _XMLFILE_H_
#define _XMLFILE_H_

#include <istream>

////////////////////////////////////////////////
// CXMLParser
//
// This class is intended to provide a simple 
//  mechanism for loading and parsing-out information 
//  from an XML-based stream.
//

class CXMLParser
{
public:
    class Exception
    {
    public:
        Exception(LPCSTR lpszMessage) : m_strMessage(lpszMessage) {}
        CString& GetErrorMessage(void) { return m_strMessage; }

    private:
        CString m_strMessage;
    };

public:
    // Construction/destruction...
    CXMLParser();
    ~CXMLParser();

    // Persistance...
    virtual void ParseFile(LPCSTR lpszFilename);
    virtual void ParseString(LPCSTR lpszText);
    virtual void ParseStream(std::istream* pStream);

protected:
    // Persistance...
    void* ParseComment(std::istream* pStream, void* pUserData);
    void* ParseProperties(std::istream* pStream, void* pUserData);
    void* ParseProcessingInstruction(std::istream* pStream, LPCSTR lpszTarget, void* pUserData);
    void ParseOverWhiteSpace(std::istream* pStream);

    // Processing...
    virtual void* OnProcessingInstructionBegin(LPCSTR lpszTarget, void* pUserData);
    virtual void* OnProcessingInstructionEnd(LPCSTR lpszTarget, void* pUserData);
    virtual void* OnElementBegin(LPCSTR lpszElementTag, void* pUserData);
    virtual void* OnElementData(LPCSTR lpszElementData, void* pUserData);
    virtual void* OnElementEnd(LPCSTR lpszElementTag, void* pUserData);
    virtual void* OnProperty(LPCSTR lpszPropertyName, LPCSTR lpszPropertyValue, void* pUserData);
    virtual void* OnComment(LPCSTR lpszComment, void* pUserData);

    // Data...
    unsigned long m_lNumCharactersProcessed;
    unsigned long m_lNumCharactersInFile;
};

#endif //_XMLFILE_H_