SG_ListIconGadget | ||||||||||||||||||||||||||||||||||||
Syntax: | ||||||||||||||||||||||||||||||||||||
Result=SG_ListIconGadget(SG_GadgetID_L.l, X_Pos_L.l, Y_Pos_L.l, Width_L.l, Height_L.l, ColumnName_S.s, ColumnWidth_L.l, [Flags_L]) | ||||||||||||||||||||||||||||||||||||
Parameters: | ||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||
Return Values: | ||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||
Description: | ||||||||||||||||||||||||||||||||||||
Creates a ListIcon gadget in the current screen. #Gadget will be the numeric identifier returned by the SG_EventScreenGadgetID() command. 'Title$' is the first column title, and 'TitleWidth' its initial width (in pixels). Once a ListIconGadget is created, its list of items is empty. The following commands can be used to act on the list content: - AddGadgetColumn() : Add a column to the gadget. - AddGadgetItem(): Add an item (with an optional image in the standard 16x16 size). - RemoveGadgetItem(): Remove an item. - ClearGadgetItemList(): Remove all the items. - CountGadgetItems(): Returns the number of items currently in the #Gadget. - GetGadgetItemState(): Returns the current state of the specified item. - SetGadgetItemState(): Changes the current state of the specified item. - GetGadgetItemText(): Returns the current text of the specified item. - SetGadgetItemText(): Changes the current text of the specified item. If you want to add content to ListIcons with several columns using SG_AddGadgetItem() , you should use the format "first column"+Chr(10)+"second one" as Text$ parameter. | ||||||||||||||||||||||||||||||||||||
Example: | ||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||
Remarks: | ||||||||||||||||||||||||||||||||||||
The maximum number of colums for these gadget is 16. For the purpose of changing the header width with the mouse, there is a special way to change the mouse, if it is over the gap between two header columns. In this case, the function `SG_MoveLiconHeader()` returns 1, otherwise 0 | ||||||||||||||||||||||||||||||||||||
|