Insert_Item - DfBaseList
Inserts an item in a list
Type: Procedure
Parameters
| Parameter | Type | Description |
|---|---|---|
| iMessage | Integer | The message ID |
| sValue | String | The value to be inserted |
| iItem | Integer | The item number to be inserted in front of |
Syntax
Procedure Insert_Item Integer iMessage String sValue Integer iItem
Call Example
Send Insert_Item iMessage sValue iItem
Description
The Insert_Item procedure inserts an item in a list. Items are inserted before the iItem specified. The properties of the item are set according to the subclass of the object. If there are no items in the list then the top_item property is set to the new item. If this object is active, and the added item appears in the screen window, the display is automatically updated.
send insert_item msg_do_something "GO" 3
| Col 1 | Col 2 |
|---|---|
| Note: | Because of the structure of items, it is sometimes faster to build a list of items by inserting each item at the beginning of the list. Do not forget that if the object is active, you probably should set the dynamic_update_state of the object to false, insert all of the items, and then set it back to true. |