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

FX::FXComboBox Class Reference

#include <FXComboBox.h>

Inheritance diagram for FX::FXComboBox:
FX::FXPacker FX::FXComposite FX::FXWindow FX::FXDrawable FX::FXId FX::FXObject

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)
 
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)
 
FXint fillItems (const FXchar **strings)
 
FXint fillItems (const FXString &strings)
 
FXint insertItem (FXint index, const FXString &text, void *ptr=NULL)
 
FXint appendItem (const FXString &text, void *ptr=NULL)
 
FXint prependItem (const FXString &text, void *ptr=NULL)
 
FXint moveItem (FXint newindex, FXint oldindex)
 
void removeItem (FXint index)
 
void clearItems ()
 
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
 
FXbool isPaneShown () const
 
void sortItems ()
 
void setFont (FXFont *fnt)
 
FXFontgetFont () const
 
void setComboStyle (FXuint mode)
 
FXuint getComboStyle () 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 ()
 
- Public Member Functions inherited from FX::FXPacker
 FXPacker (FXComposite *p, FXuint opts=0, FXint x=0, FXint y=0, FXint w=0, FXint h=0, FXint pl=DEFAULT_SPACING, FXint pr=DEFAULT_SPACING, FXint pt=DEFAULT_SPACING, FXint pb=DEFAULT_SPACING, FXint hs=DEFAULT_SPACING, FXint vs=DEFAULT_SPACING)
 
void setFrameStyle (FXuint style)
 
FXuint getFrameStyle () const
 
void setPackingHints (FXuint ph)
 
FXuint getPackingHints () const
 
FXint getBorderWidth () const
 
void setPadTop (FXint pt)
 
FXint getPadTop () const
 
void setPadBottom (FXint pb)
 
FXint getPadBottom () const
 
void setPadLeft (FXint pl)
 
FXint getPadLeft () const
 
void setPadRight (FXint pr)
 
FXint getPadRight () const
 
void setHiliteColor (FXColor clr)
 
FXColor getHiliteColor () const
 
void setShadowColor (FXColor clr)
 
FXColor getShadowColor () const
 
void setBorderColor (FXColor clr)
 
FXColor getBorderColor () const
 
void setBaseColor (FXColor clr)
 
FXColor getBaseColor () const
 
void setHSpacing (FXint hs)
 
FXint getHSpacing () const
 
void setVSpacing (FXint vs)
 
FXint getVSpacing () const
 
- Public Member Functions inherited from FX::FXComposite
 FXComposite (FXComposite *p, FXuint opts=0, FXint x=0, FXint y=0, FXint w=0, FXint h=0)
 
FXint maxChildWidth () const
 
FXint maxChildHeight () const
 
virtual bool isComposite () const
 
virtual ~FXComposite ()
 
- Public Member Functions inherited from FX::FXWindow
 FXWindow (FXComposite *p, FXuint opts=0, FXint x=0, FXint y=0, FXint w=0, FXint h=0)
 
FXWindowgetParent () const
 
FXWindowgetOwner () const
 
FXWindowgetShell () const
 
FXWindowgetRoot () const
 
FXWindowgetNext () const
 
FXWindowgetPrev () const
 
FXWindowgetFirst () const
 
FXWindowgetLast () const
 
FXWindowgetFocus () const
 
void setKey (FXuint k)
 
FXuint getKey () const
 
void setTarget (FXObject *t)
 
FXObjectgetTarget () const
 
void setSelector (FXSelector sel)
 
FXSelector getSelector () const
 
FXint getX () const
 
FXint getY () const
 
virtual FXint getWidthForHeight (FXint givenheight)
 
virtual FXint getHeightForWidth (FXint givenwidth)
 
void setX (FXint x)
 
void setY (FXint y)
 
void setWidth (FXint w)
 
void setHeight (FXint h)
 
void setLayoutHints (FXuint lout)
 
FXuint getLayoutHints () const
 
FXAccelTablegetAccelTable () const
 
void setAccelTable (FXAccelTable *acceltable)
 
void addHotKey (FXHotKey code)
 
void remHotKey (FXHotKey code)
 
void setHelpTag (const FXString &text)
 
const FXStringgetHelpTag () const
 
bool isShell () const
 
bool isOwnerOf (const FXWindow *window) const
 
bool isChildOf (const FXWindow *window) const
 
bool containsChild (const FXWindow *child) const
 
FXWindowgetChildAt (FXint x, FXint y) const
 
FXint numChildren () const
 
