| | | | | | | |

IGUIEnvironment.h

Go to the documentation of this file.

// Copyright (C) 2002-2008 Nikolaus Gebhardt
// This file is part of the "Irrlicht Engine".
// For conditions of distribution and use, see copyright notice in irrlicht.h

#ifndef __I_GUI_ENVIRONMENT_H_INCLUDED__
#define __I_GUI_ENVIRONMENT_H_INCLUDED__

#include "IReferenceCounted.h"
#include "IGUISkin.h"
#include "rect.h"
#include "EMessageBoxFlags.h"
#include "IEventReceiver.h"
#include "IXMLReader.h"

namespace irr
{
        class IOSOperator;
        class IEventReceiver;

        namespace io
        {
                class IXMLWriter;
                class IReadFile;
                class IWriteFile;
                class IFileSystem;
        } // end namespace io
        namespace video
        {
                class IVideoDriver;
                class ITexture;
        } // end namespace video

namespace gui
{

class IGUIElement;
class IGUIFont;
class IGUISpriteBank;
class IGUIScrollBar;
class IGUIImage;
class IGUIMeshViewer;
class IGUICheckBox;
class IGUIListBox;
class IGUIFileOpenDialog;
class IGUIColorSelectDialog;
class IGUIInOutFader;
class IGUIStaticText;
class IGUIEditBox;
class IGUISpinBox;
class IGUITabControl;
class IGUITab;
class IGUIContextMenu;
class IGUIComboBox;
class IGUIToolBar;
class IGUIButton;
class IGUIWindow;
class IGUIElementFactory;

class IGUIEnvironment : public virtual IReferenceCounted
{
public:

        virtual void drawAll() = 0;


        virtual bool setFocus(IGUIElement* element) = 0;

        virtual IGUIElement* getFocus() const = 0;


        virtual bool removeFocus(IGUIElement* element) = 0;


        virtual bool hasFocus(IGUIElement* element) const = 0;

        virtual video::IVideoDriver* getVideoDriver() const = 0;

        virtual io::IFileSystem* getFileSystem() const = 0;

        virtual IOSOperator* getOSOperator() const = 0;

        virtual void clear() = 0;


        virtual bool postEventFromUser(const SEvent& event) = 0;


        virtual void setUserEventReceiver(IEventReceiver* evr) = 0;

        virtual IGUISkin* getSkin() const = 0;


        virtual void setSkin(IGUISkin* skin) = 0;


        virtual IGUISkin* createSkin(EGUI_SKIN_TYPE type) = 0;


        virtual IGUIFont* getFont(const c8* filename) = 0;


        virtual IGUIFont* getBuiltInFont() const = 0;


        virtual IGUISpriteBank* getSpriteBank(const c8* filename) = 0;


        virtual IGUISpriteBank* addEmptySpriteBank(const c8 *name) = 0;


        virtual IGUIElement* getRootGUIElement() = 0;


        virtual IGUIButton* addButton(const core::rect<s32>& rectangle,
                IGUIElement* parent=0, s32 id=-1, const wchar_t* text=0, const wchar_t* tooltiptext = 0) = 0;


        virtual IGUIWindow* addWindow(const core::rect<s32>& rectangle, bool modal = false,
                const wchar_t* text=0, IGUIElement* parent=0, s32 id=-1) = 0;


        virtual IGUIElement* addModalScreen(IGUIElement* parent) = 0;


        virtual IGUIWindow* addMessageBox(const wchar_t* caption, const wchar_t* text=0,
                bool modal = true, s32 flags = EMBF_OK, IGUIElement* parent=0, s32 id=-1) = 0;


        virtual IGUIScrollBar* addScrollBar(bool horizontal, const core::rect<s32>& rectangle,
                IGUIElement* parent=0, s32 id=-1) = 0;


        virtual IGUIImage* addImage(video::ITexture* image, core::position2d<s32> pos,
                bool useAlphaChannel=true, IGUIElement* parent=0, s32 id=-1, const wchar_t* text=0) = 0;


        virtual IGUIImage* addImage(const core::rect<s32>& rectangle,
                IGUIElement* parent=0, s32 id=-1, const wchar_t* text=0) = 0;


        virtual IGUICheckBox* addCheckBox(bool checked, const core::rect<s32>& rectangle,
                IGUIElement* parent=0, s32 id=-1, const wchar_t* text=0) = 0;


        virtual IGUIListBox* addListBox(const core::rect<s32>& rectangle,
                IGUIElement* parent=0, s32 id=-1, bool drawBackground=false) = 0;


