Main Page   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members

FX::FXComboBox Class Reference

A Combo Box provides a way to select a string from a list of strings. More...

#include <FXComboBox.h>

Inheritance diagram for FX::FXComboBox:

FX::FXPacker FX::FXComposite FX::FXWindow FX::FXDrawable FX::FXId FX::FXObject

List of all members.

Public Member Functions

 FXComboBox (FXComposite *p, FXint cols, FXObject *tgt=NULL, FXSelector sel=0, FXuint opts=COMBOBOX_NORMAL, FXint x=0, FXint y=0, FXint w=0, FXint h=0, FXint pl=DEFAULT_PAD, FXint pr=DEFAULT_PAD, FXint pt=DEFAULT_PAD, FXint pb=DEFAULT_PAD)
virtual void create ()
virtual void detach ()
virtual void destroy ()
virtual void enable ()
virtual void disable ()
virtual FXint getDefaultWidth ()
virtual FXint getDefaultHeight ()
virtual void layout ()
FXbool isEditable () const
void setEditable (FXbool edit=true)
void setText (const FXString &text, FXbool notify=false)
FXString getText () const
void setNumColumns (FXint cols)
FXint getNumColumns () const
void setJustify (FXuint mode)
FXuint getJustify () const
FXint getNumItems () const
FXint getNumVisible () const
void setNumVisible (FXint nvis)
FXbool isItemCurrent (FXint index) const
void setCurrentItem (FXint index, FXbool notify=false)
FXint getCurrentItem () const
FXString getItem (FXint index) const
FXint setItem (FXint index, const FXString &text, void *ptr=NULL, FXbool notify=false)
FXint fillItems (const FXchar **strings, FXbool notify=false)
FXint fillItems (const FXString &strings, FXbool notify=false)
FXint insertItem (FXint index, const FXString &text, void *ptr=NULL, FXbool notify=false)
FXint appendItem (const FXString &text, void *ptr=NULL, FXbool notify=false)
FXint prependItem (const FXString &text, void *ptr=NULL, FXbool notify=false)
FXint moveItem (FXint newindex, FXint oldindex, FXbool notify=false)
void removeItem (FXint index, FXbool notify=false)
void clearItems (FXbool notify=false)
FXint findItem (const FXString &text, FXint start=-1, FXuint flags=SEARCH_FORWARD|SEARCH_WRAP) const
FXint findItemByData (const void *ptr, FXint start=-1, FXuint flags=SEARCH_FORWARD|SEARCH_WRAP) const
void setItemText (FXint index, const FXString &text)
FXString getItemText (FXint index) const
void setItemData (FXint index, void *ptr) const
void * getItemData (FXint index) const
void showMenu (FXbool shw)
FXbool isMenuShown () const
void sortItems ()
void setFont (FXFont *fnt)
FXFontgetFont () const
void setComboStyle (FXuint mode)
FXuint getComboStyle () const
void setShrinkWrap (FXbool flag)
FXbool getShrinkWrap () const
virtual void setBackColor (FXColor clr)
FXColor getBackColor () const
void setTextColor (FXColor clr)
FXColor getTextColor () const
void setSelBackColor (FXColor clr)
FXColor getSelBackColor () const
void setSelTextColor (FXColor clr)
FXColor getSelTextColor () const
FXListSortFunc getSortFunc () const
void setSortFunc (FXListSortFunc func)
void setHelpText (const FXString &txt)
const FXStringgetHelpText () const
void setTipText (const FXString &txt)
const FXStringgetTipText () const
virtual void save (FXStream &store) const
virtual void load (FXStream &store)
virtual ~FXComboBox ()


Detailed Description

A Combo Box provides a way to select a string from a list of strings.

Unless COMBOBOX_STATIC is passed, it also allows the user to enter a new string into the text field, for example if the desired entry is not in the list of strings. Passing COMBOBOX_REPLACE, COMBOBOX_INSERT_BEFORE, COMBOBOX_INSERT_AFTER, COMBOBOX_INSERT_FIRST, or COMBOBOX_INSERT_LAST causes a newly entered text to replace the current one in the list, or be added before or after the current entry, or to be added at the beginning or end of the list. Combo Box is intended to enter text; if you need to enter a choice from a list of options, it is recommended that the List Box widget is used instead. When the text in the field is changed, a SEL_COMMAND will be send to the target. The Combo Box can also receive ID_GETSTRINGVALUE and ID_SETSTRINGVALUE and so on, which will behave similar to Text Field in that they will retrieve or update the value of the field.

