gtk:list-store-insert-with-values (store position &rest values)

store -- a gtk:list-store object
position -- an integer with the position to insert the new row, or -1 to append after existing rows
values -- values to store in store

The gtk:tree-iter iterator to the new row.

Creates a new row at position. The returned iterator will point to this new row. If position is -1, or larger than the number of rows in the list, then the new row will be appended to the list. The row will be filled with the values given to this function.

Calling the gtk:list-store-insert-with-values function has the same effect as calling

 (let ((iter (gtk:list-store-insert list-store position)))
   (gtk:list-store-set list-store iter  ...)
 )  

with the difference that the former will only emit a "row-inserted" signal, while the latter will emit "row-inserted", "row-changed" and, if the list store is sorted, "rows-reordered" signals. Since emitting the "rows-reordered" signal repeatedly can affect the performance of the program, the gtk:list-store-insert-with-values function should generally be preferred when inserting rows in a sorted list store.