CEGUI::System Class Reference

The System class is the CEGUI class that provides access to all other elements in this system. More...

Inheritance diagram for CEGUI::System:

Inheritance graph
[legend]
Collaboration diagram for CEGUI::System:

Collaboration graph
[legend]

List of all members.

Public Member Functions

 System (Renderer *renderer, ResourceProvider *resourceProvider=0, XMLParser *xmlParser=0, ScriptModule *scriptModule=0, const String &configFile="", const String &logFile="CEGUI.log")
 Construct a new System object.
 ~System (void)
 Destructor for System objects.
RenderergetRenderer (void) const
 Return a pointer to the Renderer object being used by the system.
void setDefaultFont (const String &name)
 Set the default font to be used by the system.
void setDefaultFont (Font *font)
 Set the default font to be used by the system.
FontgetDefaultFont (void) const
 Return a pointer to the default Font for the GUI system.
void signalRedraw ()
 Causes a full re-draw next time renderGUI() is called.
bool isRedrawRequested () const
 Return a boolean value to indicate whether a full re-draw is requested next time renderGUI() is called.
void renderGUI (void)
 Render the GUI.
WindowsetGUISheet (Window *sheet)
 Set the active GUI sheet (root) window.
WindowgetGUISheet (void) const
 Return a pointer to the active GUI sheet (root) window.
double getSingleClickTimeout (void) const
 Return the current timeout for generation of single-click events.
double getMultiClickTimeout (void) const
 Return the current timeout for generation of multi-click events.
const SizegetMultiClickToleranceAreaSize (void) const
 Return the size of the allowable mouse movement tolerance used when generating multi-click events.
void setSingleClickTimeout (double timeout)
 Set the timeout used for generation of single-click events.
void setMultiClickTimeout (double timeout)
 Set the timeout to be used for the generation of multi-click events.
void setMultiClickToleranceAreaSize (const Size &sz)
 Set the size of the allowable mouse movement tolerance used when generating multi-click events.
const ImagegetDefaultMouseCursor (void) const
 Return the currently set default mouse cursor image.
void setDefaultMouseCursor (const Image *image)
 Set the image to be used as the default mouse cursor.
void setDefaultMouseCursor (MouseCursorImage image)
 Set the image to be used as the default mouse cursor.
void setDefaultMouseCursor (const String &imageset, const String &image_name)
 Set the image to be used as the default mouse cursor.
WindowgetWindowContainingMouse (void) const
 Return the Window object that the mouse is presently within.
ScriptModulegetScriptingModule (void) const
 Return a pointer to the ScriptModule being used for scripting within the GUI system.
void setScriptingModule (ScriptModule *scriptModule)
 Set the ScriptModule to be used for scripting within the GUI system.
ResourceProvidergetResourceProvider (void) const
 Return a pointer to the ResourceProvider being used within the GUI system.
void executeScriptFile (const String &filename, const String &resourceGroup="") const
 Execute a script file if possible.
int executeScriptGlobal (const String &function_name) const
 Execute a scripted global function if possible. The function should not take any parameters and should return an integer.
void executeScriptString (const String &str) const
 If possible, execute script code contained in the given CEGUI::String object.
float getMouseMoveScaling (void) const
 return the current mouse movement scaling factor.
void setMouseMoveScaling (float scaling)
 Set the current mouse movement scaling factor.
void notifyWindowDestroyed (const Window *window)
 Internal method used to inform the System object whenever a window is destroyed, so that System can perform any required housekeeping.
uint getSystemKeys (void) const
 Return the current system keys value.
void setXMLParser (const String &parserName)
 Set a new XML parser module to be used.
void setXMLParser (XMLParser *parser)
 Sets the XMLParser object to be used by the system.
XMLParsergetXMLParser (void) const
 Return the XMLParser object.
void setDefaultTooltip (Tooltip *tooltip)
 Set the system default Tooltip object. This value may be NULL to indicate that no default Tooltip will be available.
void setDefaultTooltip (const String &tooltipType)
 Set the system default Tooltip to be used by specifying a Window type.
TooltipgetDefaultTooltip (void) const
 return a poiter to the system default tooltip. May return 0.
void setModalTarget (Window *target)
 Internal method to directly set the current modal target.
