1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
// Take a look at the license at the top of the repository in the LICENSE file.

use crate::TreeIter;
use crate::TreePath;
use crate::TreeRowReference;
use glib::object::IsA;
use glib::translate::*;
use libc::c_int;

impl TreeRowReference {
    // rustdoc-stripper-ignore-next
    /// This is unsafe because new_order bounds can't be checked.
    // rustdoc-stripper-ignore-next-stop
    /// Lets a set of row reference created by
    /// [`new_proxy()`][Self::new_proxy()] know that the
    /// model emitted the `signal::TreeModel::rows-reordered` signal.
    /// ## `proxy`
    /// a [`glib::Object`][crate::glib::Object]
    /// ## `path`
    /// the parent path of the reordered signal
    /// ## `iter`
    /// the iter pointing to the parent of the reordered
    /// ## `new_order`
    /// the new order of rows
    #[allow(clippy::missing_safety_doc)]
    #[doc(alias = "gtk_tree_row_reference_reordered")]
    pub unsafe fn reordered<T: IsA<glib::Object>>(
        proxy: &T,
        path: &TreePath,
        iter: Option<&TreeIter>,
        new_order: &[u32],
    ) {
        assert_initialized_main_thread!();
        assert!(
            iter.is_some() || path.depth() == 0,
            "If 'iter' is None, 'path' must point to the root."
        );
        ffi::gtk_tree_row_reference_reordered(
            proxy.as_ref().to_glib_none().0,
            mut_override(path.to_glib_none().0),
            mut_override(iter.to_glib_none().0),
            mut_override(new_order.as_ptr() as *const c_int),
        );
    }
}