/**

  * vim: set ts=4 :

  * =============================================================================

  * SourceMod

  * Copyright (C) 2004-2008 AlliedModders LLC.  All rights reserved.

  * =============================================================================

  *

  * This program is free software; you can redistribute it and/or modify it under

  * the terms of the GNU General Public License, version 3.0, as published by the

  * Free Software Foundation.

  * 

  * 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 General Public License for more

  * details.

  *

  * You should have received a copy of the GNU General Public License along with

  * this program.  If not, see <http://www.gnu.org/licenses/>.

  *

  * As a special exception, AlliedModders LLC gives you permission to link the

  * code of this program (as well as its derivative works) to "Half-Life 2," the

  * "Source Engine," the "SourcePawn JIT," and any Game MODs that run on software

  * by the Valve Corporation.  You must obey the GNU General Public License in

  * all respects for all other code used.  Additionally, AlliedModders LLC grants

  * this exception to all derivative works.  AlliedModders LLC defines further

  * exceptions, found in LICENSE.txt (as of this writing, version JULY-31-2007),

  * or <http://www.sourcemod.net/license.php>.

  *

  * Version: $Id$

  */

 #ifndef _INCLUDE_SOURCEMOD_MENU_SYSTEM_H_

 #define _INCLUDE_SOURCEMOD_MENU_SYSTEM_H_

 #include <IShareSys.h>

 #include <IHandleSys.h>

 #define SMINTERFACE_MENUMANAGER_NAME		"IMenuManager"

 #define SMINTERFACE_MENUMANAGER_VERSION		15

 /**

  * @file IMenuManager.h

  * @brief Abstracts on-screen menus for clients.

  */

 namespace SourceMod

 {

 	/**

 	 * @brief Used to determine how an item selection is interpreted.

 	 */

 	enum ItemSelection

 	{

 		ItemSel_None,					/**< Invalid selection */

 		ItemSel_Back,					/**< Go back one page (really "Previous") */

 		ItemSel_Next,					/**< Go forward one page */

 		ItemSel_Exit,					/**< Menu was exited */

 		ItemSel_Item,					/**< Valid item selection */

 		ItemSel_ExitBack,				/**< Sends MenuEnd_ExitBack */

 	};

 	/**

 	 * @brief Used to determine which order to search for items in.

 	 */

 	enum ItemOrder

 	{

 		ItemOrder_Ascending,			/**< Items should be drawn ascendingly */

 		ItemOrder_Descending,			/**< Items should be drawn descendingly */

 	};

 	/**

 	 * @brief Pairs an item type with an item menu position.

 	 */

 	struct menu_slots_t

 	{

 		ItemSelection type;				/**< Item selection type */

 		unsigned int item;				/**< Item position, if applicable */

 	};

 	class IBaseMenu;

 	class IMenuPanel;

 	class IMenuHandler;

 	/**

 	 * @brief Describes menu display information.

 	 */

 	struct menu_states_t

 	{

 		unsigned int apiVers;			/**< Must be filled with the API version */

 		IBaseMenu *menu;				/**< Menu pointer, or NULL if there is only a display */

 		IMenuHandler *mh;				/**< Menu callbacks handler */

 		unsigned int firstItem;			/**< MENU ONLY: First item displayed on the last page */

 		unsigned int lastItem;			/**< MENU ONLY: Last item displayed on the last page */

 		unsigned int item_on_page;		/**< MENU ONLY: First item on page */

 		menu_slots_t slots[11];			/**< MENU ONLY: Item selection table (first index is 1) */

 	};

 	#define ITEMDRAW_DEFAULT		(0)		/**< Item should be drawn normally */

 	#define ITEMDRAW_DISABLED		(1<<0)	/**< Item is drawn but not selectable */

 	#define ITEMDRAW_RAWLINE		(1<<1)	/**< Item should be a raw line, without a slot */

 	#define ITEMDRAW_NOTEXT			(1<<2)	/**< No text should be drawn */

 	#define ITEMDRAW_SPACER			(1<<3)	/**< Item should be drawn as a spacer, if possible */

 	#define ITEMDRAW_IGNORE	((1<<1)|(1<<2))	/**< Item should be completely ignored (rawline + notext) */

 	#define ITEMDRAW_CONTROL		(1<<4)	/**< Item is control text (back/next/exit) */

 	/**

 	 * @brief Information about item drawing.

 	 */

 	struct ItemDrawInfo

 	{

 		ItemDrawInfo(const char *DISPLAY=NULL, unsigned int STYLE=ITEMDRAW_DEFAULT, 

 					 unsigned int FLAGS=0, const char *HELPTEXT=NULL) 

 			: display(DISPLAY), style(STYLE)

 		{

 		}

 		const char *display;			/**< Display text (NULL for none) */

 		unsigned int style;				/**< ITEMDRAW style flags */

 	};

 	/**

 	 * @brief Contains information about a vote result.

 	 */

 	struct menu_vote_result_t

 	{

 		unsigned int num_clients;		/**< Number of clients the menu was displayed to */

 		unsigned int num_votes;			/**< Number of votes received */

 		struct menu_client_vote_t

 		{

 			int client;					/**< Client index */

 			int item;					/**< Item # (or -1 for none) */

 		} *client_list;					/**< Array of size num_clients */

 		unsigned int num_items;			/**< Number of items voted for */

 		struct menu_item_vote_t

 		{

 			unsigned int item;			/**< Item index */

 			unsigned int count;			/**< Number of votes */

 		} *item_list;					/**< Array of size num_items, sorted by count, 

 											 descending */

 	};

 	/**

 	 * @brief Reasons for a menu dying.

 	 */

 	enum MenuCancelReason

 	{

 		MenuCancel_Disconnected = -1,	/**< Client dropped from the server */

 		MenuCancel_Interrupted = -2,	/**< Client was interrupted with another menu */

 		MenuCancel_Exit = -3,			/**< Client selected "exit" on a paginated menu */

 		MenuCancel_NoDisplay = -4,		/**< Menu could not be displayed to the client */

 		MenuCancel_Timeout = -5,		/**< Menu timed out */

 		MenuCancel_ExitBack = -6,		/**< Client selected "exit back" on a paginated menu */

 	};

 	/**

 	 * @brief Reasons a menu ended.

 	 */

 	enum MenuEndReason

 	{

 		MenuEnd_Selected = 0,				/**< Menu item was selected */

 		MenuEnd_VotingDone = -1,			/**< Voting finished */

 		MenuEnd_VotingCancelled = -2,		/**< Voting was cancelled */

 		MenuEnd_Cancelled = -3,				/**< Menu was uncleanly cancelled */

 		MenuEnd_Exit = -4,					/**< Menu was cleanly exited via "exit" */

 		MenuEnd_ExitBack = -5,				/**< Menu was cleanly exited via "back" */

 	};

 	/**

 	 * @brief Reasons a vote can be cancelled.

 	 */

 	enum VoteCancelReason

 	{

 		VoteCancel_Generic = -1,		/**< Vote was generically cancelled. */

 		VoteCancel_NoVotes = -2,		/**< Vote did not receive any votes. */

 	};

 	#define MENU_NO_PAGINATION			0		/**< Menu should not be paginated (10 items max) */

 	#define MENU_TIME_FOREVER			0		/**< Menu should be displayed as long as possible */

 	#define MENUFLAG_BUTTON_EXIT		(1<<0)	/**< Menu has an "exit" button */

 	#define MENUFLAG_BUTTON_EXITBACK	(1<<1)	/**< Menu has an "exit back" button */

 	#define MENUFLAG_NO_SOUND			(1<<2)	/**< Menu will not have any select sounds */

 	/**

 	 * @brief Extended menu options.

 	 */

 	enum MenuOption

 	{

 		MenuOption_IntroMessage,				/**< CONST CHAR *: Valve menus only; defaults to:

 													 "You have a menu, hit ESC"

 													 */

 		MenuOption_IntroColor,					/**< INT[4]: Valve menus only; specifies the intro message colour

 													 using R,G,B,A (defaults to 255,0,0,255)

 													 */

 		MenuOption_Priority,					/**< INT *: Valve menus only; priority (less is higher) */

 	};

 	/**

 	 * @brief Describes the menu a player is viewing.

 	 */

 	enum MenuSource

 	{

 		MenuSource_None = 0,					/**< No menu is being displayed */

 		MenuSource_External = 1,				/**< External menu, no pointer */

 		MenuSource_BaseMenu = 2,				/**< An IBaseMenu pointer. */

 		MenuSource_Display = 3,					/**< IMenuPanel source, no pointer */

 	};

 	class IMenuStyle;

 	/**

 	 * @brief Sets how a raw menu should be drawn.

 	 */

 	class IMenuPanel

 	{

 	public:

 		/**

 		 * @brief Returns the parent IMenuStyle pointer.

 		 *

 		 * @return				IMenuStyle pointer which created

 		 *						this object.

 		 */

 		virtual IMenuStyle *GetParentStyle() =0;

 		/**

 		 * @brief Resets/clears the cached display text.

 		 */

 		virtual void Reset() =0;

 		/**

 		 * @brief Sets how the title should be drawn.

 		 *

 		 * @param text			Text string to display for the title.

 		 * @param onlyIfEmpty	Only sets the title if one does not already 

 		 *						exist.

 		 */

 		virtual void DrawTitle(const char *text, bool onlyIfEmpty=false) =0;

 		/**

 		 * @brief Adds an item to the menu and returns the position (1-10).

 		 *

 		 * Note: Item will fail to draw if there are too many items,

 		 * or the item is not drawable (for example, invisible).	

 		 * 

 		 * @return				Item draw position, or 0 on failure.

 		 */

 		virtual unsigned int DrawItem(const ItemDrawInfo &item) =0;

 		/**

 		 * @brief Draws a raw line of text, if supported.  The line does not 

 		 * need to be newline terminated.

 		 *

 		 * @return				True on success, false if not supported.

 		 */

 		virtual bool DrawRawLine(const char *rawline) =0;

 		/**

 		 * @brief Sets an extended menu option.

 		 *

 		 * @param option		Option type.

 		 * @param valuePtr		Pointer of the type expected by the option.

 		 * @return				True on success, false if option or value is not supported.

 		 */

 		virtual bool SetExtOption(MenuOption option, const void *valuePtr) =0;

 		/**

 		 * @brief Returns whether the display is capable of rendering an item

 		 * with the given flags.

 		 *

 		 * @param drawFlags		ITEMDRAW flags.

 		 * @return				True if renderable, false otherwise.

 		 */

 		virtual bool CanDrawItem(unsigned int drawFlags) =0;

 		/**

 		 * @brief Sends the menu display to a client.

 		 *

 		 * @param client		Client index to display to.

 		 * @param handler		Menu handler to use.

 		 * @param time			Time to hold menu for.

 		 * @return				True on success, false otherwise.

 		 */

 		virtual bool SendDisplay(int client, IMenuHandler *handler, unsigned int time) =0;

 		/**

 		 * @brief Destroys the display object.

 		 */

 		virtual void DeleteThis() =0;

 		/**

 		 * @brief Sets the selectable key map.  Returns false if the function 

 		 * is not supported.

 		 * 

 		 * @param keymap		A bit string where each bit N-1 specifies 

 		 *						that key N is selectable (key 0 is bit 9).  

 		 *						If the selectable key map is 0, it will be

 		 *						automatically set to allow 0.

 		 * @return				True on success, false if not supported.

 		 */

 		virtual bool SetSelectableKeys(unsigned int keymap) =0;

 		/**

 		 * @brief Returns the current key position.

 		 *

 		 * @return				Current key position starting at 1.

 		 */

 		virtual unsigned int GetCurrentKey() =0;

 		/**

 		 * @brief Sets the next key position.  This cannot be used

 		 * to traverse backwards.

 		 *

 		 * @param key			Key that is greater or equal to

 		 *						GetCurrentKey().

 		 * @return				True on success, false otherwise.

 		 */

 		virtual bool SetCurrentKey(unsigned int key) =0;

 		/**

 		 * @brief Returns the number of characters that can be added to the 

 		 * menu.  The internal buffer is truncated if overflowed; this is for 

 		 * manual truncation/wrapping purposes.

 		 *

 		 * @return				Number of bytes available.  If the result is 

 		 *						-1, then the panel has no text limit.

 		 */

 		virtual int GetAmountRemaining() =0;

 		/**

 		 * @brief For the Handle system, returns approximate memory usage.

 		 *

 		 * @return				Approximate number of bytes being used.

 		 */

 		virtual unsigned int GetApproxMemUsage() =0;

 	};

 	/**

 	 * @brief Describes a "MenuStyle" system which manages

 	 * menu drawing and construction.

 	 */

 	class IMenuStyle

 	{

 	public:

 		/**

 		 * @brief Returns the style API version.

 		 *

 		 * @return				API version.

 		 */

 		virtual unsigned int GetStyleAPIVersion()

 		{

 			return SMINTERFACE_MENUMANAGER_VERSION;

 		}

 		/**

 		 * @brief Returns the name of the menu style.

 		 *

 		 * @return				String containing the style name.

 		 */

 		virtual const char *GetStyleName() =0;

 		/**

 		 * @brief Creates an IMenuPanel object.

 		 *

 		 * Note: the object should be freed using ::DeleteThis.

 		 *

 		 * @return				IMenuPanel object.

 		 */

 		virtual IMenuPanel *CreatePanel() =0;

 		/**

 		 * @brief Creates an IBaseMenu object of this style.

 		 *

 		 * Note: the object should be freed using IBaseMenu::Destroy.

 		 *

 		 * @param handler		IMenuHandler pointer.

 		 * @param pOwner		Optional IdentityToken_t owner for handle 

 		 *						creation.

 		 * @return				An IBaseMenu pointer.

 		 */

 		virtual IBaseMenu *CreateMenu(IMenuHandler *handler, IdentityToken_t *pOwner=NULL) =0;

 		/**

 		 * @brief Returns the maximum number of items per page.

 		 *

 		 * Menu implementations must return >= 2.  Styles with only 1 or 0 

 		 * items per page are not valid.

 		 *

 		 * @return				Number of items per page.

 		 */

 		virtual unsigned int GetMaxPageItems() =0;

 		/**

 		 * @brief Returns whether or not a client is viewing a menu.

 		 *

 		 * @param client		Client index.

 		 * @param object		Optional pointer to retrieve menu object,

 		 *						if any.

 		 * @return				MenuSource value.

 		 */

 		virtual MenuSource GetClientMenu(int client, void **object) =0;

 		/**

 		 * @brief Cancels a client's menu.

 		 *

 		 * @param client		Client index.

 		 * @param autoIgnore	If true, no menus can be created during 

 		 *						the cancellation process.

 		 * @return				True if a menu was cancelled, false otherwise.

 		 */

 		virtual bool CancelClientMenu(int client, bool autoIgnore=false) =0;

 		/**

 		 * @brief Returns a Handle the IMenuStyle object.

 		 *

 		 * @return				Handle_t pointing to this object.

 		 */

 		virtual Handle_t GetHandle() =0;

 		/**

 		 * @brief For the Handle system, returns approximate memory usage.

 		 *

 		 * @return				Approximate number of bytes being used.

 		 */

 		virtual unsigned int GetApproxMemUsage() =0;

 	};

 	/**

 	 * @brief High-level interface for building menus.

 	 */

 	class IBaseMenu

 	{

 	public:

 		/**

 		 * @brief Appends an item to the end of a menu.

 		 *

 		 * @param info			Item information string.

 		 * @param draw			Default drawing information.

 		 * @return				True on success, false on item limit reached.

 		 */

 		virtual bool AppendItem(const char *info, const ItemDrawInfo &draw) =0;

 		/**

 		 * @brief Inserts an item into the menu before a certain position; 

 		 * the new item will be at the given position and all next items 

 		 * pushed forward.

 		 *

 		 * @param position		Position, starting from 0.

 		 * @param info			Item information string.

 		 * @param draw			Default item draw info.

 		 * @return				True on success, false on invalid menu position

 		 */

 		virtual bool InsertItem(unsigned int position, const char *info, const ItemDrawInfo &draw) =0;

 		/**

 		 * @brief Removes an item from the menu.

 		 *

 		 * @param position		Position, starting from 0.

 		 * @return				True on success, false on invalid menu position.

 		 */

 		virtual bool RemoveItem(unsigned int position) =0;

 		/**

 		 * @brief Removes all items from the menu.

 		 */

 		virtual void RemoveAllItems() =0;

 		/**

 		 * @brief Returns an item's info.

 		 *

 		 * @param position		Position, starting from 0.

 		 * @param draw			Optional pointer to store a draw information.

 		 * @return				Info string pointer, or NULL if position was invalid.

 		 */

 		virtual const char *GetItemInfo(unsigned int position, ItemDrawInfo *draw) =0;

 		/**

 		 * @brief Returns the number of items.

 		 *

 		 * @return				Number of items in the menu.

 		 */

 		virtual unsigned int GetItemCount() =0;

 		/** 

 		 * @brief Sets the menu's pagination,.

 		 *

 		 * If pagination is set to MENU_NO_PAGINATION, and the previous 

 		 * pagination was not MENU_NO_PAGINATION, then the MENUFLAG_BUTTON_EXIT 

 		 * is unset.  It can be re-applied if desired.

 		 *

 		 * @param itemsPerPage	Number of items per page, or MENU_NO_PAGINATION.

 		 * @return				True on success, false if itemsPerPage is too 

 		 *						large.

 		 */

 		virtual bool SetPagination(unsigned int itemsPerPage) =0;

 		/**

 		 * @brief Returns an item's pagination.

 		 *

 		 * @return				Pagination setting.

 		 */

 		virtual unsigned int GetPagination() =0;

 		/**

 		 * @brief Returns the menu style.

 		 * 

 		 * @return				Menu style.

 		 */

 		virtual IMenuStyle *GetDrawStyle() =0;

 		/**

 		 * @brief Sets the menu's display title/message.

 		 *

 		 * @param message		Message (format options allowed).

 		 */

 		virtual void SetDefaultTitle(const char *message) =0;

 		/**

 		 * @brief Returns the menu's display/title message.

 		 *

 		 * @return				Message string.

 		 */

 		virtual const char *GetDefaultTitle() =0;

 		/**

 		 * @brief Sets an extended menu option.

 		 *

 		 * @param option		Option type.

 		 * @param valuePtr		Pointer of the type expected by the option.

 		 * @return				True on success, false if option or value is not supported.

 		 */

 		virtual bool SetExtOption(MenuOption option, const void *valuePtr) =0;

 		/**

 		 * @brief Creates a new IMenuPanel object using extended options specific

 		 * to the IMenuStyle parent.  Titles, items, etc, are not copied.

 		 *

 		 * Note: The object should be freed with IMenuPanel::DeleteThis.

 		 *

 		 * @return				IMenuPanel pointer.

 		 */

 		virtual IMenuPanel *CreatePanel() =0;

 		/**

 		 * @brief Sends the menu to a client.

 		 *

 		 * @param client		Client index to display to.

 		 * @param time			Time to hold menu for.

 		 * @param alt_handler	Alternate IMenuHandler.

 		 * @return				True on success, false otherwise.

 		 */

 		virtual bool Display(int client, unsigned int time, IMenuHandler *alt_handler=NULL) =0;

 		/**

 		 * @brief Destroys the menu and frees all associated resources.

 		 *

 		 * @param releaseHandle	If true, the Handle will be released

 		 *						in the destructor.  This should be set

 		 *						to true except for IHandleTypeDispatch

 		 *						destructors.

 		 */

 		virtual void Destroy(bool releaseHandle=true) =0;

 		/**

 		 * @brief Cancels the menu on all client's displays.  While the menu is

 		 * being cancelled, the menu may not be re-displayed to any clients.

 		 * If a vote menu is currently active, it will be cancelled as well.

 		 *

 		 * @return				Number of menus cancelled.

 		 */

 		virtual void Cancel() =0;

 		/**

 		 * @brief Returns the menu's Handle.  The Handle is automatically

 		 * removed when the menu is destroyed.

 		 *

 		 * @return				Handle_t handle value.

 		 */

 		virtual Handle_t GetHandle() =0;

 		/**

 		 * @brief Returns menu option flags.

 		 *

 		 * @return				Menu option flags.

 		 */

 		virtual unsigned int GetMenuOptionFlags() =0;

 		/**

 		 * @brief Sets menu option flags.

 		 *

 		 * @param flags			Menu option flags.

 		 */

 		virtual void SetMenuOptionFlags(unsigned int flags) =0;

 		/**

 		 * @brief Returns the menu's handler.

 		 *

 		 * @return				IMenuHandler of the menu.

 		 */

 		virtual IMenuHandler *GetHandler() =0;

 		/**

 		 * @brief Sends the menu to a client, starting from the given item number. 

 		 *

 		 * Note: this API call was added in v13.

 		 *

 		 * @param client		Client index to display to.

 		 * @param time			Time to hold menu for.

 		 * @param start_item	Starting item to draw.

 		 * @param alt_handler	Alternate IMenuHandler.

 		 * @return				True on success, false otherwise.

 		 */

 		virtual bool DisplayAtItem(int client,

 			unsigned int time,

 			unsigned int start_item,

 			IMenuHandler *alt_handler=NULL) =0;

 		/**

 		 * @brief For the Handle system, returns approximate memory usage.

 		 *

 		 * @return				Approximate number of bytes being used.

 		 */

 		virtual unsigned int GetApproxMemUsage() =0;

 	};

 	/** 

 	 * @brief Contains callbacks for menu actions.

 	 */

 	class IMenuHandler

 	{

 	public:

 		/**

 		 * @brief Returns the menu api verison.

 		 *

 		 * @return				Menu API version.

 		 */

 		virtual unsigned int GetMenuAPIVersion2()

 		{

 			return SMINTERFACE_MENUMANAGER_VERSION;

 		}

 		/** 

 		 * @brief A display/selection cycle has started.

 		 *

 		 * @param menu			Menu pointer.

 		 */

 		virtual void OnMenuStart(IBaseMenu *menu)

 		{

 		}

 		/**

 		 * @brief Called before a menu is being displayed.  This is where

 		 * you can set an alternate title on the menu.

 		 *

 		 * @param menu			Menu pointer.

 		 * @param client		Client index.

 		 * @param display		IMenuPanel pointer.

 		 */

 		virtual void OnMenuDisplay(IBaseMenu *menu, int client, IMenuPanel *display)

 		{

 		}

 		/**

 		 * @brief Called when an item is selected.

 		 *

 		 * @param menu			Menu pointer.

 		 * @param client		Client that selected the item.

 		 * @param item			Item number.

 		 */

 		virtual void OnMenuSelect(IBaseMenu *menu, int client, unsigned int item)

 		{

 		}

 		/**

 		 * @brief An active menu display was dropped from a client.

 		 *

 		 * @param menu			Menu pointer.

 		 * @param client		Client that had the menu.

 		 * @param reason		Menu cancellation reason.

 		 */

 		virtual void OnMenuCancel(IBaseMenu *menu, int client, MenuCancelReason reason)

 		{

 		}

 		/**

 		 * @brief A display/selection cycle has ended.

 		 *

 		 * @param menu			Menu pointer.

 		 * @param reason		MenuEndReason reason.

 		 */

 		virtual void OnMenuEnd(IBaseMenu *menu, MenuEndReason reason)

 		{

 		}

 		/**

 		 * @brief Called when the menu object is destroyed.

 		 *

 		 * @param menu			Menu pointer.

 		 */

 		virtual void OnMenuDestroy(IBaseMenu *menu)

 		{

 		}

 		/**

 		 * @brief Called when requesting how to render an item.

 		 *

 		 * @param menu			Menu pointer.

 		 * @param client		Client index receiving the menu.

 		 * @param item			Item number in the menu.

 		 * @param style			ITEMSTYLE flags, by reference for modification.

 		 */

 		virtual void OnMenuDrawItem(IBaseMenu *menu, int client, unsigned int item, unsigned int &style)

 		{

 		}

 		/**

 		 * @brief Called when drawing item text.

 		 *

 		 * @param menu			Menu pointer.

 		 * @param client		Client index receiving the menu.

 		 * @param panel			Panel being used to draw the menu.

 		 * @param item			Item number in the menu.

 		 * @param dr			Item draw information.

 		 * @return				0 to let the render algorithm decide how to draw, otherwise,

 		 *						the return value from panel->DrawItem should be returned.

 		 */

 		virtual unsigned int OnMenuDisplayItem(IBaseMenu *menu, 

 											   int client, 

 											   IMenuPanel *panel,

 											   unsigned int item, 

 											   const ItemDrawInfo &dr)

 		{

 			return 0;

 		}

 		/**

 		 * @brief Called when a vote has been started and displayed to 

 		 * clients.  This is called after OnMenuStart() and OnMenuDisplay(),

 		 * but before OnMenuSelect().

 		 *

 		 * @param menu			Menu pointer.

 		 */

 		virtual void OnMenuVoteStart(IBaseMenu *menu)

 		{

 		}

 		/**

 		 * @brief Called when a vote ends.  This is automatically called by the 

 		 * wrapper, and never needs to called from a style implementation.  

 		 *

 		 * This function does not replace OnMenuEnd(), nor does it have the 

 		 * same meaning as OnMenuEnd(), meaning you should not destroy a menu

 		 * while it is in this function.

 		 *

 		 * @param menu			Menu pointer.

 		 * @param results		Menu vote results.

 		 */

 		virtual void OnMenuVoteResults(IBaseMenu *menu, const menu_vote_result_t *results)

 		{

 		}

 		/**

 		 * @brief Called when a vote is cancelled.  If this is called, then 

 		 * OnMenuVoteResults() will not be called.  In both cases, OnMenuEnd will 

 		 * always be called.

 		 *

 		 * @param menu			Menu pointer.

 		 * @param reason		VoteCancelReason reason.

 		 */

 		virtual void OnMenuVoteCancel(IBaseMenu *menu, VoteCancelReason reason)

 		{

 		}

 		/**

 		 * @brief Call to set private handler stuff.

 		 *

 		 * @param option		Option name.

 		 * @param data			Private data.

 		 * @return				True if set, false if invalid or unrecognized.

 		 */

 		virtual bool OnSetHandlerOption(const char *option, const void *data)

 		{

 			return false;

 		}

 		/**

 		 * @brief Called when an item is selected.

 		 *

 		 * Note: This callback was added in v13.  It is called after OnMenuSelect().

 		 *

 		 * @param menu			Menu pointer.

 		 * @param client		Client that selected the item.

 		 * @param item			Item number.

 		 * @param item_on_page	The first item on the page the player was last 

 		 *						viewing.

 		 */

 		virtual void OnMenuSelect2(IBaseMenu *menu,

 			int client,

 			unsigned int item,

 			unsigned int item_on_page)

 		{

 		}

 	};

 	/**

 	 * @brief Manages menu creation and displaying.

 	 */

 	class IMenuManager : public SMInterface

 	{

 	public:

 		virtual const char *GetInterfaceName()

 		{

 			return SMINTERFACE_MENUMANAGER_NAME;

 		}

 		virtual unsigned int GetInterfaceVersion()

 		{

 			return SMINTERFACE_MENUMANAGER_VERSION;

 		}

 		virtual bool IsVersionCompatible(unsigned int version)

 		{

 			if (version < 11 || version > GetInterfaceVersion())

 			{

 				return false;

 			}

 			return true;

 		}

 	public:

 		/**

 		 * @brief Finds a style by name.

 		 *

 		 * @param name			Name of the style (case insensitive).

 		 * @return				IMenuStyle pointer, or NULL if not found.

 		 */

 		virtual IMenuStyle *FindStyleByName(const char *name) =0;

 		/**

 		 * @brief Returns the default draw style Core is using.

 		 *

 		 * @return				Menu style pointer.

 		 */

 		virtual IMenuStyle *GetDefaultStyle() =0;

 		/**

 		 * @brief Given a set of menu states, converts it to an IMenuPanel object.

 		 *

 		 * The state parameter is both INPUT and OUTPUT.

 		 * INPUT: menu, mh, firstItem, lastItem

 		 * OUTPUT: display, firstItem, lastItem, slots

 		 *

 		 * @param client		Client index.

 		 * @param states		Menu states.

 		 * @param order			Order to search for items.

 		 * @return				IMenuPanel pointer, or NULL if no items could be 

 		 *						found in the IBaseMenu pointer, or NULL if any

 		 *						other error occurred.  Any valid pointer must

 		 *						be freed using IMenuPanel::DeleteThis.

 		 */

 		virtual IMenuPanel *RenderMenu(int client, menu_states_t &states, ItemOrder order) =0;

 		/**

 		 * @brief Cancels a menu.  Calls IBaseMenu::Cancel() after doing some preparatory 

 		 * work.  This should always be used instead of directly calling Cancel().

 		 *

 		 * @param menu			IBaseMenu pointer.

 		 */

 		virtual void CancelMenu(IBaseMenu *menu) =0;

 		/**

 		 * @brief Displays a menu as a vote.

 		 *

 		 * @param menu			IBaseMenu pointer.

 		 * @param num_clients	Number of clients to display to.

 		 * @param clients		Client index array.

 		 * @param max_time		Maximum time to hold menu for.

 		 * @param flags			Vote flags (currently unused).

 		 * @return				True on success, false if a vote is in progress.

 		 */

 		virtual bool StartVote(IBaseMenu *menu,

 								unsigned int num_clients,

 								int clients[],

 								unsigned int max_time,

 								unsigned int flags=0) =0;

 		/**

 		 * @brief Returns whether or not a vote is in progress.

 		 *

 		 * @return				True if a vote is in progress, false otherwise.

 		 */

 		virtual bool IsVoteInProgress() =0;

 		/**

 		 * @brief Cancels the vote in progress.  This calls IBaseMenu::Cancel().

 		 */

 		virtual void CancelVoting() =0;

 		/**

 		 * @brief Returns the remaining vote delay from the last menu.  This delay is 

 		 * a suggestion for all public votes, and is not enforced.

 		 *

 		 * @return				Number of seconds to wait.

 		 */

 		virtual unsigned int GetRemainingVoteDelay() =0;

 		/**

 		 * @brief Returns whether a client is in the "allowed to vote" pool determined 

 		 * by the initial call to StartVote().

 		 *

 		 * @param client		Client index.

 		 * @return				True if client is allowed to vote, false on failure.

 		 */

 		virtual bool IsClientInVotePool(int client) =0;

 		/**

 		 * @brief Redraws the current vote menu to a client in the voting pool.

 		 *

 		 * @param client		Client index.

 		 * @return				True on success, false if client is not allowed to vote.

 		 */

 		virtual bool RedrawClientVoteMenu(int client) =0;

 	};

 }

 #endif //_INCLUDE_SOURCEMOD_MENU_SYSTEM_H_