WindowgetModalTarget (void) const
 Return a pointer to the Window that is currently the modal target.
bool updateWindowContainingMouse ()
 Perform updates with regards to the window that contains the mouse cursor, firing any required MouseEnters / MouseLeaves events.
bool injectMouseMove (float delta_x, float delta_y)
 Method that injects a mouse movement event into the system.
bool injectMouseLeaves (void)
 Method that injects that the mouse has left the application window.
bool injectMouseButtonDown (MouseButton button)
 Method that injects a mouse button down event into the system.
bool injectMouseButtonUp (MouseButton button)
 Method that injects a mouse button up event into the system.
bool injectKeyDown (uint key_code)
 Method that injects a key down event into the system.
bool injectKeyUp (uint key_code)
 Method that injects a key up event into the system.
bool injectChar (utf32 code_point)
 Method that injects a typed character event into the system.
bool injectMouseWheelChange (float delta)
 Method that injects a mouse-wheel / scroll-wheel event into the system.
bool injectMousePosition (float x_pos, float y_pos)
 Method that injects a new position for the mouse cursor.
bool injectTimePulse (float timeElapsed)
 Method to inject time pulses into the system.

Static Public Member Functions

static SystemgetSingleton (void)
 Return singleton System object.
static SystemgetSingletonPtr (void)
 Return pointer to singleton System object.
static void setDefaultXMLParserName (const String &parserName)
 Static member to set the name of the default XML parser module that should be used.
static const String getDefaultXMLParserName ()
 Return the name of the currently set default xml parser module.

Static Public Attributes

static const String EventNamespace
 Namespace for global events.
static const double DefaultSingleClickTimeout = 0.2
 Default timeout for generation of single click events.
static const double DefaultMultiClickTimeout = 0.33
 Default timeout for generation of multi-click events.
static const Size DefaultMultiClickAreaSize
 Default allowable mouse movement for multi-click event generation.
static const String EventGUISheetChanged
 Name of event fired whenever the GUI sheet is changed.
static const String EventSingleClickTimeoutChanged
 Name of event fired when the single-click timeout is changed.
static const String EventMultiClickTimeoutChanged
 Name of event fired when the multi-click timeout is changed.
static const String EventMultiClickAreaSizeChanged
 Name of event fired when the size of the multi-click tolerance area is changed.
static const String EventDefaultFontChanged
 Name of event fired when the default font changes.
static const String EventDefaultMouseCursorChanged
 Name of event fired when the default mouse cursor changes.
static const String EventMouseMoveScalingChanged
 Name of event fired when the mouse move scaling factor changes.


Detailed Description

The System class is the CEGUI class that provides access to all other elements in this system.

This object must be created by the client application. The System object requires that you pass it an initialised Renderer object which it can use to interface to whatever rendering system will be used to display the GUI imagery.


Constructor & Destructor Documentation

CEGUI::System::System ( Renderer renderer,
ResourceProvider resourceProvider = 0,
XMLParser xmlParser = 0,
ScriptModule scriptModule = 0,
const String configFile = "",
const String logFile = "CEGUI.log" 
)

Construct a new System object.

Parameters:
renderer Pointer to the valid Renderer object that will be used to render GUI imagery.
resourceProvider Pointer to a ResourceProvider object, or NULL to use whichever default the Renderer provides.
xmlParser Pointer to a valid XMLParser object to be used when parsing XML files, or NULL to use a default parser.
scriptModule Pointer to a ScriptModule object. may be NULL for none.
configFile String object containing the name of a configuration file to use.
logFile String object containing the name to use for the log file.

References CEGUI::XMLParser::cleanup(), CEGUI::ScriptModule::createBindings(), CEGUI::String::empty(), CEGUI::Renderer::EventDisplaySizeChanged, executeScriptFile(), CEGUI::Config_xmlHandler::getDefaultFontName(), CEGUI::ResourceProvider::getDefaultResourceGroup(), CEGUI::Config_xmlHandler::getDefaultResourceGroup(), CEGUI::Config_xmlHandler::getInitScriptFilename(), CEGUI::Config_xmlHandler::getLayoutFilename(), CEGUI::Config_xmlHandler::getLogFilename(), CEGUI::Config_xmlHandler::getLoggingLevel(), CEGUI::Config_xmlHandler::getSchemeFilename(), getSingleton(), CEGUI::Config_xmlHandler::getTermScriptFilename(), CEGUI::XMLParser::parseXMLFile(), setDefaultFont(), CEGUI::ResourceProvider::setDefaultResourceGroup(), setGUISheet(), CEGUI::EventSet::subscribeEvent(), and CEGUI::GUISheet::WidgetTypeName.


