---

os::DropdownMenu Class Reference

Edit box with an asociated item-menu. More...

#include <dropdownmenu.h>

Inheritance diagram for os::DropdownMenu:

List of all members.

Public Methods
	DropdownMenu (const Rect &cFrame, const char *pzName, uint32 nResizeMask=CF_FOLLOW_LEFT|CF_FOLLOW_TOP, uint32 nFlags=WID_WILL_DRAW|WID_FULL_UPDATE_ON_RESIZE)
	DropdownMenu constructor. More...
	~DropdownMenu ()
void	SetEnable (bool bEnable=true)
bool	IsEnabled () const
void	SetReadOnly (bool bFlag=true)
	Change the "read-only" status. More...
bool	GetReadOnly () const
	Returns the read-only status. More...
void	AppendItem (const char *pzString)
	Add a item to the end of the drop down list. More...
void	InsertItem (int nPosition, const char *pzString)
	Insert and item at a given position. More...
bool	DeleteItem (int nPosition)
	Delete a item. More...
int	GetItemCount () const
	Get the item count. More...
void	Clear ()
	Delete all items. More...
const std::string&	GetItem (int nItem) const
	Get one of the item strings. More...
int	GetSelection () const
	Get the current selection. More...
void	SetSelection (int nItem, bool bNotify=true)
	Set current selection. More...
const std::string&	GetCurrentString () const
void	SetCurrentString (const std::string &cString)
void	SetMinPreferredSize (int nWidthChars)
int	GetMinPreferredSize () const
void	SetMaxPreferredSize (int nWidthChars)
int	GetMaxPreferredSize () const
void	SetSelectionMessage (Message *pcMsg)
	Set the message that will be sendt when the selection changes. More...
Message*	GetSelectionMessage () const
	Get a pointer to the current "SelectionChanged" message. More...
void	SetSendIntermediateMsg (bool bFlag)
bool	GetSendIntermediateMsg () const
void	SetEditMessage (Message *pcMsg)
	Set the message sendt when the user changes the content of the edit box. More...
Message*	GetEditMessage () const
	Get a pointer to the current "SelectionChanged" message. More...
virtual void	HandleMessage (Message *pcMessage)
	Handle events from sub components. More...
virtual void	Paint (const Rect &cUpdateRect)
	Called by the system update "damaged" areas of the view. More...
virtual Point	GetPreferredSize (bool bLargest) const
virtual void	FrameSized (const Point &cDelta)
virtual void	MouseDown (const Point &cPosition, uint32 nButtons)
virtual void	KeyDown (const char *pzString, const char *pzRawString, uint32 nQualifiers)
virtual void	AllAttached ()
Friends
class	DropdownView

---

Detailed Description

Edit box with an asociated item-menu.

Description:

See also:

TextView, Invoker

Author(s):

Kurt Skauen (kurt@atheos.cx)

---

Constructor & Destructor Documentation

DropdownMenu::DropdownMenu ( const Rect & cFrame, const char * pzName, uint32 nResizeMask = CF_FOLLOW_LEFT | CF_FOLLOW_TOP, uint32 nFlags = WID_WILL_DRAW | WID_FULL_UPDATE_ON_RESIZE )

DropdownMenu constructor. Parameters: cFrame   - The size and position of the edit box and it's associated button. pzName   - The identifier passed down to the Handler class (Never rendered) nResizeMask   - Flags deskribing which edge follows edges of the parent when the parent is resized (Se View::View()) nFlags   - Various flags passed to the View::View() constructor. See also: os::View, os::Invoker Author(s): Kurt Skauen (kurt@atheos.cx)

DropdownMenu::~DropdownMenu ( )

---

Member Function Documentation

void DropdownMenu::AllAttached ( void ) [virtual]

Reimplemented from os::View.

void DropdownMenu::AppendItem ( const char * pzString )

Add a item to the end of the drop down list. Parameters: pzString   - The string to be appended See also: InsertItem(), DeleteItem(), GetItemCount(), GetItem() Author(s): Kurt Skauen (kurt@atheos.cx)

void DropdownMenu::Clear ( )