See also:


Constructor & Destructor Documentation

FX::FXComboBox::FXComboBox ( FXComposite p,
FXint  cols,
FXObject tgt = NULL,
FXSelector  sel = 0,
FXuint  opts = COMBOBOX_NORMAL,
FXint  x = 0,
FXint  y = 0,
FXint  w = 0,
FXint  h = 0,
FXint  pl = DEFAULT_PAD,
FXint  pr = DEFAULT_PAD,
FXint  pt = DEFAULT_PAD,
FXint  pb = DEFAULT_PAD 
)

Construct a Combo Box widget with room to display cols columns of text.

virtual FX::FXComboBox::~FXComboBox (  )  [virtual]

Destructor.


Member Function Documentation

virtual void FX::FXComboBox::create (  )  [virtual]

Create server-side resources.

Reimplemented from FX::FXComposite.

virtual void FX::FXComboBox::detach (  )  [virtual]

Detach server-side resources.

Reimplemented from FX::FXComposite.

virtual void FX::FXComboBox::destroy (  )  [virtual]

Destroy server-side resources.

Reimplemented from FX::FXComposite.

virtual void FX::FXComboBox::enable (  )  [virtual]

Enable combo box.

Reimplemented from FX::FXWindow.

virtual void FX::FXComboBox::disable (  )  [virtual]

Disable combo box.

Reimplemented from FX::FXWindow.

virtual FXint FX::FXComboBox::getDefaultWidth (  )  [virtual]

Return default width.

Reimplemented from FX::FXPacker.

virtual FXint FX::FXComboBox::getDefaultHeight (  )  [virtual]

Return default height.

Reimplemented from FX::FXPacker.

virtual void FX::FXComboBox::layout (  )  [virtual]

Perform layout.

Reimplemented from FX::FXPacker.

FXbool FX::FXComboBox::isEditable (  )  const

Return true if combobox is editable.

void FX::FXComboBox::setEditable ( FXbool  edit = true  ) 

Set editable state.

void FX::FXComboBox::setText ( const FXString text,
FXbool  notify = false 
)

Set the text; selects the matching item.

FXString FX::FXComboBox::getText (  )  const

Get the text.

void FX::FXComboBox::setNumColumns ( FXint  cols  ) 

Set the number of columns.

FXint FX::FXComboBox::getNumColumns (  )  const

Get the number of columns.

void FX::FXComboBox::setJustify ( FXuint  mode  ) 

Change text justification mode; default is JUSTIFY_LEFT.

FXuint FX::FXComboBox::getJustify (  )  const

Return text justification mode.

FXint FX::FXComboBox::getNumItems (  )  const

Return the number of items in the list.

FXint FX::FXComboBox::getNumVisible (  )  const

Return the number of visible items.

void FX::FXComboBox::setNumVisible ( FXint  nvis  ) 

Set the number of visible items in the drop down list.

FXbool FX::FXComboBox::isItemCurrent ( FXint  index  )  const

Return true if current item.

void FX::FXComboBox::setCurrentItem ( FXint  index,
FXbool  notify = false 
)

Set the current item (index is zero-based).

FXint FX::FXComboBox::getCurrentItem (  )  const

Get the current item's index.

FXString FX::FXComboBox::getItem ( FXint  index  )  const

Return the item at the given index.

FXint FX::FXComboBox::setItem ( FXint  index,
const FXString text,
void *  ptr = NULL,
FXbool  notify = false 
)

Replace the item at index.

FXint FX::FXComboBox::fillItems ( const FXchar **  strings,
FXbool  notify = false 
)

Fill combo box by appending items from array of strings.

FXint FX::FXComboBox::fillItems ( const FXString strings,
FXbool  notify = false 
)

Fill combo box by appending items from newline separated strings.

FXint FX::FXComboBox::insertItem ( FXint  index,
const FXString text,
void *  ptr = NULL,
FXbool  notify = false 
)

Insert a new item at index.

FXint FX::FXComboBox::appendItem ( const FXString text,
void *  ptr = NULL,
FXbool  notify = false 
)

Append an item to the list.

FXint FX::FXComboBox::prependItem ( const FXString text,
void *  ptr = NULL,
FXbool  notify = false 
)

Prepend an item to the list.

FXint FX::FXComboBox::moveItem ( FXint  newindex,
FXint  oldindex,
FXbool  notify = false 
)

