The WindowManager class describes an object that manages creation and lifetime of Window objects. More...

Inheritance diagram for CEGUI::WindowManager:

Collaboration diagram for CEGUI::WindowManager:

Public Types
typedef bool	PropertyCallback (Window window, String &propname, String &propvalue, void userdata)
	Function type that is used as a callback when loading layouts from XML; the function is called for each Property element encountered. More...

typedef ConstVectorIterator < WindowVector >	WindowIterator

Public Types inherited from CEGUI::EventSet
typedef ConstMapIterator < EventMap >	EventIterator

Public Member Functions
	WindowManager (void)
	Constructs a new WindowManager object. More...

	~WindowManager (void)
	Destructor for WindowManager objects. More...

Window *	createWindow (const String &type, const String &name="")
	Creates a new Window object of the specified type, and gives it the specified unique name. More...

void	destroyWindow (Window *window)
	Destroy the specified Window object. More...

void	destroyAllWindows (void)
	Destroys all Window objects within the system. More...

bool	isAlive (const Window *window) const
	return whether Window is alive.

Window *	loadLayoutFromContainer (const RawDataContainer &source, PropertyCallback callback=0, void userdata=0)
	Creates a set of windows (a GUI layout) from the information in the specified XML. More...

Window *	loadLayoutFromFile (const String &filename, const String &resourceGroup="", PropertyCallback callback=0, void userdata=0)
	Creates a set of windows (a GUI layout) from the information in the specified XML file. More...

Window *	loadLayoutFromString (const String &source, PropertyCallback callback=0, void userdata=0)
	Creates a set of windows (a GUI layout) from the information in the specified XML. More...

bool	isDeadPoolEmpty (void) const
	Return whether the window dead pool is empty. More...

void	cleanDeadPool (void)
	Permanently destroys any windows placed in the dead pool. More...

void	writeLayoutToStream (const Window &window, OutStream &out_stream) const
	Writes a full XML window layout, starting at the given Window to the given OutStream. More...

String	getLayoutAsString (const Window &window) const
	Writes a full XML window layout, starting at the given Window and returns the result as string. More...

void	saveLayoutToFile (const Window &window, const String &filename) const
	Save a full XML window layout, starting at the given Window, to a file with the given file name. More...

void	lock ()
	Put WindowManager into the locked state. More...

void	unlock ()
	Put WindowManager into the unlocked state. More...

bool	isLocked () const
	Returns whether WindowManager is currently in the locked state. More...

WindowIterator	getIterator (void) const
	Return a WindowManager::WindowIterator object to iterate over the currently defined Windows.

void	DEBUG_dumpWindowNames (String zone) const
	Outputs the names of ALL existing windows to log (DEBUG function). More...

Public Member Functions inherited from CEGUI::EventSet
	EventSet ()
	Constructor for EventSet objects.

virtual	~EventSet (void)
	Destructor for EventSet objects.

void	addEvent (const String &name)
	Creates a new Event object with the given name and adds it to the EventSet. More...

void	addEvent (Event &event)
	Adds the given Event object to the EventSet. Ownership of the object passes to EventSet and it will be deleted when it is removed from the EventSet - whether explicitly via removeEvent or when the EventSet is destroyed. More...

void	removeEvent (const String &name)
	Removes the Event with the given name. All connections to the event are disconnected, and the underlying Event object is destroyed. More...

void	removeEvent (Event &event)
	Removes the given event from the EventSet. All connections to the event are disconnected, and the event object is destroyed. More...

void	removeAllEvents (void)
	Remove all Event objects from the EventSet. Add connections will be disconnected, and all Event objects destroyed.

bool	isEventPresent (const String &name)
	Checks to see if an Event with the given name is present in this EventSet. More...

virtual Event::Connection	subscribeEvent (const String &name, Event::Subscriber subscriber)
	Subscribes a handler to the named Event. If the named Event is not yet present in the EventSet, it is created and added. More...