Delete all items. Description: Delete all the items in the menu Parameters: nPosition   - The zero based index of the item to delete. Returns: true if an item was deleted, false if the index was out of range. See also: AppendItem(), InsertItem(), GetItemCount(), GetItem() Author(s): Kurt Skauen (kurt@atheos.cx)

bool DropdownMenu::DeleteItem ( int nPosition )

Delete a item. Description: Delete the item at the given position Parameters: nPosition   - The zero based index of the item to delete. Returns: true if an item was deleted, false if the index was out of range. See also: AppendItem(), InsertItem(), GetItemCount(), GetItem() Author(s): Kurt Skauen (kurt@atheos.cx)

void DropdownMenu::FrameSized ( const Point & cDelta ) [virtual]

Reimplemented from os::View.

const std::string & DropdownMenu::GetCurrentString ( ) const

Message * DropdownMenu::GetEditMessage ( ) const

Get a pointer to the current "SelectionChanged" message. Description: Return the pointer last set by SetEditMessage() or NULL if no message is assigned. If you change the message the changes will be reflected in the following events sendt when the edit box is changed. Note: The message is still owned by the DropdownMenu. You should not delete is Returns: Pointer to the internel "string-changed" message. See also: SetSelectionMessage(), Invoker::SetTarget() Author(s): Kurt Skauen (kurt@atheos.cx)

const std::string & DropdownMenu::GetItem ( int nItem ) const

Get one of the item strings. Description: Returns one of the items encapsulated in a stl string. Parameters: nItem   - Zero based index of the item to return. Returns: const reference to an stl string containing the item string See also: GetItemCount(), AppendItem(), InsertItem(), DeleteItem() Author(s): Kurt Skauen (kurt@atheos.cx)

int DropdownMenu::GetItemCount ( ) const

Get the item count. Returns: The number of items in the menu See also: GetItem(), AppendItem(), InsertItem(), DeleteItem() Author(s): Kurt Skauen (kurt@atheos.cx)

int DropdownMenu::GetMaxPreferredSize ( ) const

int DropdownMenu::GetMinPreferredSize ( ) const

Point DropdownMenu::GetPreferredSize ( bool bLargest ) const [virtual]

Reimplemented from os::View.

bool DropdownMenu::GetReadOnly ( ) const

Returns the read-only status. Returns: true if read only, false if read/write. See also: SetReadOnly() Author(s): Kurt Skauen (kurt@atheos.cx)

int DropdownMenu::GetSelection ( ) const

Get the current selection. Returns: The index of the selected item, or -1 if no item is selected. See also: SetSelection(), SetSelectionMessage() Author(s): Kurt Skauen (kurt@atheos.cx)

Message * DropdownMenu::GetSelectionMessage ( ) const

Get a pointer to the current "SelectionChanged" message. Description: Return the pointer last set by SetSelectionMessage() or NULL if no message is assigned. If you change the message the changes will be reflected in the following "SelectionChanged" events. Note: The message is still owned by the DropdownMenu. You should not delete it. Returns: Pointer to the internel "SelectionChanged" message. See also: SetSelectionMessage(), Invoker::SetTarget() Author(s): Kurt Skauen (kurt@atheos.cx)

bool DropdownMenu::GetSendIntermediateMsg ( ) const

void DropdownMenu::HandleMessage ( Message * pcMessage ) [virtual]

Handle events from sub components. Description: DropdownMenu overloads Handler::HandleMessage() to be able to comunicate with it's sub components. See also: Handler::HandleMessage() Author(s): Kurt Skauen (kurt@atheos.cx) Reimplemented from os::Handler.

void DropdownMenu::InsertItem ( int nPosition, const char * pzString )

Insert and item at a given position. \Description: The new item is inserted before the nPosition'th item. Parameters: nPosition   - Zero based index of the item to insert the string in front of pzString   - The string to be insert See also: AppendItem(), DeleteItem(), GetItemCount(), GetItem() Author(s): Kurt Skauen (kurt@atheos.cx)

bool DropdownMenu::IsEnabled ( ) const

void DropdownMenu::KeyDown ( const char * pzString, const char * pzRawString, uint32 nQualifiers ) [virtual]

Reimplemented from os::View.

