gtk4/auto/

tree_selection.rs

// This file was generated by gir (https://github.com/gtk-rs/gir)
// from gir-files (https://github.com/gtk-rs/gir-files)
// DO NOT EDIT
#![allow(deprecated)]

use crate::{ffi, SelectionMode, TreeIter, TreeModel, TreePath, TreeView};
use glib::{
    object::ObjectType as _,
    prelude::*,
    signal::{connect_raw, SignalHandlerId},
    translate::*,
};
use std::boxed::Box as Box_;

glib::wrapper! {
    /// Use [`SelectionModel`][crate::SelectionModel] instead
    /// The selection object for GtkTreeView
    ///
    /// The [`TreeSelection`][crate::TreeSelection] object is a helper object to manage the selection
    /// for a [`TreeView`][crate::TreeView] widget.  The [`TreeSelection`][crate::TreeSelection] object is
    /// automatically created when a new [`TreeView`][crate::TreeView] widget is created, and
    /// cannot exist independently of this widget.  The primary reason the
    /// [`TreeSelection`][crate::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`][crate::TreeView] widget instead of a separate function.
    ///
    /// The [`TreeSelection`][crate::TreeSelection] object is gotten from a [`TreeView`][crate::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`][crate::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`][crate::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`]
    #[doc(alias = "GtkTreeSelection")]
    pub struct TreeSelection(Object<ffi::GtkTreeSelection>);

    match fn {
        type_ => || ffi::gtk_tree_selection_get_type(),
    }
}

impl TreeSelection {
    /// Returns the number of rows that have been selected in @tree.
    ///
    /// # Deprecated since 4.10
    ///
    /// Use GtkListView or GtkColumnView
    ///
    /// # Returns
    ///
    /// The number of rows selected.
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_tree_selection_count_selected_rows")]
    pub fn count_selected_rows(&self) -> i32 {
        unsafe { ffi::gtk_tree_selection_count_selected_rows(self.to_glib_none().0) }
    }

    /// Gets the selection mode for @self. See
    /// gtk_tree_selection_set_mode().
    ///
    /// # Deprecated since 4.10
    ///
    /// Use GtkListView or GtkColumnView
    ///
    /// # Returns
    ///
    /// the current selection mode
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_tree_selection_get_mode")]
    #[doc(alias = "get_mode")]
    pub fn mode(&self) -> SelectionMode {
        unsafe { from_glib(ffi::gtk_tree_selection_get_mode(self.to_glib_none().0)) }
    }

    /// Sets @iter to the currently selected node if @self is set to
    /// [`SelectionMode::Single`][crate::SelectionMode::Single] or [`SelectionMode::Browse`][crate::SelectionMode::Browse].  @iter may be NULL if you
    /// just want to test if @self has any selected nodes.  @model is filled
    /// with the current model as a convenience.  This function will not work if you
    /// use @self is [`SelectionMode::Multiple`][crate::SelectionMode::Multiple].
    ///
    /// # Deprecated since 4.10
    ///
    /// Use GtkListView or GtkColumnView
    ///
    /// # Returns
    ///
    /// TRUE, if there is a selected node.
    ///
    /// ## `model`
    /// A pointer to set to the [`TreeModel`][crate::TreeModel]
    ///
    /// ## `iter`
    /// The [`TreeIter`][crate::TreeIter]
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_tree_selection_get_selected")]
    #[doc(alias = "get_selected")]
    pub fn selected(&self) -> Option<(TreeModel, TreeIter)> {
        unsafe {
            let mut model = std::ptr::null_mut();
            let mut iter = TreeIter::uninitialized();
            let ret = from_glib(ffi::gtk_tree_selection_get_selected(
                self.to_glib_none().0,
                &mut model,
                iter.to_glib_none_mut().0,
            ));
            if ret {
                Some((from_glib_none(model), iter))
            } else {
                None
            }
        }
    }

