Drop Down. More...

#include <CDropDown.h>

Inheritance diagram for CDropDown:

[legend]

Collaboration diagram for CDropDown:

[legend]

Public Member Functions
	CDropDown ()

virtual	~CDropDown ()

virtual void	HandleMessage (SGUIMessage &Message)

virtual InReaction	ManuallyHandleEvent (const SDL_Event_ *ev)
	Handle events manually to catch keyboard inputting. More...

virtual void	Draw ()
	Draws the Button. More...

virtual bool	MouseOver ()
	Checks if mouse is hovering this object. More...

virtual float	GetBufferedZ () const
	Returns not the Z value, but the actual buffered Z value, i.e. More...

Public Member Functions inherited from CList
	CList ()

virtual	~CList ()

virtual void	ResetStates ()

virtual void	AddItem (const CStrW &str, const CStrW &data)
	Adds an item last to the list. More...

Public Member Functions inherited from IGUIScrollBarOwner
	IGUIScrollBarOwner ()

virtual	~IGUIScrollBarOwner ()

virtual const SGUIScrollBarStyle *	GetScrollBarStyle (const CStr &style) const
	Interface for the m_ScrollBar to use. More...

virtual void	AddScrollBar (IGUIScrollBar *scrollbar)
	Add a scroll-bar. More...

