#include <wx/xrc/xmlres.h>

Inheritance diagram for wxXmlResourceHandler:

Detailed Description

wxSizerXmlHandler is a class for resource handlers capable of creating a wxSizer object from an XML node.

wxXmlResourceHandler is an abstract base class for resource handlers capable of creating a control from an XML node.

See Also: wxXmlResourceHandler, wxSizer

Library: wxXRC

Category: XML Based Resource System (XRC)

See XML Based Resource System (XRC) for details.

Library: wxXRC

Category: XML Based Resource System (XRC)

Public Member Functions
	wxXmlResourceHandler ()
	Default constructor.

virtual	~wxXmlResourceHandler ()
	Destructor.

wxObject *	CreateResource (wxXmlNode node, wxObject parent, wxObject *instance)
	Creates an object (menu, dialog, control, ...) from an XML node.

virtual wxObject *	DoCreateResource ()=0
	Called from CreateResource after variables were filled.

virtual bool	CanHandle (wxXmlNode *node)=0
	Returns true if it understands this node and can create a resource from it, false otherwise.

void	SetParentResource (wxXmlResource *res)
	Sets the parent resource.

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 wxClassInfo *	GetClassInfo () const
	This virtual function is redefined for every class that requires run-time type information, when using the wxDECLARE_CLASS macro (or similar).