Member Function Documentation

void CEGUI::System::executeScriptFile ( const String filename,
const String resourceGroup = "" 
) const

Execute a script file if possible.

Parameters:
filename String object holding the filename of the script file that is to be executed
resourceGroup Resource group identifier to be passed to the ResourceProvider when loading the script file.

References CEGUI::Errors, CEGUI::ScriptModule::executeScriptFile(), and getSingleton().

Referenced by System(), and ~System().

int CEGUI::System::executeScriptGlobal ( const String function_name  )  const

Execute a scripted global function if possible. The function should not take any parameters and should return an integer.

Parameters:
function_name String object holding the name of the function, in the global script environment, that is to be executed.
Returns:
The integer value returned from the script function.

References CEGUI::Errors, CEGUI::ScriptModule::executeScriptGlobal(), and getSingleton().

void CEGUI::System::executeScriptString ( const String str  )  const

If possible, execute script code contained in the given CEGUI::String object.

Parameters:
str String object holding the valid script code that should be executed.
Returns:
Nothing.

References CEGUI::Errors, CEGUI::ScriptModule::executeString(), and getSingleton().

Font* CEGUI::System::getDefaultFont ( void   )  const [inline]

Return a pointer to the default Font for the GUI system.

Returns:
Pointer to a Font object that is the default font in the system.

Referenced by CEGUI::Window::getFont(), CEGUI::TreeItem::getFont(), and CEGUI::ListboxTextItem::getFont().

const Image* CEGUI::System::getDefaultMouseCursor ( void   )  const [inline]

Return the currently set default mouse cursor image.

Returns:
Pointer to the current default image used for the mouse cursor. May return NULL if default cursor has not been set, or has intentionally been set to NULL - which results in a blank default cursor.

Referenced by CEGUI::DragContainer::getDragCursorImage(), and CEGUI::Window::getMouseCursor().

Tooltip* CEGUI::System::getDefaultTooltip ( void   )  const [inline]

return a poiter to the system default tooltip. May return 0.

Returns:
Pointer to the current system default tooltip. May return 0 if no system default tooltip is available.

Referenced by CEGUI::Window::getTooltip().

const String CEGUI::System::getDefaultXMLParserName (  )  [static]

Return the name of the currently set default xml parser module.

Returns:
String holding the currently set default xml parser name. Note that if this name has been changed after instantiating the system, the name returned may not actually correspond to the module in use.

Window* CEGUI::System::getGUISheet ( void   )  const [inline]

Return a pointer to the active GUI sheet (root) window.

Returns:
Pointer to the window object that has been set as the GUI root element.

Referenced by CEGUI::TabButton::onMouseButtonUp(), CEGUI::RadioButton::onMouseButtonUp(), CEGUI::PushButton::onMouseButtonUp(), CEGUI::Checkbox::onMouseButtonUp(), and CEGUI::Tooltip::setTargetWindow().

Window* CEGUI::System::getModalTarget ( void   )  const [inline]

Return a pointer to the Window that is currently the modal target.

Returns:
Pointer to the current modal target. NULL if there is no modal target.

float CEGUI::System::getMouseMoveScaling ( void   )  const

return the current mouse movement scaling factor.

Returns:
float value that is equal to the currently set mouse movement scaling factor. Defaults to 1.0f.

double CEGUI::System::getMultiClickTimeout ( void   )  const [inline]

Return the current timeout for generation of multi-click events.

A multi-click event is a double-click, or a triple-click. The value returned here is the maximum allowable time between mouse button down events for which a multi-click event will be generated.

Returns:
double value equal to the current multi-click timeout value.

const Size& CEGUI::System::getMultiClickToleranceAreaSize ( void   )  const [inline]

Return the size of the allowable mouse movement tolerance used when generating multi-click events.

This size defines an area with the mouse at the centre. The mouse must stay within the tolerance defined for a multi-click (double click, or triple click) event to be generated.