virtual IGUIScrollBar &	GetScrollBar (const int &index)
	Get Scroll Bar reference (it should be transparent it's actually pointers). More...

virtual float	GetScrollBarPos (const int index) const
	Get the position of the scroll bar at. More...

Public Member Functions inherited from IGUIObject
	IGUIObject ()

virtual	~IGUIObject ()

const CStr &	GetName () const
	Get object name, name is unique. More...

void	SetName (const CStr &Name)
	Get object name. More...

CStr	GetPresentableName () const

void	AddToPointersMap (map_pObjects &ObjectMap)
	Adds object and its children to the map, it's name being the first part, and the second being itself. More...

void	AddChild (IGUIObject *pChild)
	Notice nothing will be returned or thrown if the child hasn't been inputted into the GUI yet. More...

vector_pObjects::iterator	begin ()

vector_pObjects::iterator	end ()

bool	SettingExists (const CStr &Setting) const
	Checks if settings exists, only available for derived classes that has this set up, that's why the base class just returns false. More...

PSRETURN	SetSetting (const CStr &Setting, const CStrW &Value, const bool &SkipMessage=false)
	Set a setting by string, regardless of what type it is. More...

PSRETURN	GetSettingType (const CStr &Setting, EGUISettingType &Type) const
	Retrieves the type of a named setting. More...

void	RegisterScriptHandler (const CStr &Action, const CStr &Code, CGUI *pGUI)
	Set the script handler for a particular object-specific action. More...

JSObject *	GetJSObject ()
	Retrieves the JSObject representing this GUI object. More...

CGUI *	GetGUI ()

const CGUI *	GetGUI () const

void	SetFocus ()
	Take focus! More...

Public Member Functions inherited from IGUITextOwner
	IGUITextOwner ()

virtual	~IGUITextOwner ()

void	AddText (SGUIText *text)
	Adds a text object. More...

virtual void	UpdateCachedSize ()

virtual void	DrawText (size_t index, const CColor &color, const CPos &pos, float z, const CRect &clipping=CRect())
	Draws the Text. More...

virtual bool	MouseOverIcon ()
	Test if mouse position is over an icon. More...

Protected Member Functions
void	SetupText ()
	Sets up text, should be called every time changes has been made that can change the visual. More...

virtual void	SetupListRect ()

virtual CRect	GetListRect () const

Protected Member Functions inherited from CList
virtual void	SelectNextElement ()
	Easy select elements functions. More...

virtual void	SelectPrevElement ()

virtual void	SelectFirstElement ()

virtual void	SelectLastElement ()

virtual bool	HandleAdditionalChildren (const XMBElement &child, CXeromyces *pFile)
	Handle the <item> tag. More...

void	UpdateAutoScroll ()

virtual void	DrawList (const int &selected, const CStr &_sprite, const CStr &_sprite_selected, const CStr &_textcolor)

virtual bool	GetModified () const

Protected Member Functions inherited from IGUIObject
void	AddSetting (const EGUISettingType &Type, const CStr &Name)
	Add a setting to m_Settings. More...

virtual void	Destroy ()
	Calls Destroy on all children, and deallocates all memory. More...

void	LoadStyle (CGUI &GUIinstance, const CStr &StyleName)
	Loads a style. More...

void	LoadStyle (const SGUIStyle &Style)
	Loads a style. More...

void	SetGUI (CGUI *const &pGUI)

void	SetParent (IGUIObject *pParent)
	Set parent of this object. More...

bool	IsFocused () const
	Check if object is focused. More...

IGUIObject *	GetParent () const
	NOTE! This will not just return m_pParent, when that is need use it! There is one exception to it, when the parent is the top-node (the object that isn't a real object), this will return NULL, so that the top-node's children are seemingly parentless. More...

CPos	GetMousePos () const
	Get Mouse from CGUI. More...

InReaction	SendEvent (EGUIMessageType type, const CStr &EventName)
	Send event to this GUI object (HandleMessage and ScriptEvent) More...

void	ScriptEvent (const CStr &Action)
	Execute the script for a particular action. More...

void	ScriptEvent (const CStr &Action, JS::HandleValue Argument)
	Execute the script for a particular action. More...

void	SetScriptHandler (const CStr &Action, JS::HandleObject Function)

void	UpdateMouseOver (IGUIObject *const &pMouseOver)
	Inputes the object that is currently hovered, this function updates this object accordingly (i.e. More...

Protected Member Functions inherited from IGUITextOwner
void	CalculateTextPosition (CRect &ObjSize, CPos &TextPos, SGUIText &Text)
	Calculate the position for the text, based on the alignment. More...

Protected Attributes
CPos	m_TextPos
	Placement of text. More...

bool	m_Open

CRect	m_CachedListRect

bool	m_HideScrollBar

int	m_ElementHighlight

std::string	m_InputBuffer

double	m_TimeOfLastInput

Protected Attributes inherited from CList
std::vector< float >	m_ItemsYPositions
	List of each element's relative y position. More...

Protected Attributes inherited from IGUIScrollBarOwner
std::vector< IGUIScrollBar * >	m_ScrollBars
	Predominately you will only have one, but you can have as many as you like. More...

Protected Attributes inherited from IGUIObject
CRect	m_CachedActualSize
	Cached size, real size m_Size is actually dependent on resolution and can have different real outcomes, this is the real outcome cached to avoid slow calculations in real time. More...

CStr	m_Name

vector_pObjects	m_Children

IGUIObject *	m_pParent

double	m_LastClickTime [6]

bool	m_MouseHovering
	This is an array of true or false, each element is associated with a string representing a setting. More...

Protected Attributes inherited from IGUITextOwner
bool	m_GeneratedTextsValid
	Whether the cached text is currently valid (if not then SetupText will be called by Draw) More...

std::vector< SGUIText * >	m_GeneratedTexts
	Texts that are generated and ready to be rendered. More...

Additional Inherited Members
Public Attributes inherited from IGUIObject
std::map< CStr, SGUISetting >	m_Settings
	Settings pool, all an object's settings are located here If a derived object has got more settings that the base settings, it's because they have a new version of the function SetupSettings(). More...

Detailed Description

Drop Down.

The control can be pressed, but we will not inherent this behavior from IGUIButtonBehavior, because when you press this control, the list with elements will immediately appear, and not first after release (which is the whole gist of the IGUIButtonBehavior).

Constructor & Destructor Documentation

CDropDown::CDropDown ( )

CDropDown::~CDropDown ( )

virtual

Member Function Documentation

void CDropDown::Draw ( )

virtual

Draws the Button.

Reimplemented from CList.

float CDropDown::GetBufferedZ ( ) const

virtual

Returns not the Z value, but the actual buffered Z value, i.e.

if it's defined relative, then it will check its parent's Z value and add the relativity.

Returns: Actual Z value on the screen.

Reimplemented from IGUIObject.

CRect CDropDown::GetListRect ( ) const

protectedvirtual

Reimplemented from CList.

void CDropDown::HandleMessage ( SGUIMessage & Message )

virtual

See also: IGUIObject::HandleMessage()

Reimplemented from CList.

InReaction CDropDown::ManuallyHandleEvent ( const SDL_Event_ * ev )

virtual

Handle events manually to catch keyboard inputting.

Reimplemented from CList.

bool CDropDown::MouseOver ( )

virtual

Checks if mouse is hovering this object.

The mouse position is cached in CGUI.

This function checks if the mouse is hovering the rectangle that the base setting "size" makes. Although it is virtual, so one could derive an object from CButton, which changes only this to checking the circle that "size" makes.

Returns: true if mouse is hovering

Reimplemented from IGUIObject.

void CDropDown::SetupListRect ( )

protectedvirtual

void CDropDown::SetupText ( )

protectedvirtual

Sets up text, should be called every time changes has been made that can change the visual.

Reimplemented from CList.

Member Data Documentation

CRect CDropDown::m_CachedListRect

protected

int CDropDown::m_ElementHighlight

protected

bool CDropDown::m_HideScrollBar

protected

std::string CDropDown::m_InputBuffer

protected

bool CDropDown::m_Open

protected

CPos CDropDown::m_TextPos

protected

Placement of text.

double CDropDown::m_TimeOfLastInput

protected

The documentation for this class was generated from the following files:

/var/svn/checkout/source/gui/CDropDown.h
/var/svn/checkout/source/gui/CDropDown.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation