OgreOverlayContainer.h

Go to the documentation of this file.

/*
-----------------------------------------------------------------------------
This source file is part of OGRE
    (Object-oriented Graphics Rendering Engine)
For the latest info, see http://www.ogre3d.org/

Copyright (c) 2000-2005 The OGRE Team
Also see acknowledgements in Readme.html

This program is free software; you can redistribute it and/or modify it under
the terms of the GNU Lesser General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
Place - Suite 330, Boston, MA 02111-1307, USA, or go to
http://www.gnu.org/copyleft/lesser.txt.
-----------------------------------------------------------------------------
*/

#ifndef __OverlayContainer_H__
#define __OverlayContainer_H__

#include "OgrePrerequisites.h"
#include "OgreOverlayElement.h"
#include "OgreIteratorWrappers.h"


namespace Ogre {


    class _OgreExport OverlayContainer : public OverlayElement
    {
    public:
        typedef std::map<String, OverlayElement*> ChildMap;
        typedef MapIterator<ChildMap> ChildIterator;
        typedef std::map<String, OverlayContainer*> ChildContainerMap;
        typedef MapIterator<ChildContainerMap> ChildContainerIterator;
    protected:
        // Map of all children
        ChildMap mChildren;
        // Map of container children (subset of mChildren)
        ChildContainerMap mChildContainers;

        bool mChildrenProcessEvents;
 
    public:
        OverlayContainer(const String& name);
        virtual ~OverlayContainer();

        virtual void addChild(OverlayElement* elem);
        virtual void addChildImpl(OverlayElement* elem);
        virtual void addChildImpl(OverlayContainer* cont);
        virtual void removeChild(const String& name);
        virtual OverlayElement* getChild(const String& name);

        void initialise(void);

        void _addChild(OverlayElement* elem);
        void _removeChild(OverlayElement* elem) { _removeChild(elem->getName()); }
        void _removeChild(const String& name);

        virtual ChildIterator getChildIterator(void);

        virtual ChildContainerIterator getChildContainerIterator(void);

        virtual void _positionsOutOfDate(void);

        virtual void _update(void);

        virtual void _notifyZOrder(ushort newZOrder);

        virtual void _notifyViewport();

        virtual void _notifyWorldTransforms(const Matrix4& xform);

        virtual void _notifyParent(OverlayContainer* parent, Overlay* overlay);

        virtual void _updateRenderQueue(RenderQueue* queue);

        inline bool isContainer() const
        { return true; }

        virtual inline bool isChildrenProcessEvents() const
        { return true; }

        virtual inline void setChildrenProcessEvents(bool val)
        { mChildrenProcessEvents = val; }

        virtual OverlayElement* findElementAt(Real x, Real y);      // relative to parent

        void copyFromTemplate(OverlayElement* templateOverlay);
        virtual OverlayElement* clone(const String& instanceName);

    };



}


#endif

---

Copyright © 2000-2005 by The OGRE Team

This work is licensed under a Creative Commons Attribution-ShareAlike 2.5 License.
Last modified Sun Mar 12 14:37:45 2006