Returns:
Size object describing the current multi-click tolerance area size.

Renderer* CEGUI::System::getRenderer ( void   )  const [inline]

ResourceProvider * CEGUI::System::getResourceProvider ( void   )  const

ScriptModule * CEGUI::System::getScriptingModule ( void   )  const

Return a pointer to the ScriptModule being used for scripting within the GUI system.

Returns:
Pointer to a ScriptModule based object.

Referenced by CEGUI::EventSet::subscribeScriptedEvent().

double CEGUI::System::getSingleClickTimeout ( void   )  const [inline]

Return the current timeout for generation of single-click events.

A single-click is defined here as a button being pressed and then released.

Returns:
double value equal to the current single-click timeout value.

System & CEGUI::System::getSingleton ( void   )  [static]

Return singleton System object.

Returns:
Singleton System object

Referenced by CEGUI::FalagardMultiLineEditbox::cacheCaratImagery(), CEGUI::FalagardMultiLineEditbox::cacheTextLines(), CEGUI::FontManager::createFont(), CEGUI::WindowManager::destroyWindow(), CEGUI::ListHeaderSegment::doDragSizing(), CEGUI::MouseCursor::draw(), executeScriptFile(), executeScriptGlobal(), executeScriptString(), CEGUI::Font::Font(), CEGUI::FreeTypeFont::free(), CEGUI::Window::generateAutoRepeatEvent(), CEGUI::MouseCursor::getConstraintArea(), CEGUI::MouseCursor::getDisplayIndependantPosition(), CEGUI::DragContainer::getDragCursorImage(), CEGUI::Window::getFont(), CEGUI::TreeItem::getFont(), CEGUI::ListboxTextItem::getFont(), CEGUI::Window::getInnerRect(), CEGUI::Window::getModalState(), CEGUI::Window::getMouseCursor(), CEGUI::Window::getParentPixelHeight(), CEGUI::Window::getParentPixelWidth(), CEGUI::FalagardTitlebar::getPixelRect(), CEGUI::FalagardSystemButton::getPixelRect(), CEGUI::Window::getPixelRect_impl(), CEGUI::Tooltip::getTextSize_impl(), CEGUI::FreeTypeFont::getTextureSize(), CEGUI::Window::getTooltip(), CEGUI::ScrolledContainer::getUnclippedInnerRect_impl(), injectMouseButtonDown(), injectMouseButtonUp(), injectMouseLeaves(), injectMouseMove(), injectMousePosition(), injectMouseWheelChange(), CEGUI::Imageset::load(), CEGUI::DirectX81Texture::loadFromFile(), CEGUI::OpenGLTexture::loadFromFile(), CEGUI::DirectfbTexture::loadFromFile(), CEGUI::DirectX9Texture::loadFromFile(), CEGUI::DirectX10Texture::loadFromFile(), CEGUI::loadTextureFromTargaFile(), CEGUI::WindowManager::loadWindowLayout(), CEGUI::MouseCursor::MouseCursor(), CEGUI::FrameWindow::moveBottomEdge(), CEGUI::FrameWindow::moveLeftEdge(), CEGUI::FrameWindow::moveRightEdge(), CEGUI::FrameWindow::moveTopEdge(), CEGUI::Window::onAlwaysOnTopChanged(), CEGUI::Window::onCaptureLost(), CEGUI::Window::onChildAdded(), CEGUI::Window::onChildRemoved(), CEGUI::DragContainer::onDragPositionChanged(), CEGUI::Titlebar::onMouseButtonDown(), CEGUI::TabButton::onMouseButtonUp(), CEGUI::RadioButton::onMouseButtonUp(), CEGUI::PushButton::onMouseButtonUp(), CEGUI::MenuItem::onMouseButtonUp(), CEGUI::Checkbox::onMouseButtonUp(), CEGUI::FrameWindow::onMouseMove(), CEGUI::Window::onMoved(), CEGUI::Window::onZChange_impl(), CEGUI::Window::onZChanged(), CEGUI::LibxmlParser::parseXMLFile(), CEGUI::ExpatParser::parseXMLFile(), CEGUI::Tree::populateRenderCache(), CEGUI::Tooltip::positionSelf(), CEGUI::DirectX81Renderer::postD3DReset(), CEGUI::DirectX9Renderer::postD3DReset(), CEGUI::FreeTypeFont::rasterize(), CEGUI::FalagardMultiColumnList::render(), CEGUI::FalagardListbox::render(), CEGUI::Window::render(), CEGUI::RenderCache::render(), renderGUI(), CEGUI::Window::requestRedraw(), CEGUI::CoordConverter::screenToWindow(), CEGUI::CoordConverter::screenToWindowX(), CEGUI::CoordConverter::screenToWindowY(), CEGUI::Window::setArea_impl(), setDefaultMouseCursor(), setDefaultTooltip(), CEGUI::Window::setEnabled(), CEGUI::Window::setModalState(), CEGUI::Imageset::setNativeResolution(), CEGUI::Font::setNativeResolution(), setScriptingModule(), CEGUI::Tooltip::setTargetWindow(), CEGUI::Window::setVisible(), setXMLParser(), System(), CEGUI::FrameWindow::toggleRollup(), CEGUI::Imageset::unload(), CEGUI::FreeTypeFont::updateFont(), updateWindowContainingMouse(), and ~System().