virtual Event::Connection	subscribeEvent (const String &name, Event::Group group, Event::Subscriber subscriber)
	Subscribes a handler to the specified group of the named Event. If the named Event is not yet present in the EventSet, it is created and added. More...

template<typename Arg1 , typename Arg2 >
Event::Connection	subscribeEvent (const String &name, Arg1 arg1, Arg2 arg2)
	Subscribes a handler to the named Event. If the named Event is not yet present in the EventSet, it is created and added. More...

template<typename Arg1 , typename Arg2 >
Event::Connection	subscribeEvent (const String &name, Event::Group group, Arg1 arg1, Arg2 arg2)
	Subscribes a handler to the named Event. If the named Event is not yet present in the EventSet, it is created and added. More...

virtual Event::Connection	subscribeScriptedEvent (const String &name, const String &subscriber_name)
	Subscribes the named Event to a scripted funtion. More...

virtual Event::Connection	subscribeScriptedEvent (const String &name, Event::Group group, const String &subscriber_name)
	Subscribes the specified group of the named Event to a scripted funtion. More...

virtual void	fireEvent (const String &name, EventArgs &args, const String &eventNamespace="")
	Fires the named event passing the given EventArgs object. More...

bool	isMuted (void) const
	Return whether the EventSet is muted or not. More...

void	setMutedState (bool setting)
	Set the mute state for this EventSet. More...

Event *	getEventObject (const String &name, bool autoAdd=false)
	Return a pointer to the Event object with the given name, optionally adding such an Event object to the EventSet if it does not already exist. More...

EventIterator	getEventIterator (void) const
	Return a EventSet::EventIterator object to iterate over the events currently added to the EventSet.

Static Public Member Functions
static const String &	getDefaultResourceGroup ()
	Returns the default resource group currently set for layouts. More...

static void	setDefaultResourceGroup (const String &resourceGroup)
	Sets the default resource group to be used when loading layouts. More...

Static Public Member Functions inherited from CEGUI::Singleton< WindowManager >
static WindowManager &	getSingleton (void)

static WindowManager *	getSingletonPtr (void)

Static Public Attributes
static const String	GeneratedWindowNameBase

static const String	EventNamespace
	Namespace for global events.

static const String	EventWindowCreated

static const String	EventWindowDestroyed

static const String	GUILayoutSchemaName
	Filename of the XML schema used for validating GUILayout files.

Additional Inherited Members
Protected Types inherited from CEGUI::EventSet
typedef std::map< String, Event , StringFastLessCompare CEGUI_MAP_ALLOC(String, Event )>	EventMap

Protected Member Functions inherited from CEGUI::EventSet
void	fireEvent_impl (const String &name, EventArgs &args)
	Implementation event firing member.

ScriptModule *	getScriptModule () const
	Helper to return the script module pointer or throw.

	EventSet (EventSet &)

EventSet &	operator= (EventSet &)

Protected Attributes inherited from CEGUI::EventSet
EventMap	d_events

bool	d_muted
	true if events for this EventSet have been muted.

Static Protected Attributes inherited from CEGUI::Singleton< WindowManager >
static WindowManager *	ms_Singleton

Detailed Description

The WindowManager class describes an object that manages creation and lifetime of Window objects.

The WindowManager is the means by which Window objects are created and destroyed. For each sub-class of Window that is to be created, there must exist a WindowFactory object which is registered with the WindowFactoryManager. Additionally, the WindowManager tracks every Window object created, and can be used to access those Window objects by name.

Member Typedef Documentation

typedef bool CEGUI::WindowManager::PropertyCallback(Window *window, String &propname, String &propvalue, void *userdata)

Function type that is used as a callback when loading layouts from XML; the function is called for each Property element encountered.

Parameters

window	Window object that the property is to be applied to.
propname	String holding the name of the property that is being set.
propvalue	String holding the new value that will be applied to the property specified by /a propname.
userdata	Some client code supplied data.

