liststore: Make gtk_list_store_reorder() introspectable

Mark the new_order argument as zero-terminated array, even though it does not
need to be zero terminated (it has an implicit length not given by a constant
or another method argument). It does not hurt if bindings append an extra zero
to the array as long as it has enough elements, and this makes the method
introspectable.

https://bugzilla.gnome.org/show_bug.cgi?id=677941
This commit is contained in:
Martin Pitt 2012-06-12 15:41:03 +02:00
parent 75331c0ac2
commit 0e37d2a98b

View File

@ -1691,11 +1691,12 @@ gtk_list_store_reorder_func (GSequenceIter *a,
}
/**
* gtk_list_store_reorder: (skip)
* gtk_list_store_reorder:
* @store: A #GtkListStore.
* @new_order: (array): an array of integers mapping the new position of each child
* to its old position before the re-ordering,
* i.e. @new_order<literal>[newpos] = oldpos</literal>.
* @new_order: (array zero-terminated=1): an array of integers mapping the new
* position of each child to its old position before the re-ordering,
* i.e. @new_order<literal>[newpos] = oldpos</literal>. It must have
* exactly as many items as the list store's length.
*
* Reorders @store to follow the order indicated by @new_order. Note that
* this function only works with unsorted stores.