gtkTreeStoreInsertWithValues {RGtk2} | R Documentation

## gtkTreeStoreInsertWithValues

### Description

Creates a new row at `position`. `iter` will be changed to point to this new row. If `position` is larger than the number of rows on the list, then the new row will be appended to the list. The row will be filled with the values given to this function.

### Usage

    gtkTreeStoreInsertWithValues(object, parent, position, ...)

### Arguments

``object`` | A `GtkTreeStore`
``parent`` | A valid `GtkTreeIter`, or `NULL`. [ allow-none ]
``position`` | position to insert the new row
``...`` | undocumented

### Details

Calling `gtk_tree_store_insert_with_values (tree_store, iter, position, ...)` has the same effect as calling

    tree_store$insert(iter, position)
    tree_store$set(iter, ...)

with the different that the former will only emit a row_inserted signal, while the latter will emit row_inserted, row_changed and if the tree store is sorted, rows_reordered. Since emitting the rows_reordered signal repeatedly can affect the performance of the program, `gtkTreeStoreInsertWithValues` should generally be preferred when inserting rows in a sorted tree store. Since 2.10

### Value

A list containing the following elements:

``iter`` | An unset `GtkTreeIter` to set the new row, or `NULL`. [ allow-none ]

### Author(s)

Derived by RGtkGen from GTK+ documentation

[Package RGtk2 version 2.20.36.3 Index]