wxObjectRefData *	GetRefData () 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	AddStyle (const wxString &name, int value)
	Add a style flag (e.g.

void	AddWindowStyles ()
	Add styles common to all wxWindow-derived classes.

void	CreateChildren (wxObject *parent, bool this_hnd_only=false)
	Creates children.

void	CreateChildrenPrivately (wxObject parent, wxXmlNode rootnode=NULL)
	Helper function.

wxObject *	CreateResFromNode (wxXmlNode node, wxObject parent, wxObject *instance=NULL)
	Creates a resource from a node.

wxAnimation *	GetAnimation (const wxString &param="animation")
	Creates an animation (see wxAnimation) from the filename specified in param.

wxBitmap	GetBitmap (const wxString &param="bitmap", const wxArtClient &defaultArtClient=wxART_OTHER, wxSize size=wxDefaultSize)
	Gets a bitmap.

wxBitmap	GetBitmap (const wxXmlNode *node, const wxArtClient &defaultArtClient=wxART_OTHER, wxSize size=wxDefaultSize)
	Gets a bitmap from an XmlNode.

bool	GetBool (const wxString &param, bool defaultv=false)
	Gets a bool flag (1, t, yes, on, true are true, everything else is false).

wxColour	GetColour (const wxString &param, const wxColour &defaultColour=wxNullColour)
	Gets colour in HTML syntax (#RRGGBB).

wxFileSystem &	GetCurFileSystem ()
	Returns the current file system.

wxCoord	GetDimension (const wxString &param, wxCoord defaultv=0, wxWindow *windowToUse=0)
	Gets a dimension (may be in dialog units).

wxDirection	GetDirection (const wxString &param, wxDirection dirDefault=wxLEFT)
	Gets a direction.

wxFont	GetFont (const wxString &param="font")
	Gets a font.

int	GetID ()
	Returns the XRCID.

wxIcon	GetIcon (const wxString &param="icon", const wxArtClient &defaultArtClient=wxART_OTHER, wxSize size=wxDefaultSize)
	Returns an icon.

wxIcon	GetIcon (const wxXmlNode *node, const wxArtClient &defaultArtClient=wxART_OTHER, wxSize size=wxDefaultSize)
	Gets an icon from an XmlNode.

wxIconBundle	GetIconBundle (const wxString &param, const wxArtClient &defaultArtClient=wxART_OTHER)
	Returns an icon bundle.

wxImageList *	GetImageList (const wxString &param="imagelist")
	Creates an image list from the param markup data.

long	GetLong (const wxString &param, long defaultv=0)
	Gets the integer value from the parameter.

float	GetFloat (const wxString &param, float defaultv=0)
	Gets a float value from the parameter.

wxString	GetName ()
	Returns the resource name.

bool	IsObjectNode (const wxXmlNode *node) const
	Checks if the given node is an object node.

wxString	GetNodeContent (wxXmlNode *node)
	Gets node content from wxXML_ENTITY_NODE.

wxXmlNode *	GetNodeParent (const wxXmlNode *node) const
	Gets the parent of the node given.

wxXmlNode *	GetNodeNext (const wxXmlNode *node) const
	Gets the next sibling node related to the given node, possibly NULL.

wxXmlNode *	GetNodeChildren (const wxXmlNode *node) const
	Gets the first child of the given node or NULL.

wxXmlNode *	GetParamNode (const wxString &param)
	Finds the node or returns NULL.

wxString	GetParamValue (const wxString &param)
	Finds the parameter value or returns the empty string.

wxString	GetParamValue (const wxXmlNode *node)
	Returns the node parameter value.

wxPoint	GetPosition (const wxString &param="pos")
	Gets the position (may be in dialog units).

wxSize	GetSize (const wxString &param="size", wxWindow *windowToUse=0)
	Gets the size (may be in dialog units).

int	GetStyle (const wxString &param="style", int defaults=0)
	Gets style flags from text in form "flag \| flag2\| flag3 \|..." Only understands flags added with AddStyle().

wxString	GetText (const wxString &param, bool translate=true)
	Gets text from param and does some conversions:

bool	HasParam (const wxString &param)
	Check to see if a parameter exists.

bool	IsOfClass (wxXmlNode *node, const wxString &classname)
	Convenience function.

void	SetupWindow (wxWindow *wnd)
	Sets common window options.

void	ReportError (wxXmlNode *context, const wxString &message)
	Reports error in XRC resources to the user.

void	ReportError (const wxString &message)
	Like ReportError(wxXmlNode*, const wxString&), but uses the node of currently processed object (m_node) as the context.

void	ReportParamError (const wxString &param, const wxString &message)
	Like ReportError(wxXmlNode, const wxString&), but uses the node of parameter param* of the currently processed object as the context.

wxXmlResource *	GetResource () const
	After CreateResource has been called this will return the current wxXmlResource object.

wxXmlNode *	GetNode () const
	After CreateResource has been called this will return the XML node being processed.

wxString	GetClass () const
	After CreateResource has been called this will return the class name of the XML resource node being processed.

wxObject *	GetParent () const
	After CreateResource has been called this will return the current item's parent, if any.

wxObject *	GetInstance () const
	After CreateResource has been called this will return the instance that the XML resource content should be created upon, if it has already been created.

wxWindow *	GetParentAsWindow () const
	After CreateResource has been called this will return the item's parent as a wxWindow.

Protected Member Functions inherited from wxObject
void	AllocExclusive ()
	Ensure that this object's data is not shared with any other object.

virtual wxObjectRefData *	CreateRefData () const
	Creates a new instance of the wxObjectRefData-derived class specific to this object and returns it.

virtual wxObjectRefData *	CloneRefData (const wxObjectRefData *data) const
	Creates a new instance of the wxObjectRefData-derived class specific to this object and initializes it copying data.

Additional Inherited Members
Protected Attributes inherited from wxObject
wxObjectRefData *	m_refData
	Pointer to an object which is the object's reference-counted data.

Constructor & Destructor Documentation

wxXmlResourceHandler::wxXmlResourceHandler ( )

Default constructor.

virtual wxXmlResourceHandler::~wxXmlResourceHandler ( )

virtual

Destructor.

Member Function Documentation

void wxXmlResourceHandler::AddStyle	(	const wxString &	name,
		int	value
	)

protected

Add a style flag (e.g.

wxMB_DOCKABLE) to the list of flags understood by this handler.

void wxXmlResourceHandler::AddWindowStyles ( )

protected

Add styles common to all wxWindow-derived classes.

virtual bool wxXmlResourceHandler::CanHandle ( wxXmlNode * node )

pure virtual

Returns true if it understands this node and can create a resource from it, false otherwise.

Note: You must not call any wxXmlResourceHandler methods except IsOfClass() from this method! The instance is not yet initialized with node data at the time CanHandle() is called and it is only safe to operate on node directly or to call IsOfClass().

Implemented in wxSizerXmlHandler.

void wxXmlResourceHandler::CreateChildren	(	wxObject *	parent,
		bool	this_hnd_only = `false`
	)

protected

Creates children.

void wxXmlResourceHandler::CreateChildrenPrivately	(	wxObject *	parent,
		wxXmlNode *	rootnode = `NULL`
	)

protected

Helper function.

wxObject* wxXmlResourceHandler::CreateResFromNode	(	wxXmlNode *	node,
		wxObject *	parent,
		wxObject *	instance = `NULL`
	)

protected

Creates a resource from a node.

wxObject* wxXmlResourceHandler::CreateResource	(	wxXmlNode *	node,
		wxObject *	parent,
		wxObject *	instance
	)

Creates an object (menu, dialog, control, ...) from an XML node.

Should check for validity. parent is a higher-level object (usually window, dialog or panel) that is often necessary to create the resource.

If instance is non-NULL it should not create a new instance via 'new' but should rather use this one, and call its Create method.

virtual wxObject* wxXmlResourceHandler::DoCreateResource ( )

pure virtual

Called from CreateResource after variables were filled.

Implemented in wxSizerXmlHandler.

wxAnimation* wxXmlResourceHandler::GetAnimation ( const wxString & param = "animation" )

protected

Creates an animation (see wxAnimation) from the filename specified in param.

wxBitmap wxXmlResourceHandler::GetBitmap	(	const wxString &	param = `"bitmap"`,
		const wxArtClient &	defaultArtClient = `wxART_OTHER`,
		wxSize	size = `wxDefaultSize`
	)

protected

Gets a bitmap.

wxBitmap wxXmlResourceHandler::GetBitmap	(	const wxXmlNode *	node,
		const wxArtClient &	defaultArtClient = `wxART_OTHER`,
		wxSize	size = `wxDefaultSize`
	)

protected

Gets a bitmap from an XmlNode.

Since: 2.9.1

bool wxXmlResourceHandler::GetBool	(	const wxString &	param,
		bool	defaultv = `false`
	)

protected

Gets a bool flag (1, t, yes, on, true are true, everything else is false).

wxString wxXmlResourceHandler::GetClass ( ) const

protected

After CreateResource has been called this will return the class name of the XML resource node being processed.

Since: 2.9.5

wxColour wxXmlResourceHandler::GetColour	(	const wxString &	param,
		const wxColour &	defaultColour = `wxNullColour`
	)

protected

Gets colour in HTML syntax (#RRGGBB).

wxFileSystem& wxXmlResourceHandler::GetCurFileSystem ( )

protected

Returns the current file system.

wxCoord wxXmlResourceHandler::GetDimension	(	const wxString &	param,
		wxCoord	defaultv = `0`,
		wxWindow *	windowToUse = `0`
	)

protected

Gets a dimension (may be in dialog units).

wxDirection wxXmlResourceHandler::GetDirection	(	const wxString &	param,
		wxDirection	dirDefault = `wxLEFT`
	)

protected

Gets a direction.

If the given param is not present or has empty value, dirDefault is returned by default. Otherwise the value of the parameter is parsed and a warning is generated if it's not one of wxLEFT, wxTOP, wxRIGHT or wxBOTTOM.

Since: 2.9.3

float wxXmlResourceHandler::GetFloat	(	const wxString &	param,
		float	defaultv = `0`
	)

protected

Gets a float value from the parameter.

wxFont wxXmlResourceHandler::GetFont ( const wxString & param = "font" )

protected

Gets a font.

wxIcon wxXmlResourceHandler::GetIcon	(	const wxString &	param = `"icon"`,
		const wxArtClient &	defaultArtClient = `wxART_OTHER`,
		wxSize	size = `wxDefaultSize`
	)

protected

Returns an icon.

wxIcon wxXmlResourceHandler::GetIcon	(	const wxXmlNode *	node,
		const wxArtClient &	defaultArtClient = `wxART_OTHER`,
		wxSize	size = `wxDefaultSize`
	)

protected

Gets an icon from an XmlNode.

Since: 2.9.1

wxIconBundle wxXmlResourceHandler::GetIconBundle	(	const wxString &	param,
		const wxArtClient &	defaultArtClient = `wxART_OTHER`
	)

protected

Returns an icon bundle.

Note: Bundles can be loaded either with stock IDs or from files that contain more than one image (e.g. Windows icon files). If a file contains only single image, a bundle with only one icon will be created.

Since: 2.9.0

int wxXmlResourceHandler::GetID ( )

protected

Returns the XRCID.

wxImageList* wxXmlResourceHandler::GetImageList ( const wxString & param = "imagelist" )

protected

Creates an image list from the param markup data.

Returns: The new instance of wxImageList or NULL if no data is found.

Since: 2.9.1

wxObject* wxXmlResourceHandler::GetInstance ( ) const

protected

After CreateResource has been called this will return the instance that the XML resource content should be created upon, if it has already been created.

If NULL then the handler should create the object itself.

Since: 2.9.5

long wxXmlResourceHandler::GetLong	(	const wxString &	param,
		long	defaultv = `0`
	)

protected

Gets the integer value from the parameter.

wxString wxXmlResourceHandler::GetName ( )

protected

Returns the resource name.

wxXmlNode* wxXmlResourceHandler::GetNode ( ) const

protected

After CreateResource has been called this will return the XML node being processed.

Since: 2.9.5

wxXmlNode* wxXmlResourceHandler::GetNodeChildren ( const wxXmlNode * node ) const

protected

Gets the first child of the given node or NULL.

This method is safe to call with NULL argument, it just returns NULL in this case.

Since: 3.1.0

wxString wxXmlResourceHandler::GetNodeContent ( wxXmlNode * node )

protected

Gets node content from wxXML_ENTITY_NODE.

wxXmlNode* wxXmlResourceHandler::GetNodeNext ( const wxXmlNode * node ) const

protected

Gets the next sibling node related to the given node, possibly NULL.

This method is safe to call with NULL argument, it just returns NULL in this case.

Since: 3.1.0

wxXmlNode* wxXmlResourceHandler::GetNodeParent ( const wxXmlNode * node ) const

protected

Gets the parent of the node given.

This method is safe to call with NULL argument, it just returns NULL in this case.

Since: 3.1.0

wxXmlNode* wxXmlResourceHandler::GetParamNode ( const wxString & param )

protected

Finds the node or returns NULL.

wxString wxXmlResourceHandler::GetParamValue ( const wxString & param )

protected

Finds the parameter value or returns the empty string.

wxString wxXmlResourceHandler::GetParamValue ( const wxXmlNode * node )

protected

Returns the node parameter value.

Since: 2.9.1

wxObject* wxXmlResourceHandler::GetParent ( ) const

protected

After CreateResource has been called this will return the current item's parent, if any.

Since: 2.9.5

wxWindow* wxXmlResourceHandler::GetParentAsWindow ( ) const

protected

After CreateResource has been called this will return the item's parent as a wxWindow.

Since: 2.9.5

wxPoint wxXmlResourceHandler::GetPosition ( const wxString & param = "pos" )

protected

Gets the position (may be in dialog units).

wxXmlResource* wxXmlResourceHandler::GetResource ( ) const

protected

After CreateResource has been called this will return the current wxXmlResource object.

Since: 2.9.5

wxSize wxXmlResourceHandler::GetSize	(	const wxString &	param = `"size"`,
		wxWindow *	windowToUse = `0`
	)

protected

Gets the size (may be in dialog units).

int wxXmlResourceHandler::GetStyle	(	const wxString &	param = `"style"`,
		int	defaults = `0`
	)

protected

Gets style flags from text in form "flag | flag2| flag3 |..." Only understands flags added with AddStyle().

wxString wxXmlResourceHandler::GetText	(	const wxString &	param,
		bool	translate = `true`
	)

protected

Gets text from param and does some conversions:

replaces \n, \r, \t by respective characters (according to C syntax)
replaces $ by and $$ by $ (needed for _File to File translation because of XML syntax)
calls wxGetTranslations (unless disabled in wxXmlResource)

bool wxXmlResourceHandler::HasParam ( const wxString & param )

protected

Check to see if a parameter exists.

bool wxXmlResourceHandler::IsObjectNode ( const wxXmlNode * node ) const

protected

Checks if the given node is an object node.

Object nodes are those named "object" or "object_ref".

Since: 3.1.0

bool wxXmlResourceHandler::IsOfClass	(	wxXmlNode *	node,
		const wxString &	classname
	)

protected

Convenience function.

Returns true if the node has a property class equal to classname, e.g. object class="wxDialog".

void wxXmlResourceHandler::ReportError	(	wxXmlNode *	context,
		const wxString &	message
	)

protected

Reports error in XRC resources to the user.

See wxXmlResource::ReportError() for more information.

Since: 2.9.0

void wxXmlResourceHandler::ReportError ( const wxString & message )

protected

Like ReportError(wxXmlNode*, const wxString&), but uses the node of currently processed object (m_node) as the context.

Since: 2.9.0

void wxXmlResourceHandler::ReportParamError	(	const wxString &	param,
		const wxString &	message
	)

protected

Like ReportError(wxXmlNode*, const wxString&), but uses the node of parameter param of the currently processed object as the context.

This is convenience function for reporting errors in particular parameters.

Since: 2.9.0

void wxXmlResourceHandler::SetParentResource ( wxXmlResource * res )

Sets the parent resource.

void wxXmlResourceHandler::SetupWindow ( wxWindow * wnd )

protected

Sets common window options.

Detailed Description

Public Member Functions

Protected Member Functions

Additional Inherited Members

Constructor & Destructor Documentation

Member Function Documentation