    /// Creates a list of path of all selected rows. Additionally, if you are
    /// planning on modifying the model after calling this function, you may
    /// want to convert the returned list into a list of [`TreeRowReference`][crate::TreeRowReference]s.
    /// To do this, you can use gtk_tree_row_reference_new().
    ///
    /// To free the return value, use:
    ///
    /// **⚠️ The following code is in c ⚠️**
    ///
    /// ```c
    /// g_list_free_full (list, (GDestroyNotify) gtk_tree_path_free);
    /// ```
    ///
    /// # Deprecated since 4.10
    ///
    /// Use GtkListView or GtkColumnView
    ///
    /// # Returns
    ///
    /// A `GList` containing a [`TreePath`][crate::TreePath] for each selected row.
    ///
    /// ## `model`
    /// A pointer to set to the [`TreeModel`][crate::TreeModel]
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_tree_selection_get_selected_rows")]
    #[doc(alias = "get_selected_rows")]
    pub fn selected_rows(&self) -> (Vec<TreePath>, TreeModel) {
        unsafe {
            let mut model = std::ptr::null_mut();
            let ret = FromGlibPtrContainer::from_glib_full(
                ffi::gtk_tree_selection_get_selected_rows(self.to_glib_none().0, &mut model),
            );
            (ret, from_glib_none(model))
        }
    }

    /// Returns the tree view associated with @self.
    ///
    /// # Deprecated since 4.10
    ///
    /// Use GtkListView or GtkColumnView
    ///
    /// # Returns
    ///
    /// A [`TreeView`][crate::TreeView]
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_tree_selection_get_tree_view")]
    #[doc(alias = "get_tree_view")]
    pub fn tree_view(&self) -> TreeView {
        unsafe { from_glib_none(ffi::gtk_tree_selection_get_tree_view(self.to_glib_none().0)) }
    }

    /// Returns [`true`] if the row at @iter is currently selected.
    ///
    /// # Deprecated since 4.10
    ///
    /// Use GtkListView or GtkColumnView
    /// ## `iter`
    /// A valid [`TreeIter`][crate::TreeIter]
    ///
    /// # Returns
    ///
    /// [`true`], if @iter is selected
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_tree_selection_iter_is_selected")]
    pub fn iter_is_selected(&self, iter: &TreeIter) -> bool {
        unsafe {
            from_glib(ffi::gtk_tree_selection_iter_is_selected(
                self.to_glib_none().0,
                mut_override(iter.to_glib_none().0),
            ))
        }
    }

    /// Returns [`true`] if the row pointed to by @path is currently selected.  If @path
    /// does not point to a valid location, [`false`] is returned
    ///
    /// # Deprecated since 4.10
    ///
    /// Use GtkListView or GtkColumnView
    /// ## `path`
    /// A [`TreePath`][crate::TreePath] to check selection on.
    ///
    /// # Returns
    ///
    /// [`true`] if @path is selected.
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_tree_selection_path_is_selected")]
    pub fn path_is_selected(&self, path: &TreePath) -> bool {
        unsafe {
            from_glib(ffi::gtk_tree_selection_path_is_selected(
                self.to_glib_none().0,
                mut_override(path.to_glib_none().0),
            ))
        }
    }

    /// Selects all the nodes. @self must be set to [`SelectionMode::Multiple`][crate::SelectionMode::Multiple]
    /// mode.
    ///
    /// # Deprecated since 4.10
    ///
    /// Use GtkListView or GtkColumnView
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_tree_selection_select_all")]
    pub fn select_all(&self) {
        unsafe {
            ffi::gtk_tree_selection_select_all(self.to_glib_none().0);
        }
    }

    /// Selects the specified iterator.
    ///
    /// # Deprecated since 4.10
    ///
    /// Use GtkListView or GtkColumnView
    /// ## `iter`
    /// The [`TreeIter`][crate::TreeIter] to be selected.
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_tree_selection_select_iter")]
    pub fn select_iter(&self, iter: &TreeIter) {
        unsafe {
            ffi::gtk_tree_selection_select_iter(
                self.to_glib_none().0,
                mut_override(iter.to_glib_none().0),
            );
        }
    }