System * CEGUI::System::getSingletonPtr ( void   )  [static]

uint CEGUI::System::getSystemKeys ( void   )  const [inline]

Return the current system keys value.

Returns:
uint value representing a combination of the SystemKey bits.

Referenced by CEGUI::Window::generateAutoRepeatEvent(), CEGUI::ItemListbox::notifyItemClicked(), and CEGUI::ItemListbox::onKeyDown().

Window* CEGUI::System::getWindowContainingMouse ( void   )  const [inline]

Return the Window object that the mouse is presently within.

Returns:
Pointer to the Window object that currently contains the mouse cursor, or NULL if none.

Referenced by CEGUI::MenuItem::updateInternalState(), and CEGUI::ButtonBase::updateInternalState().

bool CEGUI::System::injectChar ( utf32  code_point  ) 

Method that injects a typed character event into the system.

Parameters:
code_point Unicode code point of the character that was typed.
Returns:
  • true if the input was processed by the gui system.
  • false if the input was not processed by the gui system.

References CEGUI::KeyEventArgs::codepoint, CEGUI::EventArgs::handled, CEGUI::Window::isVisible(), CEGUI::Window::onCharacter(), CEGUI::KeyEventArgs::sysKeys, and CEGUI::WindowEventArgs::window.

bool CEGUI::System::injectKeyDown ( uint  key_code  ) 

Method that injects a key down event into the system.

Parameters:
key_code uint value indicating which key was pressed.
Returns:
  • true if the input was processed by the gui system.
  • false if the input was not processed by the gui system.

References CEGUI::EventArgs::handled, CEGUI::Window::isVisible(), CEGUI::Window::onKeyDown(), CEGUI::KeyEventArgs::scancode, CEGUI::KeyEventArgs::sysKeys, and CEGUI::WindowEventArgs::window.

bool CEGUI::System::injectKeyUp ( uint  key_code  ) 

Method that injects a key up event into the system.

Parameters:
key_code uint value indicating which key was released.
Returns:
  • true if the input was processed by the gui system.
  • false if the input was not processed by the gui system.

References CEGUI::EventArgs::handled, CEGUI::Window::isVisible(), CEGUI::Window::onKeyUp(), CEGUI::KeyEventArgs::scancode, CEGUI::KeyEventArgs::sysKeys, and CEGUI::WindowEventArgs::window.

bool CEGUI::System::injectMouseButtonDown ( MouseButton  button  ) 

bool CEGUI::System::injectMouseButtonUp ( MouseButton  button  ) 

bool CEGUI::System::injectMouseLeaves ( void   ) 

Method that injects that the mouse has left the application window.

Returns:
  • true if the generated mouse move event was handled.
  • false if the generated mouse move event was not handled.

References CEGUI::MouseEventArgs::button, CEGUI::MouseEventArgs::clickCount, getSingleton(), CEGUI::EventArgs::handled, CEGUI::MouseEventArgs::moveDelta, CEGUI::NoButton, CEGUI::Window::onMouseLeaves(), CEGUI::MouseEventArgs::position, CEGUI::MouseEventArgs::sysKeys, CEGUI::MouseEventArgs::wheelChange, and CEGUI::WindowEventArgs::window.

