Inserts a new item, and returns a handle to the newly created item.
| Type | Description | |||
| Parent as HITEM | A long expression that indicates the item's handle that indicates the parent item where the newly item is inserted | |||
| UserData as Variant | A Variant expression that indicates the item's extra data. Use the ItemData property to retrieve later this value. | |||
| Value as Variant | A Variant expression that indicates the cell's value on the first column, or a safe array that holds values for each column. |
| Return | Description | |||
| HITEM | Retrieves the handle of the newly created item. |
Use the InsertItem property to add a new child to an item. The InsertItem property fires the ViewItemUpdate(exAddItem) event. You can use the InsertItem(,,"Root") or AddItem("Root") to add a root item. An item that has no parent is a root item. To insert an ActiveX control, use the InsertControlItem property of the Items property. Use the CellValue property to specify the values for cells in the second, third columns, and so on. Use the CellValueFormat property to specify whether the value contains HTML format or computed fields. Use the LockedItemCount property to lock or unlock items to the top or bottom side of the control. Use the MergeCells method to combine one or more cells in a single cell. Use the SplitCell property to split a cell. Use the ConditionalFormats method to apply formats to a cell or range of cells, and have that formatting change depending on the value of the cell or the value of a formula.