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

FX::FXIconList Class Reference

A Icon List Widget displays a list of items, each with a text and optional icon. More...

#include <FXIconList.h>

Inheritance diagram for FX::FXIconList:

FX::FXScrollArea FX::FXComposite FX::FXWindow FX::FXDrawable FX::FXId FX::FXObject FX::FXFileList

List of all members.

Public Member Functions

 FXIconList (FXComposite *p, FXObject *tgt=NULL, FXSelector sel=0, FXuint opts=ICONLIST_NORMAL, FXint x=0, FXint y=0, FXint w=0, FXint h=0)
virtual void create ()
virtual void detach ()
virtual void recalc ()
virtual void layout ()
virtual FXint getContentWidth ()
virtual FXint getContentHeight ()
virtual bool canFocus () const
virtual void setFocus ()
virtual void killFocus ()
virtual FXint getViewportHeight ()
virtual void resize (FXint w, FXint h)
virtual void position (FXint x, FXint y, FXint w, FXint h)
FXint getNumItems () const
FXint getNumRows () const
FXint getNumCols () const
FXHeadergetHeader () const
void setHeaders (const FXchar **strings, FXint size=1)
void setHeaders (const FXString &strings, FXint size=1)
void appendHeader (const FXString &text, FXIcon *icon=NULL, FXint size=1)
void removeHeader (FXint index)
void setHeaderText (FXint index, const FXString &text)
FXString getHeaderText (FXint index) const
void setHeaderIcon (FXint index, FXIcon *icon)
FXIcongetHeaderIcon (FXint index) const
void setHeaderSize (FXint index, FXint size)
FXint getHeaderSize (FXint index) const
FXint getNumHeaders () const
FXIconItemgetItem (FXint index) const
FXint setItem (FXint index, FXIconItem *item, FXbool notify=FALSE)
FXint setItem (FXint index, const FXString &text, FXIcon *big=NULL, FXIcon *mini=NULL, void *ptr=NULL, FXbool notify=FALSE)
FXint fillItems (const FXchar **strings, FXIcon *big=NULL, FXIcon *mini=NULL, void *ptr=NULL, FXbool notify=FALSE)
FXint fillItems (const FXString &strings, FXIcon *big=NULL, FXIcon *mini=NULL, void *ptr=NULL, FXbool notify=FALSE)
FXint insertItem (FXint index, FXIconItem *item, FXbool notify=FALSE)
FXint insertItem (FXint index, const FXString &text, FXIcon *big=NULL, FXIcon *mini=NULL, void *ptr=NULL, FXbool notify=FALSE)
FXint appendItem (FXIconItem *item, FXbool notify=FALSE)
FXint appendItem (const FXString &text, FXIcon *big=NULL, FXIcon *mini=NULL, void *ptr=NULL, FXbool notify=FALSE)
FXint prependItem (FXIconItem *item, FXbool notify=FALSE)
FXint prependItem (const FXString &text, FXIcon *big=NULL, FXIcon *mini=NULL, void *ptr=NULL, FXbool notify=FALSE)
FXint moveItem (FXint newindex, FXint oldindex, FXbool notify=FALSE)
FXIconItemextractItem (FXint index, FXbool notify=FALSE)
void removeItem (FXint index, FXbool notify=FALSE)
void clearItems (FXbool notify=FALSE)
FXint getItemWidth () const
FXint getItemHeight () const
virtual FXint getItemAt (FXint x, FXint y) const
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
virtual void makeItemVisible (FXint index)
void setItemText (FXint index, const FXString &text)
FXString getItemText (FXint index) const
void setItemBigIcon (FXint index, FXIcon *icon, FXbool owned=FALSE)
FXIcongetItemBigIcon (FXint index) const
void setItemMiniIcon (FXint index, FXIcon *icon, FXbool owned=FALSE)
FXIcongetItemMiniIcon (FXint index) const
void setItemData (FXint index, void *ptr)
void * getItemData (FXint index) const
FXbool isItemSelected (FXint index) const
FXbool isItemCurrent (FXint index) const
FXbool isItemVisible (FXint index) const
FXbool isItemEnabled (FXint index) const
FXint hitItem (FXint index, FXint x, FXint y, FXint ww=1, FXint hh=1) const
void updateItem (FXint index) const
virtual FXbool enableItem (FXint index)
virtual FXbool disableItem (FXint index)
virtual FXbool selectItem (FXint index, FXbool notify=FALSE)
virtual FXbool deselectItem (FXint index, FXbool notify=FALSE)
virtual FXbool toggleItem (FXint index, FXbool notify=FALSE)
virtual FXbool selectInRectangle (FXint x, FXint y, FXint w, FXint h, FXbool notify=FALSE)
virtual FXbool extendSelection (FXint index, FXbool notify=FALSE)
virtual FXbool killSelection (FXbool notify=FALSE)
virtual void setCurrentItem (FXint index, FXbool notify=FALSE)
FXint getCurrentItem () const
void setAnchorItem (FXint index)
FXint getAnchorItem () const
FXint getCursorItem () const
void sortItems ()
FXIconListSortFunc getSortFunc () const
void setSortFunc (FXIconListSortFunc func)
void setFont (FXFont *fnt)
FXFontgetFont () const
FXColor getTextColor () const
void setTextColor (FXColor clr)
FXColor getSelBackColor () const
void setSelBackColor (FXColor clr)
FXColor getSelTextColor () const
void setSelTextColor (FXColor clr)
void setItemSpace (FXint s)
FXint getItemSpace () const
FXuint getListStyle () const
void setListStyle (FXuint style)
void setHelpText (const FXString &text)
const FXStringgetHelpText () const
virtual void save (FXStream &store) const
virtual void load (FXStream &store)
virtual ~FXIconList ()