bool CEGUI::System::injectMouseMove ( float  delta_x,
float  delta_y 
)

Method that injects a mouse movement event into the system.

Parameters:
delta_x amount the mouse moved on the x axis.
delta_y amount the mouse moved on the y axis.
Returns:
  • true if the input was processed by the gui system.
  • false if the input was not processed by the gui system.

References CEGUI::MouseEventArgs::button, CEGUI::MouseEventArgs::clickCount, CEGUI::Vector2::d_x, CEGUI::Vector2::d_y, CEGUI::MouseCursor::getPosition(), getSingleton(), CEGUI::MouseEventArgs::moveDelta, CEGUI::NoButton, CEGUI::MouseCursor::offsetPosition(), CEGUI::MouseEventArgs::position, CEGUI::MouseEventArgs::sysKeys, and CEGUI::MouseEventArgs::wheelChange.

Referenced by CEGUI::Window::onCaptureLost().

bool CEGUI::System::injectMousePosition ( float  x_pos,
float  y_pos 
)

Method that injects a new position for the mouse cursor.

Parameters:
x_pos New absolute pixel position of the mouse cursor on the x axis.
y_pos New absolute pixel position of the mouse cursoe in the y axis.
Returns:
  • true if the generated mouse move event was handled.
  • false if the generated mouse move event was not handled.

References CEGUI::MouseEventArgs::button, CEGUI::MouseEventArgs::clickCount, CEGUI::Vector2::d_x, CEGUI::Vector2::d_y, CEGUI::MouseCursor::getPosition(), getSingleton(), CEGUI::MouseEventArgs::moveDelta, CEGUI::NoButton, CEGUI::MouseEventArgs::position, CEGUI::MouseCursor::setPosition(), CEGUI::MouseEventArgs::sysKeys, and CEGUI::MouseEventArgs::wheelChange.

bool CEGUI::System::injectMouseWheelChange ( float  delta  ) 

Method that injects a mouse-wheel / scroll-wheel event into the system.

Parameters:
delta float value representing the amount the wheel moved.
Returns:
  • true if the input was processed by the gui system.
  • false if the input was not processed by the gui system.

References CEGUI::MouseEventArgs::button, CEGUI::MouseEventArgs::clickCount, getSingleton(), CEGUI::EventArgs::handled, CEGUI::MouseEventArgs::moveDelta, CEGUI::NoButton, CEGUI::Window::onMouseWheel(), CEGUI::MouseEventArgs::position, CEGUI::MouseEventArgs::sysKeys, CEGUI::MouseEventArgs::wheelChange, and CEGUI::WindowEventArgs::window.

bool CEGUI::System::injectTimePulse ( float  timeElapsed  ) 

Method to inject time pulses into the system.

Parameters:
timeElapsed float value indicating the amount of time passed, in seconds, since the last time this method was called.
Returns:
Currently, this method always returns true.

References CEGUI::Window::update().

bool CEGUI::System::isRedrawRequested (  )  const [inline]

Return a boolean value to indicate whether a full re-draw is requested next time renderGUI() is called.

Returns:
true if a re-draw has been requested

void CEGUI::System::notifyWindowDestroyed ( const Window window  ) 

Internal method used to inform the System object whenever a window is destroyed, so that System can perform any required housekeeping.

Note:
This method is not intended for client code usage. If you use this method anything can, and probably will, go wrong!

Referenced by CEGUI::WindowManager::destroyWindow().

void CEGUI::System::renderGUI ( void   ) 

Render the GUI.

Depending upon the internal state, this may either re-use rendering from last time, or trigger a full re-draw from all elements.

Returns:
Nothing

References CEGUI::Renderer::clearRenderList(), CEGUI::Renderer::doRender(), getSingleton(), CEGUI::Window::render(), CEGUI::Renderer::resetZValue(), and CEGUI::Renderer::setQueueingEnabled().

void CEGUI::System::setDefaultFont ( Font font  ) 

Set the default font to be used by the system.

Parameters:
font Pointer to the font to be used as the system default.
Returns:
Nothing.

void CEGUI::System::setDefaultFont ( const String name  ) 

Set the default font to be used by the system.

Parameters:
name String object containing the name of the font to be used as the system default.
Returns:
Nothing.

