127 lines
4.2 KiB
C++
127 lines
4.2 KiB
C++
// Copyright (C) 2002-2007 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 IGUIFont;
|
|
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) {}
|
|
|
|
//! destructor
|
|
virtual ~IGUIListBox() {}
|
|
|
|
//! 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
|
|
//! returns 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;
|
|
|
|
//! set whether the listbox should scroll to show a newly selected item
|
|
//! or a new item as it is added to the list.
|
|
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 it's 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;
|
|
};
|
|
|
|
|
|
} // end namespace gui
|
|
} // end namespace irr
|
|
|
|
#endif
|
|
|