Move item from oldindex to newindex.

void FX::FXComboBox::removeItem ( FXint  index,
FXbool  notify = false 
)

Remove this item from the list.

void FX::FXComboBox::clearItems ( FXbool  notify = false  ) 

Remove all items from the list.

FXint FX::FXComboBox::findItem ( const FXString text,
FXint  start = -1,
FXuint  flags = SEARCH_FORWARD|SEARCH_WRAP 
) const

Search items by name, beginning from item start.

If the start item is -1 the search will start at the first item in the list. Flags may be SEARCH_FORWARD or SEARCH_BACKWARD to control the search direction; this can be combined with SEARCH_NOWRAP or SEARCH_WRAP to control whether the search wraps at the start or end of the list. The option SEARCH_IGNORECASE causes a case-insensitive match. Finally, passing SEARCH_PREFIX causes searching for a prefix of the item name. Return -1 if no matching item is found.

FXint FX::FXComboBox::findItemByData ( const void *  ptr,
FXint  start = -1,
FXuint  flags = SEARCH_FORWARD|SEARCH_WRAP 
) const

Search items by associated user data, beginning from item start.

If the start item is -1 the search will start at the first item in the list. Flags may be SEARCH_FORWARD or SEARCH_BACKWARD to control the search direction; this can be combined with SEARCH_NOWRAP or SEARCH_WRAP to control whether the search wraps at the start or end of the list.

void FX::FXComboBox::setItemText ( FXint  index,
const FXString text 
)

Set text for specified item.

FXString FX::FXComboBox::getItemText ( FXint  index  )  const

Get text for specified item.

void FX::FXComboBox::setItemData ( FXint  index,
void *  ptr 
) const

Set data pointer for specified item.

void* FX::FXComboBox::getItemData ( FXint  index  )  const

Get data pointer for specified item.

void FX::FXComboBox::showMenu ( FXbool  shw  ) 

Show or hide menu.

FXbool FX::FXComboBox::isMenuShown (  )  const

Is the menu pane shown.

void FX::FXComboBox::sortItems (  ) 

Sort items using current sort function.

void FX::FXComboBox::setFont ( FXFont fnt  ) 

Set text font.

FXFont* FX::FXComboBox::getFont (  )  const

Get text font.

void FX::FXComboBox::setComboStyle ( FXuint  mode  ) 

Set the combobox style.

FXuint FX::FXComboBox::getComboStyle (  )  const

Get the combobox style.

void FX::FXComboBox::setShrinkWrap ( FXbool  flag  ) 

Change popup pane shrinkwrap mode.

FXbool FX::FXComboBox::getShrinkWrap (  )  const

Return popup pane shrinkwrap mode.

virtual void FX::FXComboBox::setBackColor ( FXColor  clr  )  [virtual]

Set window background color.

Reimplemented from FX::FXWindow.

FXColor FX::FXComboBox::getBackColor (  )  const

Get background color.

Reimplemented from FX::FXWindow.

void FX::FXComboBox::setTextColor ( FXColor  clr  ) 

Change text color.

FXColor FX::FXComboBox::getTextColor (  )  const

Return text color.

void FX::FXComboBox::setSelBackColor ( FXColor  clr  ) 

Change selected background color.

FXColor FX::FXComboBox::getSelBackColor (  )  const

Return selected background color.

void FX::FXComboBox::setSelTextColor ( FXColor  clr  ) 

Change selected text color.

FXColor FX::FXComboBox::getSelTextColor (  )  const

Return selected text color.

FXListSortFunc FX::FXComboBox::getSortFunc (  )  const

Return sort function.

void FX::FXComboBox::setSortFunc ( FXListSortFunc  func  ) 

Change sort function.

void FX::FXComboBox::setHelpText ( const FXString txt  ) 

Set the combobox help text.

const FXString& FX::FXComboBox::getHelpText (  )  const

Get the combobox help text.

void FX::FXComboBox::setTipText ( const FXString txt  ) 

Set the tool tip message for this combobox.

const FXString& FX::FXComboBox::getTipText (  )  const

Get the tool tip message for this combobox.

virtual void FX::FXComboBox::save ( FXStream store  )  const [virtual]

Save combobox to a stream.

Reimplemented from FX::FXPacker.

virtual void FX::FXComboBox::load ( FXStream store  )  [virtual]

Load combobox from a stream.

Reimplemented from FX::FXPacker.

Copyright © 1997-2009 Jeroen van der Zijp