References CEGUI::String::empty().

Referenced by CEGUI::FontManager::createFont(), and System().

void CEGUI::System::setDefaultMouseCursor ( const String imageset,
const String image_name 
)

Set the image to be used as the default mouse cursor.

Parameters:
imageset String object that contains the name of the Imageset that contains the image to be used.
image_name String object that contains the name of the Image on imageset that is to be used.
Returns:
Nothing.
Exceptions:
UnknownObjectException thrown if imageset is not known, or if imageset contains no Image named image_name.

References setDefaultMouseCursor().

void CEGUI::System::setDefaultMouseCursor ( MouseCursorImage  image  )  [inline]

Set the image to be used as the default mouse cursor.

Parameters:
image One of the MouseCursorImage enumerated values.
Returns:
Nothing.

References setDefaultMouseCursor().

Referenced by setDefaultMouseCursor().

void CEGUI::System::setDefaultMouseCursor ( const Image image  ) 

Set the image to be used as the default mouse cursor.

Parameters:
image Pointer to an image object that is to be used as the default mouse cursor. To have no cursor rendered by default, you can specify NULL here.
Returns:
Nothing.

References CEGUI::DefaultMouseCursor, CEGUI::Window::getMouseCursor(), getSingleton(), and CEGUI::MouseCursor::getSingleton().

Referenced by setDefaultMouseCursor().

void CEGUI::System::setDefaultTooltip ( const String tooltipType  ) 

Set the system default Tooltip to be used by specifying a Window type.

System will internally attempt to create an instance of the specified window type (which must be derived from the base Tooltip class). If the Tooltip creation fails, the error is logged and no system default Tooltip will be available.

Parameters:
tooltipType String object holding the name of the Tooltip based Window type which should be used as the Tooltip for the system default.
Returns:
Nothing.

References CEGUI::String::empty(), getSingleton(), and CEGUI::Window::setWritingXMLAllowed().

void CEGUI::System::setDefaultTooltip ( Tooltip tooltip  ) 

Set the system default Tooltip object. This value may be NULL to indicate that no default Tooltip will be available.

Parameters:
tooltip Pointer to a valid Tooltip based object which should be used as the default tooltip for the system, or NULL to indicate that no system default tooltip is required. Note that when passing a pointer to a Tooltip object, ownership of the Tooltip does not pass to System.
Returns:
Nothing.

References getSingleton(), and CEGUI::Window::setWritingXMLAllowed().

void CEGUI::System::setDefaultXMLParserName ( const String parserName  )  [static]

Static member to set the name of the default XML parser module that should be used.

If you want to modify the default parser from the one compiled in, you need to call this static member prior to instantiating the main CEGUI::System object.

Note that calling this member to change the name of the default module after CEGUI::System, and therefore the default xml parser, has been created will have no real effect - the default parser name will be updated, though no actual changes to the xml parser module will occur.

The built-in options for this are:

Whether these are actually available, depends upon how you built the system. If you have some custom parser, you can provide the name of that here to have it used as the default, though note that the final filename of the parser module should be of the form:

[prefix]CEGUI[parserName][suffix]

where:

  • [prefix] is some optional prefix; like 'lib' on linux.
  • CEGUI is a required prefix.
  • [parserName] is the name of the parser, as supplied to this function.
  • [suffix] is the filename suffix, like .dll or .so

Final module filenames are, thus, of the form:

  • CEGUIXercesParser.dll
  • libCEGUIXercesParser.so

Parameters:
parserName String describing the name of the xml parser module to be used as the default.
Returns:
Nothing.

Window * CEGUI::System::setGUISheet ( Window sheet  ) 

Set the active GUI sheet (root) window.

Parameters:
sheet Pointer to a Window object that will become the new GUI 'root'
Returns:
Pointer to the window that was previously set as the GUI root.

References CEGUI::Window::onParentSized().

Referenced by System().

void CEGUI::System::setModalTarget ( Window target  )  [inline]

Internal method to directly set the current modal target.

Note:
This method is called internally by Window, and must be used by client code. Doing so will most likely not have the expected results.

Referenced by CEGUI::Window::setModalState().

void CEGUI::System::setMouseMoveScaling ( float  scaling  ) 

Set the current mouse movement scaling factor.

