Adds a new item, and returns a handle to the newly created item.
| Type | Description | |||
| Value as Variant | A variant expression that indicates the cell's value for the first column or a safe array that holds the values for each column. |
| Return | Description | |||
| HITEM | A long expression that indicates the handle of the newly created item. |
Use the AddItem property to add new items/cards that have no parent ( usually when your control acts like a list or in CardView mode ). Adding new items fails, if the control has no columns. Use the Add method to add new columns to the control. Use InsertItem to insert child items ( usually when your control acts like a tree ). When a new item is added to the Items collection, the control fires the ViewItemUpdate(exAddItem) event. If the control contains more than one column use the CellValue property to set the cell's value. Use the CellValueFormat property to specify whether the value contains HTML format or computed fields. If the control has no columns the AddItem method fails. Use Add method to insert new columns to the control. 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 BeginUpdate and EndUpdate methods to maintain performance while adding new columns and items. 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.