gtk-sharp2.10.0.0Gtk# is thread aware, but not thread safe; See the Gtk# Thread Programming for details.The selection object for .TreeSelection provides a single class for managing selection information on the List/Tree widget.A TreeSelection object is automatically created when a new widget is created and is inherently tied to it. A TreeSelection cannot exist independently of a . Selection information is retrieved from the with the property.TreeSelection can check the selection status of the tree, as well as select and deselect individual rows. Selection is done completely on the view. As a result, multiple views of the same model can have completely different selections. Additionally, you cannot change the selection of a row that is not currently displayed by the view without expanding its parents first.One of the important things to remember when monitoring the selection of a view is that the event is mostly a hint. For example, it may only fire once when a range of rows is selected. It may also fire when nothing has happened, such as when is called on a row that is already selected.
using System;
using Gtk;
class Selection
{
static void Main ()
{
Application.Init ();
Window win = new Window ("TreeSelection sample");
win.DeleteEvent += OnWinDelete;
TreeView tv = new TreeView ();
tv.AppendColumn ("Items", new CellRendererText (), "text", 0);
ListStore store = new ListStore (typeof (string));
store.AppendValues ("item 1");
store.AppendValues ("item 2");
tv.Model = store;
tv.Selection.Changed += OnSelectionChanged;
win.Add (tv);
win.ShowAll ();
Application.Run ();
}
static void OnSelectionChanged (object o, EventArgs args)
{
TreeIter iter;
TreeModel model;
if (((TreeSelection)o).GetSelected (out model, out iter))
{
string val = (string) model.GetValue (iter, 0);
Console.WriteLine ("{0} was selected", val);
}
}
static void OnWinDelete (object o, DeleteEventArgs args)
{
Application.Quit ();
}
}
GLib.ObjectMethodSystem.VoidSelects the specified row that represents.
A row to be selected.
MethodSystem.BooleanDetermines whether a has been selected in this .
The path to a node whose selected status should be checked.
if is selected, otherwise.MethodSystem.VoidDeselects the specified position in the tree.
The tree position that should be deselected.
See also, and .
using System;
using Gtk;
class TreeSelectionSample
{
Label selected;
static void Main ()
{
Application.Init ();
new TreeSelectionSample ();
Application.Run ();
}
TreeSelectionSample ()
{
Window win = new Window ("TreeView selection sample");
win.SetDefaultSize (400, 300);
win.DeleteEvent += new DeleteEventHandler (OnWinDelete);
HBox hbox = new HBox (false, 0);
TreeView tv = new TreeView ();
tv.Selection.Changed += new EventHandler (OnSelectionChanged);
tv.AppendColumn ("items", new CellRendererText (), "text", 0);
TreeStore store = new TreeStore (typeof (string));
for (int i = 0; i < 10; i++)
{
store.AppendValues ("item " + i.ToString ());
}
tv.Model = store;
hbox.PackStart (tv);
selected = new Label ();
hbox.PackStart (selected);
win.Add (hbox);
win.ShowAll ();
}
void OnSelectionChanged (object o, EventArgs args)
{
TreeSelection ts = (TreeSelection) o;
TreeIter iter;
TreeModel model;
ts.GetSelected (out model, out iter);
selected.Text = (string) model.GetValue (iter, 0);
}
void OnWinDelete (object o, DeleteEventArgs args)
{
Application.Quit ();
}
}
MethodSystem.BooleanDetermine if the iter is selected.
The tree location to check
if the tree node specified by is selected, otherwise.See also .MethodSystem.VoidSelects every node in this .The must be set to for this method to work.MethodSystem.VoidDeselects the tree node that refers to.
A node in the tree.
See also .MethodSystem.VoidSelects all the nodes that appear between and .
The first node to select on the tree.
The last node to select on the tree.
MethodSystem.VoidSets all nodes in the as unselected.MethodSystem.VoidInvokes the delegate passed in by for each selected row in the .
The delegate that should be called for each selected row.
This method is useful when the of this TreeSelection is set to . It is currently the only way to access selection information for multiple rows. See the class overview for an example on how to effectively use this method for selection tracking.MethodSystem.VoidAdd a hook into selection and unselection.
A delegate to invoke before a node is (un)selected.
ignored
ignored
This method is obsolete. New code should use the property.PropertyGtk.TreeSelectionFuncA hook into selection and unselectiona If set, is called before any node is selected or unselected, giving some control over which nodes are selected. The select function should return if the state of the node may be toggled, and if the state of the node should be left unchanged.MethodSystem.VoidSelects the specified .
Indicates which row to select.
See also and .ConstructorInternal constructor
Pointer to the C object.
This is an internal constructor, and should not be used by user code.PropertyGtk.SelectionModeManages the way rows can be selected.The current mode dictating selection behaviour.Rows may be deselected by changing this property. For example, if rows are selected and the mode is changed to or .PropertySystem.IntPtrGet the data associated with the that has been setup for this .The raw data that was set when was called.PropertyGtk.TreeViewGet the that this is associated with.The that this is tied to.A object can only be retrieved from a . That is done with its property.EventSystem.EventHandlerRaised when the selection (may have) changed.This event is mostly a hint. It may only be raised once when a range of rows are selected, and it may occasionally be raised when nothing has happened.GLib.Signal("changed")MethodSystem.VoidUnselects everything between one path and another. to begin range.
to end range.
MethodSystem.Int32Get the number of selected rows.The number of selected rowsMethodSystem.BooleanGet information about the currently selected node.
A convenient accessor to the that this TreeSelection's is associated with.
The position that was selected.
if a row was selected.This method will not work if the TreeSelection has been set to . In that case you should use .PropertyGLib.GTypeGType Property.a Returns the native value for .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.ObsoleteMethodGtk.TreePath[]Returns an array of s representing the selected rows.
The model the is bound to.
Selected rows in an array of sConstructorProtected constructor.MethodGtk.TreePath[]Returns an array of s representing the selected rows.Selected rows in an array of sMethodSystem.Boolean
The position that was selected.
Gets information about the currently selected node. if a row is selected.This convenience method doesnt require an out . It is useful in the case that you already have a copy of the TreeModel.