        virtual IGUIMeshViewer* addMeshViewer(const core::rect<s32>& rectangle,
                        IGUIElement* parent=0, s32 id=-1, const wchar_t* text=0) = 0;


        virtual IGUIFileOpenDialog* addFileOpenDialog(const wchar_t* title = 0,
                bool modal=true, IGUIElement* parent=0, s32 id=-1) = 0;


        virtual IGUIColorSelectDialog* addColorSelectDialog(const wchar_t* title = 0,
                bool modal=true, IGUIElement* parent=0, s32 id=-1) = 0;


        virtual IGUIStaticText* addStaticText(const wchar_t* text, const core::rect<s32>& rectangle,
                bool border=false, bool wordWrap=true, IGUIElement* parent=0, s32 id=-1,
                bool fillBackground = false) = 0;


        virtual IGUIEditBox* addEditBox(const wchar_t* text, const core::rect<s32>& rectangle,
                bool border=true, IGUIElement* parent=0, s32 id=-1) = 0;


        virtual IGUISpinBox* addSpinBox(const wchar_t* text, const core::rect<s32>& rectangle,
                IGUIElement* parent=0, s32 id=-1) = 0;

        /* \param rectangle Rectangle specifying the borders of the element.
        If the pointer is NULL, the whole screen is used.
        \param parent Parent item of the element, e.g. a window.
        \param id An identifier for the fader.
        \return Pointer to the created in-out-fader. Returns 0 if an error
        occured. This pointer should not be dropped. See
        IReferenceCounted::drop() for more information. */
        virtual IGUIInOutFader* addInOutFader(const core::rect<s32>* rectangle=0, IGUIElement* parent=0, s32 id=-1) = 0;


        virtual IGUITabControl* addTabControl(const core::rect<s32>& rectangle,
                IGUIElement* parent=0, bool fillbackground=false,
                bool border=true, s32 id=-1) = 0;


        virtual IGUITab* addTab(const core::rect<s32>& rectangle,
                IGUIElement* parent=0, s32 id=-1) = 0;


        virtual IGUIContextMenu* addContextMenu(const core::rect<s32>& rectangle,
                IGUIElement* parent=0, s32 id=-1) = 0;

        /* This is like the menu you can find on top of most windows in modern
        graphical user interfaces.
        \param parent Parent item of the element, e.g. a window.
        Set it to 0 to place the menu directly in the environment.
        \param id An identifier for the menu.
        \return Pointer to the created menu. Returns 0 if an
        error occured. This pointer should not be dropped. See
        IReferenceCounted::drop() for more information. */
        virtual IGUIContextMenu* addMenu(IGUIElement* parent=0, s32 id=-1) = 0;


        virtual IGUIToolBar* addToolBar(IGUIElement* parent=0, s32 id=-1) = 0;


        virtual IGUIComboBox* addComboBox(const core::rect<s32>& rectangle,
                IGUIElement* parent=0, s32 id=-1) = 0;


        virtual IGUIElementFactory* getDefaultGUIElementFactory() const = 0;


        virtual void registerGUIElementFactory(IGUIElementFactory* factoryToAdd) = 0;

        virtual u32 getRegisteredGUIElementFactoryCount() const = 0;

        virtual IGUIElementFactory* getGUIElementFactory(u32 index) const = 0;

        virtual IGUIElement* addGUIElement(const c8* elementName, IGUIElement* parent=0) = 0;

        virtual bool saveGUI(const c8* filename, IGUIElement* start=0) = 0;

        virtual bool saveGUI(io::IWriteFile* file, IGUIElement* start=0) = 0;

        virtual bool loadGUI(const c8* filename, IGUIElement* parent=0) = 0;

        virtual bool loadGUI(io::IReadFile* file, IGUIElement* parent=0) = 0;

        virtual void serializeAttributes(io::IAttributes* out, io::SAttributeReadWriteOptions* options=0) const =0;

        virtual void deserializeAttributes(io::IAttributes* in, io::SAttributeReadWriteOptions* options=0)=0;

        virtual void writeGUIElement(io::IXMLWriter* writer, IGUIElement* node) =0;

        virtual void readGUIElement(io::IXMLReader* reader, IGUIElement* parent) =0;
};


} // end namespace gui
} // end namespace irr

#endif

---

The Irrlicht Engine Documentation © 2003-2008 by Nikolaus Gebhardt. Generated on Sun Sep 21 08:57:41 2008 by Doxygen (1.4.2)