Parameters:
scaling float value specifying the scaling to be applied to mouse movement inputs.
Returns:
nothing.

void CEGUI::System::setMultiClickTimeout ( double  timeout  ) 

Set the timeout to be used for the generation of multi-click events.

A multi-click event is a double-click, or a triple-click. The value returned here is the maximum allowable time between mouse button down events for which a multi-click event will be generated.

Parameters:
timeout double value equal to the multi-click timeout value to be used from now onwards.
Note:
A timeout value of 0 indicates infinity and so no timeout occurrs; as long as the mouse is in the prescribed area, an appropriate mouse button event will therefore always be raised.
Returns:
Nothing.

void CEGUI::System::setMultiClickToleranceAreaSize ( const Size sz  ) 

Set the size of the allowable mouse movement tolerance used when generating multi-click events.

This size defines an area with the mouse at the centre. The mouse must stay within the tolerance defined for a multi-click (double click, or triple click) event to be generated.

Parameters:
sz Size object describing the multi-click tolerance area size to be used.
Returns:
Nothing.

void CEGUI::System::setScriptingModule ( ScriptModule scriptModule  ) 

Set the ScriptModule to be used for scripting within the GUI system.

Parameters:
scriptModule Pointer to a ScriptModule based object, or 0 for none (be careful!)
Returns:
Nothing

References CEGUI::ScriptModule::createBindings(), CEGUI::ScriptModule::destroyBindings(), CEGUI::ScriptModule::getIdentifierString(), and getSingleton().

void CEGUI::System::setSingleClickTimeout ( double  timeout  ) 

Set the timeout used for generation of single-click events.

A single-click is defined here as a button being pressed and then released.

Parameters:
timeout double value equal to the single-click timeout value to be used from now onwards.
Note:
A timeout value of 0 indicates infinity and so no timeout occurrs; as long as the mouse is in the prescribed area, a mouse button 'clicked' event will therefore always be raised.
Returns:
Nothing.

void CEGUI::System::setXMLParser ( XMLParser parser  ) 

Sets the XMLParser object to be used by the system.

The current XMLParser will be cleaned up and, if owned by the system, also deleted, as will any dynamically loaded module associated with the XMLParser object.

If the argument passed in the parser parameter is 0, the system will cleanup any existing parser as described above, and revert to using the parser provided by the default module (see getDefaultXMLParserName and setDefaultXMLParserName).

Parameters:
parser Pointer to the XMLParser object to be used by the system, or 0 to cause the system to initialise a default parser.

void CEGUI::System::setXMLParser ( const String parserName  ) 

Set a new XML parser module to be used.

The current XMLParser will be cleaned up and, if owned by the system, also deleted, as will any dynamically loaded module associated with the XMLParser object. The newly created XMLParser object, and the associated module will be owned by the system.

Parameters:
parserName String object describing the name of the XML parser module to be used.

References CEGUI::Errors, getSingleton(), CEGUI::DynamicModule::getSymbolAddress(), and CEGUI::XMLParser::initialise().

void CEGUI::System::signalRedraw (  )  [inline]

bool CEGUI::System::updateWindowContainingMouse (  ) 

Perform updates with regards to the window that contains the mouse cursor, firing any required MouseEnters / MouseLeaves events.

Note:
The CEGUI system components call this member as a matter of course, in most cases there will be no need for user / client code to call this member directly.
Returns:
  • true if the window containing the mouse had changed.
  • false if the window containing the mouse had not changed.

References CEGUI::MouseEventArgs::button, CEGUI::MouseEventArgs::clickCount, getSingleton(), CEGUI::EventArgs::handled, CEGUI::NoButton, CEGUI::Window::onMouseEnters(), CEGUI::Window::onMouseLeaves(), CEGUI::MouseEventArgs::position, CEGUI::MouseEventArgs::sysKeys, CEGUI::MouseEventArgs::wheelChange, and CEGUI::WindowEventArgs::window.

Referenced by CEGUI::Window::onZChange_impl(), CEGUI::Window::setArea_impl(), CEGUI::Window::setEnabled(), CEGUI::Window::setVisible(), and CEGUI::FrameWindow::toggleRollup().


Generated on Thu Nov 27 20:34:32 2008 for Crazy Eddies GUI System by  doxygen 1.5.7.1