FXint indexOfChild (const FXWindow *window) const
 
FXWindowchildAtIndex (FXint index) const
 
FXComposeContextgetComposeContext () const
 
void createComposeContext ()
 
void destroyComposeContext ()
 
void setDefaultCursor (FXCursor *cur)
 
FXCursorgetDefaultCursor () const
 
void setDragCursor (FXCursor *cur)
 
FXCursorgetDragCursor () const
 
FXint getCursorPosition (FXint &x, FXint &y, FXuint &buttons) const
 
FXint setCursorPosition (FXint x, FXint y)
 
bool isEnabled () const
 
bool isActive () const
 
virtual bool canFocus () const
 
bool hasFocus () const
 
bool inFocusChain () const
 
virtual void setFocus ()
 
virtual void killFocus ()
 
virtual void changeFocus (FXWindow *child)
 
virtual void setDefault (FXbool enable=TRUE)
 
bool isDefault () const
 
void setInitial (bool enable=true)
 
bool isInitial () const
 
virtual void attach (FXID w)
 
virtual void setShape (const FXRegion &region)
 
virtual void setShape (FXBitmap *bitmap)
 
virtual void setShape (FXIcon *icon)
 
virtual void clearShape ()
 
virtual void raise ()
 
virtual void lower ()
 
virtual void move (FXint x, FXint y)
 
virtual void resize (FXint w, FXint h)
 
virtual void position (FXint x, FXint y, FXint w, FXint h)
 
virtual void recalc ()
 
void forceRefresh ()
 
virtual void reparent (FXWindow *father, FXWindow *other=NULL)
 
void scroll (FXint x, FXint y, FXint w, FXint h, FXint dx, FXint dy) const
 
void update (FXint x, FXint y, FXint w, FXint h) const
 
void update () const
 
void repaint (FXint x, FXint y, FXint w, FXint h) const
 
void repaint () const
 
void grab ()
 
void ungrab ()
 
bool grabbed () const
 
void grabKeyboard ()
 
void ungrabKeyboard ()
 
bool grabbedKeyboard () const
 
virtual void show ()
 
virtual void hide ()
 
bool shown () const
 
bool underCursor () const
 
bool hasSelection () const
 
bool acquireSelection (const FXDragType *types, FXuint numtypes)
 
bool releaseSelection ()
 
bool hasClipboard () const
 
bool acquireClipboard (const FXDragType *types, FXuint numtypes)
 
bool releaseClipboard ()
 
virtual void dropEnable ()
 
virtual void dropDisable ()
 
bool isDropEnabled () const
 
bool isDragging () const
 
bool beginDrag (const FXDragType *types, FXuint numtypes)
 
bool handleDrag (FXint x, FXint y, FXDragAction action=DRAG_COPY)
 
FXDragAction endDrag (bool drop=true)
 
bool isDropTarget () const
 
void setDragRectangle (FXint x, FXint y, FXint w, FXint h, bool wantupdates=true) const
 
void clearDragRectangle () const
 
void acceptDrop (FXDragAction action=DRAG_ACCEPT) const
 
FXDragAction didAccept () const
 
void dropFinished (FXDragAction action=DRAG_REJECT) const
 
bool inquireDNDTypes (FXDNDOrigin origin, FXDragType *&types, FXuint &numtypes) const
 
bool offeredDNDType (FXDNDOrigin origin, FXDragType type) const
 
FXDragAction inquireDNDAction () const
 
bool setDNDData (FXDNDOrigin origin, FXDragType type, FXuchar *data, FXuint size) const
 
bool setDNDData (FXDNDOrigin origin, FXDragType type, const FXString &string) const
 
bool getDNDData (FXDNDOrigin origin, FXDragType type, FXuchar *&data, FXuint &size) const
 
bool getDNDData (FXDNDOrigin origin, FXDragType type, FXString &string) const
 
virtual bool contains (FXint parentx, FXint parenty) const
 
void translateCoordinatesFrom (FXint &tox, FXint &toy, const FXWindow *fromwindow, FXint fromx, FXint fromy) const
 
void translateCoordinatesTo (FXint &tox, FXint &toy, const FXWindow *towindow, FXint fromx, FXint fromy) const
 
FXColor getBackColor () const
 
virtual bool doesSaveUnder () const
 
virtual const FXchartr (const FXchar *message, const FXchar *hint=NULL) const
 
virtual ~FXWindow ()
 
- Public Member Functions inherited from FX::FXDrawable
FXint getWidth () const
 
FXint getHeight () const
 
