![]() |
Main Page Class Hierarchy Alphabetical List Compound List File List Compound Members
![]() |
#include <FXList.h>
Public Member Functions | |
FXList (FXComposite *p, FXObject *tgt=NULL, FXSelector sel=0, FXuint opts=LIST_NORMAL, FXint x=0, FXint y=0, FXint w=0, FXint h=0) | |
virtual void | create () |
virtual void | detach () |
virtual void | layout () |
virtual FXint | getDefaultWidth () |
virtual FXint | getDefaultHeight () |
virtual FXint | getContentWidth () |
virtual FXint | getContentHeight () |
virtual void | recalc () |
virtual FXbool | canFocus () const |
virtual void | setFocus () |
virtual void | killFocus () |
FXint | getNumItems () const |
FXint | getNumVisible () const |
void | setNumVisible (FXint nvis) |
FXListItem * | getItem (FXint index) const |
FXint | setItem (FXint index, FXListItem *item, FXbool notify=false) |
FXint | setItem (FXint index, const FXString &text, FXIcon *icon=NULL, void *ptr=NULL, FXbool notify=false) |
FXint | fillItems (const FXchar **strings, FXIcon *icon=NULL, void *ptr=NULL, FXbool notify=false) |
FXint | fillItems (const FXString &strings, FXIcon *icon=NULL, void *ptr=NULL, FXbool notify=false) |
FXint | insertItem (FXint index, FXListItem *item, FXbool notify=false) |
FXint | insertItem (FXint index, const FXString &text, FXIcon *icon=NULL, void *ptr=NULL, FXbool notify=false) |
FXint | appendItem (FXListItem *item, FXbool notify=false) |
FXint | appendItem (const FXString &text, FXIcon *icon=NULL, void *ptr=NULL, FXbool notify=false) |
FXint | prependItem (FXListItem *item, FXbool notify=false) |
FXint | prependItem (const FXString &text, FXIcon *icon=NULL, void *ptr=NULL, FXbool notify=false) |
FXint | moveItem (FXint newindex, FXint oldindex, FXbool notify=false) |
FXListItem * | extractItem (FXint index, FXbool notify=false) |
void | removeItem (FXint index, FXbool notify=false) |
void | clearItems (FXbool notify=false) |
FXint | getItemWidth (FXint index) const |
FXint | getItemHeight (FXint index) const |
virtual FXint | getItemAt (FXint x, FXint y) const |
FXint | hitItem (FXint index, 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 | setItemIcon (FXint index, FXIcon *icon, FXbool owned=false) |
FXIcon * | getItemIcon (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 |
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 | 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 () |
FXListSortFunc | getSortFunc () const |
void | setSortFunc (FXListSortFunc func) |
void | setFont (FXFont *fnt) |
FXFont * | getFont () const |
FXColor | getTextColor () const |
void | setTextColor (FXColor clr) |
FXColor | getSelBackColor () const |
void | setSelBackColor (FXColor clr) |
FXColor | getSelTextColor () const |
void | setSelTextColor (FXColor clr) |
FXuint | getListStyle () const |
void | setListStyle (FXuint style) |
void | setHelpText (const FXString &text) |
const FXString & | getHelpText () const |
virtual void | save (FXStream &store) const |
virtual void | load (FXStream &store) |
virtual | ~FXList () |
Static Public Member Functions | |
static FXint | ascending (const FXListItem *a, const FXListItem *b) |
static FXint | descending (const FXListItem *a, const FXListItem *b) |
static FXint | ascendingCase (const FXListItem *a, const FXListItem *b) |
static FXint | descendingCase (const FXListItem *a, const FXListItem *b) |
When an item's selected state changes, the list sends a SEL_SELECTED or SEL_DESELECTED message. A change of the current item is signified by the SEL_CHANGED message. The 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 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:
FX::FXList::FXList | ( | FXComposite * | p, | |
FXObject * | tgt = NULL , |
|||
FXSelector | sel = 0 , |
|||
FXuint | opts = LIST_NORMAL , |
|||
FXint | x = 0 , |
|||
FXint | y = 0 , |
|||
FXint | w = 0 , |
|||
FXint | h = 0 | |||
) |
Construct a list with initially no items in it.
virtual FX::FXList::~FXList | ( | ) | [virtual] |
Destructor.
static FXint FX::FXList::ascending | ( | const FXListItem * | a, | |
const FXListItem * | b | |||
) | [static] |
static FXint FX::FXList::descending | ( | const FXListItem * | a, | |
const FXListItem * | b | |||
) | [static] |
static FXint FX::FXList::ascendingCase | ( | const FXListItem * | a, | |
const FXListItem * | b | |||
) | [static] |
static FXint FX::FXList::descendingCase | ( | const FXListItem * | a, | |
const FXListItem * | b | |||
) | [static] |
virtual void FX::FXList::create | ( | ) | [virtual] |
virtual void FX::FXList::detach | ( | ) | [virtual] |
virtual void FX::FXList::layout | ( | ) | [virtual] |
virtual FXint FX::FXList::getDefaultWidth | ( | ) | [virtual] |
virtual FXint FX::FXList::getDefaultHeight | ( | ) | [virtual] |
virtual FXint FX::FXList::getContentWidth | ( | ) | [virtual] |
virtual FXint FX::FXList::getContentHeight | ( | ) | [virtual] |
virtual void FX::FXList::recalc | ( | ) | [virtual] |
virtual FXbool FX::FXList::canFocus | ( | ) | const [virtual] |
virtual void FX::FXList::setFocus | ( | ) | [virtual] |
virtual void FX::FXList::killFocus | ( | ) | [virtual] |
FXint FX::FXList::getNumItems | ( | ) | const [inline] |
Return the number of items in the list.
FXint FX::FXList::getNumVisible | ( | ) | const [inline] |
Return number of visible items.
void FX::FXList::setNumVisible | ( | FXint | nvis | ) |
Change the number of visible items.
FXListItem* FX::FXList::getItem | ( | FXint | index | ) | const |
Return the item at the given index.
FXint FX::FXList::setItem | ( | FXint | index, | |
FXListItem * | item, | |||
FXbool | notify = false | |||
) |
Replace the item with a [possibly subclassed] item.
FXint FX::FXList::setItem | ( | FXint | index, | |
const FXString & | text, | |||
FXIcon * | icon = NULL , |
|||
void * | ptr = NULL , |
|||
FXbool | notify = false | |||
) |
Replace items text, icon, and user-data pointer.
FXint FX::FXList::fillItems | ( | const FXchar ** | strings, | |
FXIcon * | icon = NULL , |
|||
void * | ptr = NULL , |
|||
FXbool | notify = false | |||
) |
Fill list by appending items from array of strings.
FXint FX::FXList::fillItems | ( | const FXString & | strings, | |
FXIcon * | icon = NULL , |
|||
void * | ptr = NULL , |
|||
FXbool | notify = false | |||
) |
Fill list by appending items from newline separated strings.
FXint FX::FXList::insertItem | ( | FXint | index, | |
FXListItem * | item, | |||
FXbool | notify = false | |||
) |
Insert a new [possibly subclassed] item at the give index.
FXint FX::FXList::insertItem | ( | FXint | index, | |
const FXString & | text, | |||
FXIcon * | icon = NULL , |
|||
void * | ptr = NULL , |
|||
FXbool | notify = false | |||
) |
Insert item at index with given text, icon, and user-data pointer.
FXint FX::FXList::appendItem | ( | FXListItem * | item, | |
FXbool | notify = false | |||
) |
Append a [possibly subclassed] item to the list.
FXint FX::FXList::appendItem | ( | const FXString & | text, | |
FXIcon * | icon = NULL , |
|||
void * | ptr = NULL , |
|||
FXbool | notify = false | |||
) |
Append new item with given text and optional icon, and user-data pointer.
FXint FX::FXList::prependItem | ( | FXListItem * | item, | |
FXbool | notify = false | |||
) |
Prepend a [possibly subclassed] item to the list.
FXint FX::FXList::prependItem | ( | const FXString & | text, | |
FXIcon * | icon = NULL , |
|||
void * | ptr = NULL , |
|||
FXbool | notify = false | |||
) |
Prepend new item with given text and optional icon, and user-data pointer.
Move item from oldindex to newindex.
FXListItem* FX::FXList::extractItem | ( | FXint | index, | |
FXbool | notify = false | |||
) |
Extract item from list.
void FX::FXList::clearItems | ( | FXbool | notify = false |
) |
Remove all items from list.
Return index of item at x,y, if any.
Return item hit code: 0 no hit; 1 hit the icon; 2 hit the text.
FXint FX::FXList::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::FXList::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::FXList::makeItemVisible | ( | FXint | index | ) | [virtual] |
Scroll to bring item into view.
Change item icon, deleting the old icon if it was owned.
void FX::FXList::setItemData | ( | FXint | index, | |
void * | ptr | |||
) |
Change item user-data pointer.
void* FX::FXList::getItemData | ( | FXint | index | ) | const |
Return item user-data pointer.
void FX::FXList::updateItem | ( | FXint | index | ) | const |
Repaint item.
Deselect item.
Toggle item selection state.
Extend selection from anchor item to index.
Change current item.
FXint FX::FXList::getCurrentItem | ( | ) | const [inline] |
Return current item, if any.
void FX::FXList::setAnchorItem | ( | FXint | index | ) |
Change anchor item.
FXint FX::FXList::getAnchorItem | ( | ) | const [inline] |
Return anchor item, if any.
FXint FX::FXList::getCursorItem | ( | ) | const [inline] |
Get item under the cursor, if any.
void FX::FXList::sortItems | ( | ) |
Sort items using current sort function.
FXListSortFunc FX::FXList::getSortFunc | ( | ) | const [inline] |
Return sort function.
void FX::FXList::setSortFunc | ( | FXListSortFunc | func | ) | [inline] |
Change sort function.
void FX::FXList::setFont | ( | FXFont * | fnt | ) |
Change text font.
FXFont* FX::FXList::getFont | ( | ) | const [inline] |
Return text font.
FXColor FX::FXList::getTextColor | ( | ) | const [inline] |
Return normal text color.
void FX::FXList::setTextColor | ( | FXColor | clr | ) |
Change normal text color.
FXColor FX::FXList::getSelBackColor | ( | ) | const [inline] |
Return selected text background.
void FX::FXList::setSelBackColor | ( | FXColor | clr | ) |
Change selected text background.
FXColor FX::FXList::getSelTextColor | ( | ) | const [inline] |
Return selected text color.
void FX::FXList::setSelTextColor | ( | FXColor | clr | ) |
Change selected text color.
FXuint FX::FXList::getListStyle | ( | ) | const |
Return list style.
void FX::FXList::setListStyle | ( | FXuint | style | ) |
Change list style.
void FX::FXList::setHelpText | ( | const FXString & | text | ) |
Set the status line help text for this list.
const FXString& FX::FXList::getHelpText | ( | ) | const [inline] |
Get the status line help text for this list.
virtual void FX::FXList::save | ( | FXStream & | store | ) | const [virtual] |
virtual void FX::FXList::load | ( | FXStream & | store | ) | [virtual] |
![]() |