    /// Select the row at @path.
    ///
    /// # Deprecated since 4.10
    ///
    /// Use GtkListView or GtkColumnView
    /// ## `path`
    /// The [`TreePath`][crate::TreePath] to be selected.
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_tree_selection_select_path")]
    pub fn select_path(&self, path: &TreePath) {
        unsafe {
            ffi::gtk_tree_selection_select_path(
                self.to_glib_none().0,
                mut_override(path.to_glib_none().0),
            );
        }
    }

    /// Selects a range of nodes, determined by @start_path and @end_path inclusive.
    /// @self must be set to [`SelectionMode::Multiple`][crate::SelectionMode::Multiple] mode.
    ///
    /// # Deprecated since 4.10
    ///
    /// Use GtkListView or GtkColumnView
    /// ## `start_path`
    /// The initial node of the range.
    /// ## `end_path`
    /// The final node of the range.
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_tree_selection_select_range")]
    pub fn select_range(&self, start_path: &TreePath, end_path: &TreePath) {
        unsafe {
            ffi::gtk_tree_selection_select_range(
                self.to_glib_none().0,
                mut_override(start_path.to_glib_none().0),
                mut_override(end_path.to_glib_none().0),
            );
        }
    }

    /// Calls a function for each selected node. Note that you cannot modify
    /// the tree or selection from within this function. As a result,
    /// gtk_tree_selection_get_selected_rows() might be more useful.
    ///
    /// # Deprecated since 4.10
    ///
    /// Use GtkListView or GtkColumnView
    /// ## `func`
    /// The function to call for each selected node.
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_tree_selection_selected_foreach")]
    pub fn selected_foreach<P: FnMut(&TreeModel, &TreePath, &TreeIter)>(&self, func: P) {
        let mut func_data: P = func;
        unsafe extern "C" fn func_func<P: FnMut(&TreeModel, &TreePath, &TreeIter)>(
            model: *mut ffi::GtkTreeModel,
            path: *mut ffi::GtkTreePath,
            iter: *mut ffi::GtkTreeIter,
            data: glib::ffi::gpointer,
        ) {
            let model = from_glib_borrow(model);
            let path = from_glib_borrow(path);
            let iter = from_glib_borrow(iter);
            let callback = data as *mut P;
            (*callback)(&model, &path, &iter)
        }
        let func = Some(func_func::<P> as _);
        let super_callback0: &mut P = &mut func_data;
        unsafe {
            ffi::gtk_tree_selection_selected_foreach(
                self.to_glib_none().0,
                func,
                super_callback0 as *mut _ as *mut _,
            );
        }
    }

    /// Sets the selection mode of the @self.  If the previous type was
    /// [`SelectionMode::Multiple`][crate::SelectionMode::Multiple], then the anchor is kept selected, if it was
    /// previously selected.
    ///
    /// # Deprecated since 4.10
    ///
    /// Use GtkListView or GtkColumnView
    /// ## `type_`
    /// The selection mode
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_tree_selection_set_mode")]
    #[doc(alias = "mode")]
    pub fn set_mode(&self, type_: SelectionMode) {
        unsafe {
            ffi::gtk_tree_selection_set_mode(self.to_glib_none().0, type_.into_glib());
        }
    }