Returns

true if the property should be set.
false if the property should not be set,

Constructor & Destructor Documentation

CEGUI::WindowManager::WindowManager ( void )

Constructs a new WindowManager object.

NB: Client code should not create WindowManager objects - they are of limited use to you! The intended pattern of access is to get a pointer to the GUI system's WindowManager via the System object, and use that.

CEGUI::WindowManager::~WindowManager ( void )

Destructor for WindowManager objects.

This will properly destry all remaining Window objects. Note that WindowFactory objects will not be destroyed (since they are owned by whoever created them).

Member Function Documentation

void CEGUI::WindowManager::cleanDeadPool ( void )

Permanently destroys any windows placed in the dead pool.

Note: It is probably not a good idea to call this from a Window based event handler if the specific window has been or is being destroyed.

Returns: Nothing.

Window* CEGUI::WindowManager::createWindow	(	const String &	type,
		const String &	name = `""`
	)

Creates a new Window object of the specified type, and gives it the specified unique name.

Parameters

type	String that describes the type of Window to be created. A valid WindowFactory for the specified type must be registered.
name	String that holds the name that is to be given to the new window. If name is empty, a name will be generated for the window.

Returns: Pointer to the newly created Window object.

Exceptions

InvalidRequestException	WindowManager is locked and no Windows may be created.
UnknownObjectException	No WindowFactory is registered for type Window objects.
GenericException	Some other error occurred (Exception message has details).

void CEGUI::WindowManager::DEBUG_dumpWindowNames ( String zone ) const

Outputs the names of ALL existing windows to log (DEBUG function).

Parameters

zone	Helper string that can specify where the name dump was made (e.g. "BEFORE FRAME DELETION").

Returns: Nothing.

void CEGUI::WindowManager::destroyAllWindows ( void )

Destroys all Window objects within the system.

Returns: Nothing.

Exceptions

InvalidRequestException Thrown if the WindowFactory for any Window object type has been removed.

void CEGUI::WindowManager::destroyWindow ( Window * window )

Destroy the specified Window object.

Parameters

window Pointer to the Window object to be destroyed.

Returns: Nothing

Exceptions

InvalidRequestException Can be thrown if the WindowFactory for window's object type was removed.

static const String& CEGUI::WindowManager::getDefaultResourceGroup ( void )

inlinestatic

Returns the default resource group currently set for layouts.

Returns: String describing the default resource group identifier that will be used when loading layouts.

String CEGUI::WindowManager::getLayoutAsString ( const Window & window ) const

Writes a full XML window layout, starting at the given Window and returns the result as string.

Parameters

window Window object to become the root of the layout.

Warning: This is a convenience function and isn't designed to be fast at all! Use the other alternatives if you want performance.

Returns: String containing XML of the resulting layout

bool CEGUI::WindowManager::isDeadPoolEmpty ( void ) const

Return whether the window dead pool is empty.

Returns

true if there are no windows in the dead pool.
false if the dead pool contains >=1 window awaiting destruction.

bool CEGUI::WindowManager::isLocked ( ) const

Returns whether WindowManager is currently in the locked state.

While WindowManager is in the locked state all attempts to create a
Window of any type will fail with an InvalidRequestException being
thrown.  Calls to lock/unlock are recursive; if multiple calls to lock
are made, WindowManager is only unlocked after a matching number of
calls to unlock.

Returns

true to indicate WindowManager is locked and that any attempt to create Window objects will fail.
false to indicate WindowManager is unlocked and that Window objects may be created as normal.

Window* CEGUI::WindowManager::loadLayoutFromContainer	(	const RawDataContainer &	source,
		PropertyCallback *	callback = `0`,
		void *	userdata = `0`
	)

Creates a set of windows (a GUI layout) from the information in the specified XML.

Parameters

source	RawDataContainer holding the XML source
callback	PropertyCallback function to be called for each Property element loaded from the layout. This is called prior to the property value being applied to the window enabling client code manipulation of properties.
userdata	Client code data pointer passed to the PropertyCallback function.

