// 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 __I_GUI_LIST_BOX_H_INCLUDED__
#define __I_GUI_LIST_BOX_H_INCLUDED__

#include "IGUIElement.h"
#include "SColor.h"

namespace irr
{
namespace gui
{
	class IGUISpriteBank;

	//! Enumeration for listbox colors

	enum EGUI_LISTBOX_COLOR
	{
		//! Color of text

		EGUI_LBC_TEXT=0,
		//! Color of selected text

		EGUI_LBC_TEXT_HIGHLIGHT,
		//! Color of icon

		EGUI_LBC_ICON,
		//! Color of selected icon

		EGUI_LBC_ICON_HIGHLIGHT,
		//! Not used, just counts the number of available colors

		EGUI_LBC_COUNT
	};


	//! Default list box GUI element.

	class IGUIListBox : public IGUIElement
	{
	public:
		//! constructor

		IGUIListBox(IGUIEnvironment* environment, IGUIElement* parent, s32 id, core::rect<s32> rectangle)
			: IGUIElement(EGUIET_LIST_BOX, environment, parent, id, rectangle) {}

		//! returns amount of list items

		virtual u32 getItemCount() const = 0;

		//! returns string of a list item. the may id be a value from 0 to itemCount-1

		virtual const wchar_t* getListItem(u32 id) const = 0;

		//! adds an list item, returns id of item

		virtual u32 addItem(const wchar_t* text) = 0;

		//! adds an list item with an icon

		/** \param text Text of list entry
		\param icon Sprite index of the Icon within the current sprite bank. Set it to -1 if you want no icon
		\return The id of the new created item */
		virtual u32 addItem(const wchar_t* text, s32 icon) = 0;

		//! Removes an item from the list

		virtual void removeItem(u32 index) = 0;

		//! Returns the icon of an item

		virtual s32 getIcon(u32 index) const = 0;

		//! Sets the sprite bank which should be used to draw list icons.

		/** This font is set to the sprite bank of the built-in-font by
		default. A sprite can be displayed in front of every list item.
		An icon is an index within the icon sprite bank. Several
		default icons are available in the skin through getIcon. */
		virtual void setSpriteBank(IGUISpriteBank* bank) = 0;

		//! clears the list, deletes all items in the listbox

		virtual void clear() = 0;

		//! returns id of selected item. returns -1 if no item is selected.

		virtual s32 getSelected() const = 0;

		//! sets the selected item. Set this to -1 if no item should be selected

		virtual void setSelected(s32 index) = 0;

		//! sets the selected item. Set this to 0 if no item should be selected

		virtual void setSelected(const wchar_t *item) = 0;

		//! set whether the listbox should scroll to newly selected items

		virtual void setAutoScrollEnabled(bool scroll) = 0;

		//! returns true if automatic scrolling is enabled, false if not.

		virtual bool isAutoScrollEnabled() const = 0;

		//! set all item colors at given index to color

		virtual void setItemOverrideColor(u32 index, const video::SColor &color) = 0;

		//! set all item colors of specified type at given index to color

		virtual void setItemOverrideColor(u32 index, EGUI_LISTBOX_COLOR colorType, const video::SColor &color) = 0;

		//! clear all item colors at index

		virtual void clearItemOverrideColor(u32 index) = 0;

		//! clear item color at index for given colortype

		virtual void clearItemOverrideColor(u32 index, EGUI_LISTBOX_COLOR colorType) = 0;

		//! has the item at index its color overwritten?

		virtual bool hasItemOverrideColor(u32 index, EGUI_LISTBOX_COLOR colorType) const = 0;

		//! return the overwrite color at given item index.

		virtual video::SColor getItemOverrideColor(u32 index, EGUI_LISTBOX_COLOR colorType) const = 0;

		//! return the default color which is used for the given colorType

		virtual video::SColor getItemDefaultColor(EGUI_LISTBOX_COLOR colorType) const = 0;

		//! set the item at the given index

		virtual void setItem(u32 index, const wchar_t* text, s32 icon) = 0;

		//! Insert the item at the given index

		/** \return The index on success or -1 on failure. */
		virtual s32 insertItem(u32 index, const wchar_t* text, s32 icon) = 0;

		//! Swap the items at the given indices

		virtual void swapItems(u32 index1, u32 index2) = 0;

		//! set global itemHeight

		virtual void setItemHeight( s32 height ) = 0;

		//! Sets whether to draw the background

		virtual void setDrawBackground(bool draw) = 0;
};


} // end namespace gui

} // end namespace irr


#endif