// Copyright (C) 2002-2011 Nikolaus Gebhardt // This file is part of the "Irrlicht Engine". // For conditions of distribution and use, see copyright notice in irrlicht.h #ifndef __C_GUI_CONTEXT_MENU_H_INCLUDED__ #define __C_GUI_CONTEXT_MENU_H_INCLUDED__ #include "IrrCompileConfig.h" #ifdef _IRR_COMPILE_WITH_GUI_ #include "IGUIContextMenu.h" #include "irrString.h" #include "irrArray.h" #include "IGUIFont.h" namespace irr { namespace gui { //! GUI Context menu interface. class CGUIContextMenu : public IGUIContextMenu { public: //! constructor CGUIContextMenu(IGUIEnvironment* environment, IGUIElement* parent, s32 id, core::rect rectangle, bool getFocus = true, bool allowFocus = true); //! destructor virtual ~CGUIContextMenu(); //! set behaviour when menus are closed virtual void setCloseHandling(ECONTEXT_MENU_CLOSE onClose); //! get current behaviour when the menue will be closed virtual ECONTEXT_MENU_CLOSE getCloseHandling() const; //! Returns amount of menu items virtual u32 getItemCount() const; //! Adds a menu item. virtual u32 addItem(const wchar_t* text, s32 commandid, bool enabled, bool hasSubMenu, bool checked, bool autoChecking); //! Insert a menu item at specified position. virtual u32 insertItem(u32 idx, const wchar_t* text, s32 commandId, bool enabled, bool hasSubMenu, bool checked, bool autoChecking); //! Find a item which has the given CommandId starting from given index virtual s32 findItemWithCommandId(s32 commandId, u32 idxStartSearch) const; //! Adds a separator item to the menu virtual void addSeparator(); //! Returns text of the menu item. virtual const wchar_t* getItemText(u32 idx) const; //! Sets text of the menu item. virtual void setItemText(u32 idx, const wchar_t* text); //! Returns if a menu item is enabled virtual bool isItemEnabled(u32 idx) const; //! Sets if the menu item should be enabled. virtual void setItemEnabled(u32 idx, bool enabled); //! Returns if a menu item is checked virtual bool isItemChecked(u32 idx) const; //! Sets if the menu item should be checked. virtual void setItemChecked(u32 idx, bool enabled); //! Removes a menu item virtual void removeItem(u32 idx); //! Removes all menu items virtual void removeAllItems(); //! called if an event happened. virtual bool OnEvent(const SEvent& event); //! draws the element and its children virtual void draw(); //! Returns the selected item in the menu virtual s32 getSelectedItem() const; //! Returns a pointer to the submenu of an item. //! \return Pointer to the submenu of an item. virtual IGUIContextMenu* getSubMenu(u32 idx) const; //! Sets the visible state of this element. virtual void setVisible(bool visible); //! should the element change the checked status on clicking virtual void setItemAutoChecking(u32 idx, bool autoChecking); //! does the element change the checked status on clicking virtual bool getItemAutoChecking(u32 idx) const; //! Returns command id of a menu item virtual s32 getItemCommandId(u32 idx) const; //! Sets the command id of a menu item virtual void setItemCommandId(u32 idx, s32 id); //! Adds a sub menu from an element that already exists. virtual void setSubMenu(u32 index, CGUIContextMenu* menu); //! When an eventparent is set it receives events instead of the usual parent element virtual void setEventParent(IGUIElement *parent); //! Writes attributes of the element. virtual void serializeAttributes(io::IAttributes* out, io::SAttributeReadWriteOptions* options) const; //! Reads attributes of the element virtual void deserializeAttributes(io::IAttributes* in, io::SAttributeReadWriteOptions* options); protected: void closeAllSubMenus(); bool hasOpenSubMenu() const; struct SItem { core::stringw Text; bool IsSeparator; bool Enabled; bool Checked; bool AutoChecking; core::dimension2d Dim; s32 PosY; CGUIContextMenu* SubMenu; s32 CommandId; }; virtual void recalculateSize(); //! returns true, if an element was highlighted virtual bool highlight(const core::position2d& p, bool canOpenSubMenu); //! sends a click Returns: //! 0 if click went outside of the element, //! 1 if a valid button was clicked, //! 2 if a nonclickable element was clicked virtual u32 sendClick(const core::position2d& p); //! returns the item highlight-area virtual core::rect getHRect(const SItem& i, const core::rect& absolute) const; //! Gets drawing rect of Item virtual core::rect getRect(const SItem& i, const core::rect& absolute) const; core::array Items; core::position2d Pos; IGUIElement* EventParent; IGUIFont *LastFont; ECONTEXT_MENU_CLOSE CloseHandling; s32 HighLighted; u32 ChangeTime; bool AllowFocus; }; } // end namespace gui } // end namespace irr #endif // _IRR_COMPILE_WITH_GUI_ #endif // __C_GUI_CONTEXT_MENU_H_INCLUDED__