void DropdownMenu::MouseDown ( const Point & cPosition, uint32 nButton ) [virtual]

Reimplemented from os::View.

void DropdownMenu::Paint ( const Rect & cUpdateRect ) [virtual]

Called by the system update "damaged" areas of the view. Description: Note: Warning: Parameters: cUpdateRect   A rectangle enclosing all damaged areas. This is just a rough "worst-case", further fine-grained clipping will be performed by the Application Server to avoid updating non-damaged pixels and make the update as fast and flicker-free as possible. See also: Invalidate(), Flush() Author(s): Kurt Skauen (kurt@atheos.cx) Reimplemented from os::View.

void DropdownMenu::SetCurrentString ( const std::string & cString )

void DropdownMenu::SetEditMessage ( Message * pcMsg )

Set the message sendt when the user changes the content of the edit box. Description: The message is sendt everytime the user changes the content of the edit box. Before the message is sendt a boolean member called "final" is added. This member is false when the user is typing into the edit box, and true for the last message sendt when the user hits <ENTER>. The content of the edit box is not automatically copyed into the item-list. If you f.eks. want to add a new entry to the item list each time the user change the string and hits <ENTER>, you must listen to this message and read out the string with GetCurrentString() and add it to the list with AppendItem() or InsertItem() each time you receive a message with the "final" member equal "true". Note: The DropdownMenu overtake the ownership of the message. You should not delete or reference the message after SetSelectionMessage() returns. Parameters: pcMsg   - The message to be sendt when the edit box changes. See also: GetEditMessage(), SetSelectionMessage(), Invoker::SetTarget(), Invoker::Invoke() Author(s): Kurt Skauen (kurt@atheos.cx)

void DropdownMenu::SetEnable ( bool bEnable = true )

void DropdownMenu::SetMaxPreferredSize ( int nWidthChars )

void DropdownMenu::SetMinPreferredSize ( int nWidthChars )

void DropdownMenu::SetReadOnly ( bool bFlag = true )

Change the "read-only" status. Description: When the DropdownMenu is set in read-only mode the user will not be able to edit the contents of the edit box. It will also make the menu open when the user click inside the edit box. Parameters: bFlag   - Is true the menu will be read-only, if false it will be read/write. See also: GetReadOnly() Author(s): Kurt Skauen (kurt@atheos.cx)

void DropdownMenu::SetSelection ( int nItem, bool bNotify = true )

Set current selection. Description: The given item will be highlighted when the menu is opened and the item will be copyed into the edit box. If the bNotify parameter is true and the selection differs from the currend the "SelectionMessage" (see SetSelectionMessage()) will be sendt to the target set by SetTarget(). Parameters: nItem   - The new selection bNotify   - If true a notification will be sendt if the new selection differ from the current. See also: GetSelection(), SetSelectionMessage(), GetSelectionMessage(), Invoker::SetTarget() Author(s): Kurt Skauen (kurt@atheos.cx)

void DropdownMenu::SetSelectionMessage ( Message * pcMsg )

Set the message that will be sendt when the selection changes. Description: When the selection is changed eighter by the user or by calling SetSelection() with bNotify = true, the DropdownMenu() will clone off the message set with SetSelectionMessage() and send it to it's target by calling Invoker::Invoke(). Before sending the message the two fields "final" and "selection" are added. "final" is a boolean that is true when the user select (click's on) an item from the menu, or if the event was triggered by SetSelection(). "final" is false when the event was triggered by the user moving the mouse over the menu. "selection" is an int32 that contain the new selection. In addition to those fields comes the fields added by Invoker::Invoke(). If pcMsg is NULL no event will be triggered by changing the selection. Note: The DropdownMenu overtake the ownership of the message. You should not delete or reference the message after SetSelectionMessage() returns. Parameters: pcMsg   - The message to be sendt when selection changes. See also: GetSelectionMessage(), SetEditMessage(), Invoker::SetTarget() Author(s): Kurt Skauen (kurt@atheos.cx)

void DropdownMenu::SetSendIntermediateMsg ( bool bFlag )

---

Friends And Related Function Documentation

class DropdownView [friend]

---

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

• dropdownmenu.h
• dropdownmenu.cpp

---