Returns: Pointer to the root Window object defined in the layout.

Window* CEGUI::WindowManager::loadLayoutFromFile	(	const String &	filename,
		const String &	resourceGroup = `""`,
		PropertyCallback *	callback = `0`,
		void *	userdata = `0`
	)

Creates a set of windows (a GUI layout) from the information in the specified XML file.

Parameters

filename	String object holding the filename of the XML file to be processed.
resourceGroup	Resource group identifier to be passed to the resource provider when loading the layout file.
callback	PropertyCallback function to be called for each Property element loaded from the layout. This is called prior to the property value being applied to the window enabling client code manipulation of properties.
userdata	Client code data pointer passed to the PropertyCallback function.

Returns: Pointer to the root Window object defined in the layout.

Exceptions

FileIOException	thrown if something goes wrong while processing the file filename.
InvalidRequestException	thrown if filename appears to be invalid.

Window* CEGUI::WindowManager::loadLayoutFromString	(	const String &	source,
		PropertyCallback *	callback = `0`,
		void *	userdata = `0`
	)

Creates a set of windows (a GUI layout) from the information in the specified XML.

Parameters

source	String holding the XML source
callback	PropertyCallback function to be called for each Property element loaded from the layout. This is called prior to the property value being applied to the window enabling client code manipulation of properties.
userdata	Client code data pointer passed to the PropertyCallback function.

Returns: Pointer to the root Window object defined in the layout.

void CEGUI::WindowManager::lock ( )

Put WindowManager into the locked state.

While WindowManager is in the locked state all attempts to create a
Window of any type will fail with an InvalidRequestException being
thrown.  Calls to lock/unlock are recursive; if multiple calls to lock
are made, WindowManager is only unlocked after a matching number of
calls to unlock.

Note: This is primarily intended for internal use within the system.

void CEGUI::WindowManager::saveLayoutToFile	(	const Window &	window,
		const String &	filename
	)		const

Save a full XML window layout, starting at the given Window, to a file with the given file name.

Parameters

window	Window object to become the root of the layout.
filename	The name of the file to which the XML will be written. Note that this does not use any part of the ResourceProvider system, but rather will write directly to disk. If this is not desirable, you should prefer the OutStream based writeWindowLayoutToStream functions.

static void CEGUI::WindowManager::setDefaultResourceGroup ( const String & resourceGroup )

inlinestatic

Sets the default resource group to be used when loading layouts.

Parameters

resourceGroup String describing the default resource group identifier to be used.

Returns: Nothing.

void CEGUI::WindowManager::unlock ( )

Put WindowManager into the unlocked state.

While WindowManager is in the locked state all attempts to create a
Window of any type will fail with an InvalidRequestException being
thrown.  Calls to lock/unlock are recursive; if multiple calls to lock
are made, WindowManager is only unlocked after a matching number of
calls to unlock.

Note: This is primarily intended for internal use within the system.

void CEGUI::WindowManager::writeLayoutToStream	(	const Window &	window,
		OutStream &	out_stream
	)		const

Writes a full XML window layout, starting at the given Window to the given OutStream.

Parameters

window	Window object to become the root of the layout.
out_stream	OutStream (std::ostream based) object where data is to be sent.

Returns: Nothing.

Member Data Documentation

const String CEGUI::WindowManager::EventWindowCreated

static

Event fired when a new Window object is created. Handlers are passed a const WindowEventArgs reference with WindowEventArgs::window set to the Window that has just been created.

const String CEGUI::WindowManager::EventWindowDestroyed

static

Event fired when a Window object is destroyed. Handlers are passed a const WindowEventArgs reference with WindowEventArgs::window set to the Window that has been destroyed.

const String CEGUI::WindowManager::GeneratedWindowNameBase

static

Base name to use for generated window names.

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Additional Inherited Members

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation