Adds a new row to the list view with text in the first column.
Takes listViewID (Int) and text (String).
Returns item index (row number) on success, -1 if list view not found.
BGI GUI
Parameters & Returns
Parameters
listViewIDInt
textString
Returns
Int
Quick Summary
Adds a new row to the list view with text in the first column.
Takes listViewID (Int) and text (String).
Returns item index (row number) on success, -1 if list view not found.
Technical Exegesis...
Adds a new row (item) to a list view control with text displayed in the first column (column 0). Searches gizmoMap for the list view ID. Creates LVITEM structure with LVIF_TEXT mask. Sets iItem to current item count (adds at end) via ListView_GetItemCount. Sets iSubItem to 0 (first column). Sets pszText to provided text. Inserts item with ListView_InsertItem. Returns item index (row number) on success, -1 if list view not found.
This function creates a new row in the list view.
Adds a new row (item) to a list view control with text displayed in the first column (column 0). Searches gizmoMap for the list view ID. Creates LVITEM structure with LVIF_TEXT mask. Sets iItem to current item count (adds at end) via ListView_GetItemCount. Sets iSubItem to 0 (first column). Sets pszText to provided text. Inserts item with ListView_InsertItem. Returns item index (row number) on success, -1 if list view not found.
This function creates a new row in the list view. Returns the 0-based row index of the newly added item. Only sets text for the first column (column 0). For multi-column list views, use bgiSetListViewSubItem to populate additional columns. Items are added sequentially at the end. Row index can be used with bgiSetListViewSubItem, bgiGetListViewItemText, and bgiRemoveListViewItem. Common pattern: add item, store returned index, use index to set subitem text for other columns.