gtk-sharp2.12.0.0Gtk# is thread aware, but not thread safe; See the Gtk# Thread Programming for details.The ListStore is a columned list data structure to be used with widget.
Iteration: In new versions of Gtk# (2.0 and up) this class implements the interface, so code can be written like this:
void DumpColumnValues (ListStore store, int col)
{
foreach (object[] row in store)
Console.WriteLine ("Value of column {0} is {2}", col, row [col]);
}
GLib.ObjectGtk.TreeDragDestGtk.TreeDragSourceGtk.TreeModelGtk.TreeSortableSystem.Collections.IEnumerableMethodSystem.Int32
Returns the number of children that the toplevel node has. Is used to retrieve the number of rows in the .
an object of type , the number of children of .As a special case, if is , then the number
of toplevel nodes is returned.MethodSystem.Boolean
Sets to point to the first child of .
an object of type an object of type ,
, if has been set to the first child.
If has no children,
is returned and is set to be invalid. will remain a valid
node after this function has been called.
If is returns the first node, equivalent to
gtk_tree_model_get_iter_first (tree_model, iter);MethodSystem.VoidEmits a event.MethodSystem.VoidSets the column number to sort by.
A , the column number to sort by.
A MethodSystem.VoidSets a sort function to be used for the column .
A for the column number.
A
ignored
ignored
This overload is obsolete. The two parameter overload is preferred for new code. MethodSystem.VoidSet the function that will be used by default to sort columns.
A
ignored
ignored
This method is obsolete. The property is preferred for new code. PropertyGtk.TreeIterCompareFuncThe function that will be used by default to sort columns.a MethodSystem.BooleanReturns true if the row at can
have dropped on it.
A
A A boolean.MethodSystem.BooleanDrags data received into this object.
A , the destination path of the drag
A , the data that was dragged
A boolean, true if the data was successfully received.MethodSystem.BooleanMethod used when this ListStore is part of a source widget
for a drag-and-drop operation; gets the data that was dragged from the
associated widget.
a
A A , true if the operation succeeded.MethodSystem.BooleanReturns whether or not a given row can be dragged.
a A boolean, true if the row is draggable.MethodSystem.BooleanWhen this ListStore is the data source for a drag operation and the drag operation is a move, this method runs to delete the data after the data has been received by the target widget.
A , the path of the data to delete.
A , true if the operation succeeds.MethodSystem.VoidFires a event. Call this after changing a row so that the view widget for this ListStore will update.
a
a MethodSystem.VoidRuns a method on every row of a ListStore.
A to run over every row.
MethodSystem.BooleanInitializes with the first iterator in the ListStore (the top item).
A to reset
A , true if the operation is successful, false if the ListStore is empty.MethodSystem.VoidEmits a event. This is meant to be called whenever the child state of a node changes.
a to pass to the event
a to pass to the event
This is mandated by the , but it
shouldn't get used much for ListStores because they don't generally
have child nodes.MethodGtk.TreePathTurns a specified by into a .
a a MethodSystem.BooleanTests whether a given row has a child node.
a A , always false for ListStores.This is mandated by MethodSystem.VoidLets the ListStore reference the row pointed to by .
a This function is primarily meant as a way for views to let caching model know when nodes are being displayed (and hence, whether or not to cache that node.) For example, a file-system based model would not want to keep the entire file-hierarchy in memory, just the sections that are currently being displayed by every current view.A model should be expected to be able to get an iter independent of its reffed state.MethodSystem.Int32Returns the number of children that has. If is null, as in the case of all ListStore objects, this will return the number of top-level items.
a a FIXME: Why does ListStore.custom call gtk_tree_model_iter_n_children?MethodSystem.VoidFires a event.
a to pass to the event.
a see cref="T:Gtk.TreeIter" /> to pass to the event.
MethodSystem.VoidFires a event.
a to pass to the event.
MethodSystem.VoidGets the values of child properties for the row pointed to by .
an object of type
a , pointer to the va_list data structure of arguments (FIXME: clarify what va_lists look like)
MethodSystem.VoidLets the ListStore unref the row at .
a This is an optional method
for models to implement. To be more specific, models may ignore
this call as it exists primarily for performance reasons.For more information on what this means, see
. Please note that
nodes that are deleted are not unreffed.MethodSystem.VoidRemoves all data from the store.MethodSystem.VoidSets the values of child properties for the row pointed to by .
an object of type
a , pointer to the va_list data structure of arguments (FIXME: clarify what va_lists look like)
MethodSystem.VoidSets the value of the specified column in the row pointed by .
a
a , the column number
a The type of specified column must be a .ConstructorInternal constructor
Pointer to the C object.
This is an internal constructor, and should not be used by user code.PropertySystem.Int32The number of columns in this ListStore.A PropertyGtk.TreeModelFlagsThe flags for this ListStore. A Flags are about the shape of this object's data; see the
class documentation for more details.EventSystem.EventHandlerRaised when the sorting column has changed.GLib.Signal("sort_column_changed")EventGtk.RowHasChildToggledHandlerRaised when the display of a given row's children is toggled.GLib.Signal("row_has_child_toggled")EventGtk.RowInsertedHandlerRaised when a row of data is inserted.GLib.Signal("row_inserted")EventGtk.RowDeletedHandlerRaised when a row is deleted.GLib.Signal("row_deleted")EventGtk.RowChangedHandlerRaised when a row has changed.GLib.Signal("row_changed")EventGtk.RowsReorderedHandlerRaised when the order of rows has changed.GLib.Signal("rows_reordered")MethodSystem.BooleanSets to be the child of this ListStore, using the given index. The first index is 0. If is too big, or this ListStore has no rows, is set to an invalid iterator and false is returned. For ListStore objects, the th root node is set, since they don't have a tree-like structure.
a
a a , true if has an th child.This is a custom binding for Gtk# which assumes that the current object is the parent. An alternate invocation form that parallels the C API is available.MethodSystem.Boolean
a
To be added.
a Sets to be the child of , using the given index. The first index is 0. If is too big, or has no children, is set to an invalid iterator and false is returned. will remain a valid node after this function has been called. As a special case, if is , then the th root node is set.
a , true if has an th child.This invocation form is closer to the underlying C API, but it's probably less useful for most C# purposes.MethodSystem.BooleanMarshals a path string into a object that points to a row in this tree.
a to be set by this method
A path string
A , true if this string is a valid path for this ListStore.MethodSystem.Boolean, an object that will be set to point to the first child.
a , the parent row.
A , true if has children.In general, this will return false, as ListStore isn't tree-shaped. However, if is , will return the list itself, since they're all children of the root.MethodSystem.BooleanGets an iterator object for the given .
a to set to point to the row.
a A , true if the row existsMethodSystem.BooleanGets the parent row of .
a to set to point to the row.
a , the child row whose parent we want to get
A , true if the parent exists. Since ListStore objects aren't tree-shaped, this will always return false.MethodGtk.TreeIterSystem.ParamArrayAppends a new row to the ListStore and puts the objects in in it.
a list , one item for each column of a row.
a pointing to the new rowMethodGtk.TreeIterAppends a new row to the ListStore and puts the contents of in it.
a with as many elements as the ListStore has columns.
a pointing to the new rowMethodSystem.StringMarshals the given into a path string.
a a MethodSystem.VoidMove the row pointed to by to the
position after . If
is ,
will be moved to point to the start
of the list.
a
a This only works in unsorted stores.MethodSystem.VoidSwaps rows a and b in the store.
a
a This is only works in unsorted stores.MethodSystem.VoidMove the row pointed to by to the
position before . If
is ,
will be moved to point to the end
of the list.
a
a This only works in unsorted stores.MethodSystem.BooleanTest whether is valid for this ListStore.
a a , true if is valid.WARNING: this method is slow and is only intended for
debugging/testing purposes.ConstructorSystem.ParamArrayCreates a new store. The columns' type specified by the argument.
a
ListStore ls = new ListStore (typeof (string), typeof (int), typeof (double));
...
The above example creates a new three columns list store. The types of the columns are , , and .MethodSystem.BooleanReport on which column is currently being used to sort this ListStore.
a , gets filled with the column number that's currently used for sorting
a , the current type of sort (ascending or descending)
a , false if the default sort column for this ListStore is being used, true if some other sort column is being used.MethodSystem.VoidSets the value of the specified column in the row pointed by iter.
a
a
a The type of specified column must be a .MethodSystem.VoidSets the value of the specified column in the row pointed by iter.
a
a
a The type of specified column must be a .MethodSystem.VoidSets the value of the specified column in the row pointed by iter.
a
a
a The type of specified column must be an .MethodSystem.VoidSets the value of the specified column in the row pointed by iter.
a
a
a The type of specified column must be a .MethodSystem.VoidSets the value of the specified column in the row pointed by iter.
a
a
a The type of specified column must be an MethodSystem.VoidSets the value of the specified column in the row pointed by iter.
a
a
a The type of specified column must be an .MethodSystem.VoidSets the value of the specified column in the row pointed by iter.
a
a
a The type of specified column must be an .MethodSystem.ObjectGets the data from row of column
.
a , the row to look in
a , the column number to look in
a PropertySystem.BooleanFind out whether this ListStore has a default sort function.a , true if there is a default
sort function.To set a default sort function, use the property.PropertyGLib.GTypeGType Property.a Returns the native value for .PropertyGLib.GType[]The types in each column of a ListStore.a
This property is meant primarily for classes that
inherit from , and should
only be used when constructing a new . It will not function after a
row has been added or after a method on the interface has been called.
MethodSystem.VoidDeprecated method to set what types go in each column of a ListStore.
a See MethodGLib.GTypeGets the type of data stored in column number .
a , the column to check
a MethodSystem.VoidDefault handler for the event.
a
a
a Override this method in a subclass to provide a default handler for the event.MethodSystem.VoidDefault handler for the event.
a
a Override this method in a subclass to provide a default handler for the event.MethodSystem.VoidDefault handler for the event.
a Override this method in a subclass to provide a default handler for the event.MethodSystem.VoidDefault handler for the event.
a
a Override this method in a subclass to provide a default handler for the event.MethodSystem.VoidDefault handler for the event.
a
a Override this method in a subclass to provide a default handler for the event.MethodSystem.VoidDefault handler for the event.Override this method in a subclass to provide a default handler for the event.ConstructorProtected Constructor.
a Chain to this constructor if you have manually registered a native value for your subclass.System.ObsoleteConstructorSystem.ParamArrayDefault constructor.
a MethodSystem.Int32Reorders the ListStore.a .(FIXME: Does this binding work?)MethodGtk.TreeIterInserts a new row at position .
a a pointing to the new row. If is larger than the number
of rows on the list, then the new row will be appended to the list.
The row will be empty before this function is called. To set the
value of the new row, use .
MethodGtk.TreeIterAdds a new row to the beginning of the list.a pointing to the new row.
The row will be empty before this function is called. To set the
value of the new row, use .
MethodGtk.TreeIter
Inserts a new row before . If
is null, then the row will be appended
to the end of the list.
a , the row to insert before
a that points to the new row
The row will be empty before this function is called. To set the
value of the new row, use .
MethodGtk.TreeIter
Inserts a new row after . If
is null, then the row will be appended
to the end of the list.
a , the row to insert before
a that points to the new row
The row will be empty before this function is called. To set the
value of the new row, use .
MethodGtk.TreeIterAppends a new row to the ListStore.a that points to the new row.
The row will be empty before this function is called. To set the
value of the new row, use .
MethodSystem.Int32Fires a event.
a , pointer to the row whose children have been reordered
a , pointer to the row whose children have been reordered
a This is part of the implementation of . It should be called by other class methods that reorder rows so that the proper events are raised. (FIXME: since lists don't have parents/children, how does this get used in practice? There should be an example here.)MethodSystem.BooleanRemoves a row from the store.
a a After being removed, is set to be the next valid row, or invalidated if it pointed to the last row in the store.MethodSystem.VoidGets the value of row of column
and puts it in .
a
a
a MethodSystem.BooleanAdvances to the next row.
a a for whether the operation succeeded.ConstructorProtected constructor.MethodSystem.VoidSets a sort function to be used for the column .
A for the column number.
A MethodSystem.Int32To be added
a
a
a
a a To be addedMethodSystem.Collections.IEnumeratorReturns a for the current instance. The enumerated items are object arrays containing the column values for each row.A enumerating items of type []. If the elements of the current instance are modified while an enumeration is in progress, a call to or throws .MethodSystem.Void
Path to the reordered parent node.
Iter corresponding to the reordered parent node.
An array of the old indices.
Default handler for the RowsReordered event.MethodGtk.TreeIterSystem.ParamArray
Insert position.
An array of column values to set.
Inserts a row into the store at a given position with column values.An iter pointing to the inserted row.The values provided should be in column order.MethodSystem.VoidSystem.ParamArray
Update position.
An array of column values to set.
Sets the column values for a given row.The values provided must be in column order.