Static Public Member Functions

static FXint ascending (const FXIconItem *a, const FXIconItem *b)
static FXint descending (const FXIconItem *a, const FXIconItem *b)
static FXint ascendingCase (const FXIconItem *a, const FXIconItem *b)
static FXint descendingCase (const FXIconItem *a, const FXIconItem *b)


Detailed Description

A Icon List Widget displays a list of items, each with a text and optional icon.

Icon List can display its items in essentially three different ways; in big-icon mode, the bigger of the two icons is used for each item, and the text is placed underneath the icon. In mini- icon mode, the icons are listed in rows and columns, with the smaller icon preceding the text. Finally, in detail mode the icons are listed in a single column, and all fields of the text are shown under a header control with one button for each subfield. When an item's selected state changes, the icon list sends a SEL_SELECTED or SEL_DESELECTED message. A change of the current item is signified by the SEL_CHANGED message. The icon list sends SEL_COMMAND messages when the user clicks on an item, and SEL_CLICKED, SEL_DOUBLECLICKED, and SEL_TRIPLECLICKED when the user clicks once, twice, or thrice, respectively. When items are added, replaced, or removed, the icon list sends messages of the type SEL_INSERTED, SEL_REPLACED, or SEL_DELETED. In each of these cases, the index to the item, if any, is passed in the 3rd argument of the message.

See also:


Constructor & Destructor Documentation

FX::FXIconList::FXIconList ( FXComposite p,
FXObject tgt = NULL,
FXSelector  sel = 0,
FXuint  opts = ICONLIST_NORMAL,
FXint  x = 0,
FXint  y = 0,
FXint  w = 0,
FXint  h = 0 
)

Construct icon list with no items in it initially.

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

Destructor.


Member Function Documentation

static FXint FX::FXIconList::ascending ( const FXIconItem a,
const FXIconItem b 
) [static]

Reimplemented in FX::FXFileList.

static FXint FX::FXIconList::descending ( const FXIconItem a,
const FXIconItem b 
) [static]

Reimplemented in FX::FXFileList.