    /// Sets the selection function.
    ///
    /// If set, this function is called before any node is selected or unselected,
    /// giving some control over which nodes are selected. The select function
    /// should return [`true`] if the state of the node may be toggled, and [`false`]
    /// if the state of the node should be left unchanged.
    ///
    /// # Deprecated since 4.10
    ///
    /// Use GtkListView or GtkColumnView
    /// ## `func`
    /// The selection function. May be [`None`]
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_tree_selection_set_select_function")]
    pub fn set_select_function<
        P: Fn(&TreeSelection, &TreeModel, &TreePath, bool) -> bool + 'static,
    >(
        &self,
        func: P,
    ) {
        let func_data: Box_<P> = Box_::new(func);
        unsafe extern "C" fn func_func<
            P: Fn(&TreeSelection, &TreeModel, &TreePath, bool) -> bool + 'static,
        >(
            selection: *mut ffi::GtkTreeSelection,
            model: *mut ffi::GtkTreeModel,
            path: *mut ffi::GtkTreePath,
            path_currently_selected: glib::ffi::gboolean,
            data: glib::ffi::gpointer,
        ) -> glib::ffi::gboolean {
            let selection = from_glib_borrow(selection);
            let model = from_glib_borrow(model);
            let path = from_glib_borrow(path);
            let path_currently_selected = from_glib(path_currently_selected);
            let callback = &*(data as *mut P);
            (*callback)(&selection, &model, &path, path_currently_selected).into_glib()
        }
        let func = Some(func_func::<P> as _);
        unsafe extern "C" fn destroy_func<
            P: Fn(&TreeSelection, &TreeModel, &TreePath, bool) -> bool + 'static,
        >(
            data: glib::ffi::gpointer,
        ) {
            let _callback = Box_::from_raw(data as *mut P);
        }
        let destroy_call3 = Some(destroy_func::<P> as _);
        let super_callback0: Box_<P> = func_data;
        unsafe {
            ffi::gtk_tree_selection_set_select_function(
                self.to_glib_none().0,
                func,
                Box_::into_raw(super_callback0) as *mut _,
                destroy_call3,
            );
        }
    }

    /// Unselects all the nodes.
    ///
    /// # Deprecated since 4.10
    ///
    /// Use GtkListView or GtkColumnView
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_tree_selection_unselect_all")]
    pub fn unselect_all(&self) {
        unsafe {
            ffi::gtk_tree_selection_unselect_all(self.to_glib_none().0);
        }
    }

    /// Unselects the specified iterator.
    ///
    /// # Deprecated since 4.10
    ///
    /// Use GtkListView or GtkColumnView
    /// ## `iter`
    /// The [`TreeIter`][crate::TreeIter] to be unselected.
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_tree_selection_unselect_iter")]
    pub fn unselect_iter(&self, iter: &TreeIter) {
        unsafe {
            ffi::gtk_tree_selection_unselect_iter(
                self.to_glib_none().0,
                mut_override(iter.to_glib_none().0),
            );
        }
    }

    /// Unselects the row at @path.
    ///
    /// # Deprecated since 4.10
    ///
    /// Use GtkListView or GtkColumnView
    /// ## `path`
    /// The [`TreePath`][crate::TreePath] to be unselected.
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_tree_selection_unselect_path")]
    pub fn unselect_path(&self, path: &TreePath) {
        unsafe {
            ffi::gtk_tree_selection_unselect_path(
                self.to_glib_none().0,
                mut_override(path.to_glib_none().0),
            );
        }
    }

    /// Unselects a range of nodes, determined by @start_path and @end_path
    /// inclusive.
    ///
    /// # Deprecated since 4.10
    ///
    /// Use GtkListView or GtkColumnView
    /// ## `start_path`
    /// The initial node of the range.
    /// ## `end_path`
    /// The initial node of the range.
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_tree_selection_unselect_range")]
    pub fn unselect_range(&self, start_path: &TreePath, end_path: &TreePath) {
        unsafe {
            ffi::gtk_tree_selection_unselect_range(
                self.to_glib_none().0,
                mut_override(start_path.to_glib_none().0),
                mut_override(end_path.to_glib_none().0),
            );
        }
    }

    /// 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.
    #[doc(alias = "changed")]
    pub fn connect_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn changed_trampoline<F: Fn(&TreeSelection) + 'static>(
            this: *mut ffi::GtkTreeSelection,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(&from_glib_borrow(this))
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"changed".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    changed_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "mode")]
    pub fn connect_mode_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_mode_trampoline<F: Fn(&TreeSelection) + 'static>(
            this: *mut ffi::GtkTreeSelection,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(&from_glib_borrow(this))
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"notify::mode".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_mode_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}