FXVisualgetVisual () const
 
void setVisual (FXVisual *vis)
 
virtual ~FXDrawable ()
 
- Public Member Functions inherited from FX::FXId
FXAppgetApp () const
 
FXID id () const
 
void setUserData (void *ptr)
 
void * getUserData () const
 
virtual ~FXId ()
 
- Public Member Functions inherited from FX::FXObject
virtual long onDefault (FXObject *, FXSelector, void *)
 
const FXchargetClassName () const
 
bool isMemberOf (const FXMetaClass *metaclass) const
 
virtual long tryHandle (FXObject *sender, FXSelector sel, void *ptr)
 
virtual ~FXObject ()
 

Additional Inherited Members

- Public Types inherited from FX::FXWindow
enum  {
  ID_NONE,
  ID_HIDE,
  ID_SHOW,
  ID_TOGGLESHOWN,
  ID_LOWER,
  ID_RAISE,
  ID_DELETE,
  ID_DISABLE,
  ID_ENABLE,
  ID_TOGGLEENABLED,
  ID_UNCHECK,
  ID_CHECK,
  ID_UNKNOWN,
  ID_UPDATE,
  ID_AUTOSCROLL,
  ID_TIPTIMER,
  ID_HSCROLLED,
  ID_VSCROLLED,
  ID_SETVALUE,
  ID_SETINTVALUE,
  ID_SETREALVALUE,
  ID_SETSTRINGVALUE,
  ID_SETICONVALUE,
  ID_SETINTRANGE,
  ID_SETREALRANGE,
  ID_GETINTVALUE,
  ID_GETREALVALUE,
  ID_GETSTRINGVALUE,
  ID_GETICONVALUE,
  ID_GETINTRANGE,
  ID_GETREALRANGE,
  ID_SETHELPSTRING,
  ID_GETHELPSTRING,
  ID_SETTIPSTRING,
  ID_GETTIPSTRING,
  ID_QUERY_MENU,
  ID_HOTKEY,
  ID_ACCEL,
  ID_UNPOST,
  ID_POST,
  ID_MDI_TILEHORIZONTAL,
  ID_MDI_TILEVERTICAL,
  ID_MDI_CASCADE,
  ID_MDI_MAXIMIZE,
  ID_MDI_MINIMIZE,
  ID_MDI_RESTORE,
  ID_MDI_CLOSE,
  ID_MDI_WINDOW,
  ID_MDI_MENUWINDOW,
  ID_MDI_MENUMINIMIZE,
  ID_MDI_MENURESTORE,
  ID_MDI_MENUCLOSE,
  ID_MDI_NEXT,
  ID_MDI_PREV,
  ID_LAST
}
 
- Static Public Member Functions inherited from FX::FXWindow
static FXWindowcommonAncestor (FXWindow *a, FXWindow *b)
 
static bool before (const FXWindow *a, const FXWindow *b)
 
static bool after (const FXWindow *a, const FXWindow *b)
 
- Static Public Attributes inherited from FX::FXWindow
static FXDragType octetType
 
static FXDragType deleteType
 
static FXDragType textType
 
static FXDragType utf8Type
 
static FXDragType utf16Type
 
static FXDragType colorType
 
static FXDragType urilistType
 
static const FXDragType stringType
 
static const FXDragType imageType
 
static const FXchar octetTypeName []
 
static const FXchar deleteTypeName []
 
static const FXchar textTypeName []
 
static const FXchar colorTypeName []
 
static const FXchar urilistTypeName []
 
static const FXchar utf8TypeName []
 
static const FXchar utf16TypeName []
 

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)

Set the text.

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 
)

Replace the item at index.

FXint FX::FXComboBox::fillItems ( const FXchar **  strings)

Fill combo box by appending items from array of strings.

FXint FX::FXComboBox::fillItems ( const FXString strings)

Fill combo box by appending items from newline separated strings.

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

Insert a new item at index.

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

Append an item to the list.

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

Prepend an item to the list.

FXint FX::FXComboBox::moveItem ( FXint  newindex,
FXint  oldindex 
)

Move item from oldindex to newindex.

void FX::FXComboBox::removeItem ( FXint  index)

Remove this item from the list.

void FX::FXComboBox::clearItems ( )

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.

FXbool FX::FXComboBox::isPaneShown ( ) const

Is the 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.

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

Set window background color.

Reimplemented from FX::FXWindow.

FXColor FX::FXComboBox::getBackColor ( ) const

Get background color.

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-2005 Jeroen van der Zijp