static FXint FX::FXIconList::ascendingCase ( const FXIconItem a,
const FXIconItem b 
) [static]

Reimplemented in FX::FXFileList.

static FXint FX::FXIconList::descendingCase ( const FXIconItem a,
const FXIconItem b 
) [static]

Reimplemented in FX::FXFileList.

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

Create server-side resources.

Reimplemented from FX::FXComposite.

Reimplemented in FX::FXFileList.

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

Detach server-side resources.

Reimplemented from FX::FXComposite.

Reimplemented in FX::FXFileList.

virtual void FX::FXIconList::recalc (  )  [virtual]

Recalculate layout.

Reimplemented from FX::FXWindow.

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

Perform layout.

Reimplemented from FX::FXScrollArea.

virtual FXint FX::FXIconList::getContentWidth (  )  [virtual]

Compute and return content width.

Reimplemented from FX::FXScrollArea.

virtual FXint FX::FXIconList::getContentHeight (  )  [virtual]

Return content height.

Reimplemented from FX::FXScrollArea.

virtual bool FX::FXIconList::canFocus (  )  const [virtual]

Icon list can receive focus.

Reimplemented from FX::FXWindow.

virtual void FX::FXIconList::setFocus (  )  [virtual]

Move the focus to this window.

Reimplemented from FX::FXWindow.

virtual void FX::FXIconList::killFocus (  )  [virtual]

Remove the focus from this window.

Reimplemented from FX::FXWindow.

virtual FXint FX::FXIconList::getViewportHeight (  )  [virtual]

Return viewport size.

Reimplemented from FX::FXScrollArea.

virtual void FX::FXIconList::resize ( FXint  w,
FXint  h 
) [virtual]

Resize this window to the specified width and height.

Reimplemented from FX::FXWindow.

virtual void FX::FXIconList::position ( FXint  x,
FXint  y,
FXint  w,
FXint  h 
) [virtual]

Move and resize this window in the parent's coordinates.

Reimplemented from FX::FXWindow.

FXint FX::FXIconList::getNumItems (  )  const [inline]

Return number of items.

FXint FX::FXIconList::getNumRows (  )  const [inline]

Return number of rows.

References FX::FXWindow::ID_LAST.

FXint FX::FXIconList::getNumCols (  )  const [inline]

Return number of columns.

FXHeader* FX::FXIconList::getHeader (  )  const [inline]

Return header control.

void FX::FXIconList::setHeaders ( const FXchar **  strings,
FXint  size = 1 
)

Set headers from array of strings.

void FX::FXIconList::setHeaders ( const FXString strings,
FXint  size = 1 
)

Set headers from newline separated strings.

void FX::FXIconList::appendHeader ( const FXString text,
FXIcon icon = NULL,
FXint  size = 1 
)

Append header with given text and optional icon.

void FX::FXIconList::removeHeader ( FXint  index  ) 

Remove header at index.

void FX::FXIconList::setHeaderText ( FXint  index,
const FXString text 
)

Change text of header at index.

FXString FX::FXIconList::getHeaderText ( FXint  index  )  const

Return text of header at index.

void FX::FXIconList::setHeaderIcon ( FXint  index,
FXIcon icon 
)

Change icon of header at index.

FXIcon* FX::FXIconList::getHeaderIcon ( FXint  index  )  const

Return icon of header at index.

void FX::FXIconList::setHeaderSize ( FXint  index,
FXint  size 
)

Change size of header at index.

FXint FX::FXIconList::getHeaderSize ( FXint  index  )  const

Return width of header at index.

FXint FX::FXIconList::getNumHeaders (  )  const

Return number of headers.

FXIconItem* FX::FXIconList::getItem ( FXint  index  )  const

Return the item at the given index.

FXint FX::FXIconList::setItem ( FXint  index,
FXIconItem item,
FXbool  notify = FALSE 
)

Replace the item with a [possibly subclassed] item.

