Struct TreeSelection

source

pub struct TreeSelection { /* private fields */ }

👎Deprecated: Since 4.10

Expand description

Use SelectionModel instead The selection object for GtkTreeView

The TreeSelection object is a helper object to manage the selection for a TreeView widget. The TreeSelection object is automatically created when a new TreeView widget is created, and cannot exist independently of this widget. The primary reason the TreeSelection objects exists is for cleanliness of code and API. That is, there is no conceptual reason all these functions could not be methods on the TreeView widget instead of a separate function.

The TreeSelection object is gotten from a TreeView by calling gtk_tree_view_get_selection(). It can be manipulated to check the selection status of the tree, as well as select and deselect individual rows. Selection is done completely view side. As a result, multiple views of the same model can have completely different selections. Additionally, you cannot change the selection of a row on the model 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 TreeSelection::changed signal is mostly a hint. That is, it may only emit one signal when a range of rows is selected. Additionally, it may on occasion emit a TreeSelection::changed signal when nothing has happened (mostly as a result of programmers calling select_row on an already selected row).

§Properties

§`mode`

Selection mode. See gtk_tree_selection_set_mode() for more information on this property.

Readable | Writeable

§Signals

§`changed`

Emitted whenever the selection has (possibly) changed. Please note that this signal is mostly a hint. It may only be emitted once when a range of rows are selected, and it may occasionally be emitted when nothing has happened.

§Implements

[trait@glib::ObjectExt]

GLib type: GObject with reference counted clone semantics.

Struct TreeSelectionCopy item path

§Properties

§mode

§Signals

§changed

§Implements

Implementations§

impl TreeSelection

pub fn count_selected_rows(&self) -> i32

§Deprecated since 4.10

§Returns

pub fn mode(&self) -> SelectionMode

§Deprecated since 4.10

§Returns

pub fn selected(&self) -> Option<(TreeModel, TreeIter)>

§Deprecated since 4.10

§Returns

§model

§iter

pub fn selected_rows(&self) -> (Vec<TreePath>, TreeModel)

§Deprecated since 4.10

§Returns

§model

pub fn tree_view(&self) -> TreeView

§Deprecated since 4.10

§Returns

pub fn iter_is_selected(&self, iter: &TreeIter) -> bool

§Deprecated since 4.10

§iter

§Returns

pub fn path_is_selected(&self, path: &TreePath) -> bool

§Deprecated since 4.10

§path

§Returns

pub fn select_all(&self)

§Deprecated since 4.10

pub fn select_iter(&self, iter: &TreeIter)

§Deprecated since 4.10

§iter

pub fn select_path(&self, path: &TreePath)

§Deprecated since 4.10

§path

pub fn select_range(&self, start_path: &TreePath, end_path: &TreePath)

§Deprecated since 4.10

§start_path

§end_path

pub fn selected_foreach<P: FnMut(&TreeModel, &TreePath, &TreeIter)>( &self, func: P, )

§Deprecated since 4.10

§func

pub fn set_mode(&self, type_: SelectionMode)

§Deprecated since 4.10

§type_

pub fn set_select_function<P: Fn(&TreeSelection, &TreeModel, &TreePath, bool) -> bool + 'static>( &self, func: P, )

§Deprecated since 4.10

§func

pub fn unselect_all(&self)

§Deprecated since 4.10

pub fn unselect_iter(&self, iter: &TreeIter)

§Deprecated since 4.10

§iter

pub fn unselect_path(&self, path: &TreePath)

§Deprecated since 4.10

§path

pub fn unselect_range(&self, start_path: &TreePath, end_path: &TreePath)

§Deprecated since 4.10

§start_path

§end_path

pub fn connect_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId

pub fn connect_mode_notify<F: Fn(&Self) + 'static>( &self, f: F, ) -> SignalHandlerId

impl TreeSelection

pub fn unset_select_function(&self)

Trait Implementations§

impl Clone for TreeSelection

fn clone(&self) -> Self

fn clone_from(&mut self, source: &Self)

impl Debug for TreeSelection

fn fmt(&self, f: &mut Formatter<'_>) -> Result

impl HasParamSpec for TreeSelection

type ParamSpec = ParamSpecObject

type SetValue = TreeSelection

Struct TreeSelection

§`mode`

§`changed`

§`model`

§`iter`

§`model`

§`iter`

§`path`

§`iter`

§`path`

§`start_path`

§`end_path`

§`func`

§`type_`

§`func`

§`iter`

§`path`

§`start_path`

§`end_path`

fn hash<H>(&self, state: &mut H)
where H: Hasher,

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

fn max(self, other: Self) -> Self
where Self: Sized,

fn min(self, other: Self) -> Self
where Self: Sized,

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized,

impl<T> Any for T
where T: 'static + ?Sized,

impl<T> Borrow<T> for T
where T: ?Sized,

impl<T> BorrowMut<T> for T
where T: ?Sized,

impl<T> Cast for T
where T: ObjectType,

fn upcast<T>(self) -> T
where T: ObjectType, Self: IsA<T>,

fn upcast_ref<T>(&self) -> &T
where T: ObjectType, Self: IsA<T>,

fn downcast<T>(self) -> Result<T, Self>
where T: ObjectType, Self: MayDowncastTo<T>,

fn downcast_ref<T>(&self) -> Option<&T>
where T: ObjectType, Self: MayDowncastTo<T>,

fn dynamic_cast<T>(self) -> Result<T, Self>
where T: ObjectType,

fn dynamic_cast_ref<T>(&self) -> Option<&T>
where T: ObjectType,

unsafe fn unsafe_cast<T>(self) -> T
where T: ObjectType,

unsafe fn unsafe_cast_ref<T>(&self) -> &T
where T: ObjectType,

impl<T> CloneToUninit for T
where T: Clone,

impl<T> FromGlibContainerAsVec<<T as GlibPtrDefault>::GlibType, *const GList> for T
where T: GlibPtrDefault + FromGlibPtrNone<<T as GlibPtrDefault>::GlibType> + FromGlibPtrFull<<T as GlibPtrDefault>::GlibType>,

impl<T> FromGlibContainerAsVec<<T as GlibPtrDefault>::GlibType, *const GPtrArray> for T
where T: GlibPtrDefault + FromGlibPtrNone<<T as GlibPtrDefault>::GlibType> + FromGlibPtrFull<<T as GlibPtrDefault>::GlibType>,

impl<T> FromGlibContainerAsVec<<T as GlibPtrDefault>::GlibType, *const GSList> for T
where T: GlibPtrDefault + FromGlibPtrNone<<T as GlibPtrDefault>::GlibType> + FromGlibPtrFull<<T as GlibPtrDefault>::GlibType>,