FXint FX::FXIconList::setItem ( FXint  index,
const FXString text,
FXIcon big = NULL,
FXIcon mini = NULL,
void *  ptr = NULL,
FXbool  notify = FALSE 
)

Replace items text, icons, and user-data pointer.

FXint FX::FXIconList::fillItems ( const FXchar **  strings,
FXIcon big = NULL,
FXIcon mini = NULL,
void *  ptr = NULL,
FXbool  notify = FALSE 
)

Fill list by appending items from array of strings.

FXint FX::FXIconList::fillItems ( const FXString strings,
FXIcon big = NULL,
FXIcon mini = NULL,
void *  ptr = NULL,
FXbool  notify = FALSE 
)

Fill list by appending items from newline separated strings.

FXint FX::FXIconList::insertItem ( FXint  index,
FXIconItem item,
FXbool  notify = FALSE 
)

Insert a new [possibly subclassed] item at the give index.

FXint FX::FXIconList::insertItem ( FXint  index,
const FXString text,
FXIcon big = NULL,
FXIcon mini = NULL,
void *  ptr = NULL,
FXbool  notify = FALSE 
)

Insert item at index with given text, icons, and user-data pointer.

FXint FX::FXIconList::appendItem ( FXIconItem item,
FXbool  notify = FALSE 
)

Append a [possibly subclassed] item to the end of the list.

FXint FX::FXIconList::appendItem ( const FXString text,
FXIcon big = NULL,
FXIcon mini = NULL,
void *  ptr = NULL,
FXbool  notify = FALSE 
)

Append new item with given text and optional icons, and user-data pointer.

FXint FX::FXIconList::prependItem ( FXIconItem item,
FXbool  notify = FALSE 
)

Prepend a [possibly subclassed] item to the end of the list.

FXint FX::FXIconList::prependItem ( const FXString text,
FXIcon big = NULL,
FXIcon mini = NULL,
void *  ptr = NULL,
FXbool  notify = FALSE 
)

Prepend new item with given text and optional icons, and user-data pointer.

FXint FX::FXIconList::moveItem ( FXint  newindex,
FXint  oldindex,
FXbool  notify = FALSE 
)

Move item from oldindex to newindex.

FXIconItem* FX::FXIconList::extractItem ( FXint  index,
FXbool  notify = FALSE 
)

Extract item from list.

void FX::FXIconList::removeItem ( FXint  index,
FXbool  notify = FALSE 
)

Remove item from list.

void FX::FXIconList::clearItems ( FXbool  notify = FALSE  ) 

Remove all items from list.

FXint FX::FXIconList::getItemWidth (  )  const [inline]

Return item width.

FXint FX::FXIconList::getItemHeight (  )  const [inline]

Return item height.

virtual FXint FX::FXIconList::getItemAt ( FXint  x,
FXint  y 
) const [virtual]

Return index of item at x,y, or -1 if none.

FXint FX::FXIconList::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::FXIconList::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.

virtual void FX::FXIconList::makeItemVisible ( FXint  index  )  [virtual]

Scroll to make item at index visible.

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

Change item text.

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

Return item text.

void FX::FXIconList::setItemBigIcon ( FXint  index,
FXIcon icon,
FXbool  owned = FALSE 
)

Change item big icon.

FXIcon* FX::FXIconList::getItemBigIcon ( FXint  index  )  const

Return big icon of item at index.

void FX::FXIconList::setItemMiniIcon ( FXint  index,
FXIcon icon,
FXbool  owned = FALSE 
)

Change item mini icon.

FXIcon* FX::FXIconList::getItemMiniIcon ( FXint  index  )  const

Return mini icon of item at index.

void FX::FXIconList::setItemData ( FXint  index,
void *  ptr 
)

Change item user-data pointer.

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

Return item user-data pointer.

FXbool FX::FXIconList::isItemSelected ( FXint  index  )  const

Return TRUE if item at index is selected.

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

Return TRUE if item at index is current.

FXbool FX::FXIconList::isItemVisible ( FXint  index  )  const

Return TRUE if item at index is visible.

FXbool FX::FXIconList::isItemEnabled ( FXint  index  )  const

Return TRUE if item at index is enabled.

FXint FX::FXIconList::hitItem ( FXint  index,
FXint  x,
FXint  y,
FXint  ww = 1,
FXint  hh = 1 
) const

Return item hit code: 0 outside, 1 icon, 2 text.

void FX::FXIconList::updateItem ( FXint  index  )  const

Repaint item at index.

virtual FXbool FX::FXIconList::enableItem ( FXint  index  )  [virtual]

Enable item at index.

virtual FXbool FX::FXIconList::disableItem ( FXint  index  )  [virtual]

Disable item at index.

virtual FXbool FX::FXIconList::selectItem ( FXint  index,
FXbool  notify = FALSE 
) [virtual]

Select item at index.

virtual FXbool FX::FXIconList::deselectItem ( FXint  index,
FXbool  notify = FALSE 
) [virtual]

Deselect item at index.

virtual FXbool FX::FXIconList::toggleItem ( FXint  index,
FXbool  notify = FALSE 
) [virtual]

Toggle item at index.

virtual FXbool FX::FXIconList::selectInRectangle ( FXint  x,
FXint  y,
FXint  w,
FXint  h,
FXbool  notify = FALSE 
) [virtual]

Select items in rectangle.

virtual FXbool FX::FXIconList::extendSelection ( FXint  index,
FXbool  notify = FALSE 
) [virtual]

Extend selection from anchor index to index.

virtual FXbool FX::FXIconList::killSelection ( FXbool  notify = FALSE  )  [virtual]

Deselect all items.

virtual void FX::FXIconList::setCurrentItem ( FXint  index,
FXbool  notify = FALSE 
) [virtual]

Change current item index.

FXint FX::FXIconList::getCurrentItem (  )  const [inline]

Return current item index, or -1 if none.

void FX::FXIconList::setAnchorItem ( FXint  index  ) 

Change anchor item index.

FXint FX::FXIconList::getAnchorItem (  )  const [inline]

Return anchor item index, or -1 if none.

FXint FX::FXIconList::getCursorItem (  )  const [inline]

Return index of item under cursor, or -1 if none.

void FX::FXIconList::sortItems (  ) 

Sort items.

FXIconListSortFunc FX::FXIconList::getSortFunc (  )  const [inline]

Return sort function.

void FX::FXIconList::setSortFunc ( FXIconListSortFunc  func  )  [inline]

Change sort function.

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

Change text font.

FXFont* FX::FXIconList::getFont (  )  const [inline]

Return text font.

FXColor FX::FXIconList::getTextColor (  )  const [inline]

Return normal text color.

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

Change normal text color.

FXColor FX::FXIconList::getSelBackColor (  )  const [inline]

Return selected text background.

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

Change selected text background.

FXColor FX::FXIconList::getSelTextColor (  )  const [inline]

Return selected text color.

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

Change selected text color.

void FX::FXIconList::setItemSpace ( FXint  s  ) 

Change maximum item space for each item.

FXint FX::FXIconList::getItemSpace (  )  const [inline]

Return maximum item space.

FXuint FX::FXIconList::getListStyle (  )  const

Get the current icon list style.

void FX::FXIconList::setListStyle ( FXuint  style  ) 

Set the current icon list style.

void FX::FXIconList::setHelpText ( const FXString text  ) 

Set the status line help text for this widget.

const FXString& FX::FXIconList::getHelpText (  )  const [inline]

Get the status line help text for this widget.

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

Save list to a stream.

Reimplemented from FX::FXWindow.

Reimplemented in FX::FXFileList.

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

Load list from a stream.

Reimplemented from FX::FXWindow.

Reimplemented in FX::FXFileList.

Copyright © 1997-2005 Jeroen van der Zijp