gtk/auto/

cell_area.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

use crate::{
    Buildable, CellAreaContext, CellEditable, CellLayout, CellRenderer, CellRendererState,
    DirectionType, Orientation, SizeRequestMode, TreeIter, TreeModel, TreePath, Widget, ffi,
};
use glib::{
    object::ObjectType as _,
    prelude::*,
    signal::{SignalHandlerId, connect_raw},
    translate::*,
};
use std::boxed::Box as Box_;

glib::wrapper! {
    /// iter);
    ///  }
    ///  }
    ///  }
    ///  }
    ///  return have_focus;
    /// }
    /// ]|
    ///
    /// Note that the layouting widget is responsible for matching the
    /// GtkDirectionType values to the way it lays out its cells.
    ///
    /// # Cell Properties
    ///
    /// The [`CellArea`][crate::CellArea] introduces cell properties for `GtkCellRenderers`
    /// in very much the same way that [`Container`][crate::Container] introduces
    /// [child properties][child-properties]
    /// for `GtkWidgets`. This provides some general interfaces for defining
    /// the relationship cell areas have with their cells. For instance in a
    /// [`CellAreaBox`][crate::CellAreaBox] a cell might “expand” and receive extra space when
    /// the area is allocated more than its full natural request, or a cell
    /// might be configured to “align” with adjacent rows which were requested
    /// and rendered with the same [`CellAreaContext`][crate::CellAreaContext].
    ///
    /// Use `gtk_cell_area_class_install_cell_property()` to install cell
    /// properties for a cell area class and `gtk_cell_area_class_find_cell_property()`
    /// or `gtk_cell_area_class_list_cell_properties()` to get information about
    /// existing cell properties.
    ///
    /// To set the value of a cell property, use [`CellAreaExt::cell_set_property()`][crate::prelude::CellAreaExt::cell_set_property()],
    /// `gtk_cell_area_cell_set()` or `gtk_cell_area_cell_set_valist()`. To obtain
    /// the value of a cell property, use [`CellAreaExt::cell_get_property()`][crate::prelude::CellAreaExt::cell_get_property()],
    /// `gtk_cell_area_cell_get()` or `gtk_cell_area_cell_get_valist()`.
    ///
    /// This is an Abstract Base Class, you cannot instantiate it.
    ///
    /// ## Properties
    ///
    ///
    /// #### `edit-widget`
    ///  The widget currently editing the edited cell
    ///
    /// This property is read-only and only changes as
    /// a result of a call [`CellAreaExt::activate_cell()`][crate::prelude::CellAreaExt::activate_cell()].
    ///
    /// Readable
    ///
    ///
    /// #### `edited-cell`
    ///  The cell in the area that is currently edited
    ///
    /// This property is read-only and only changes as
    /// a result of a call [`CellAreaExt::activate_cell()`][crate::prelude::CellAreaExt::activate_cell()].
    ///
    /// Readable
    ///
    ///
    /// #### `focus-cell`
    ///  The cell in the area that currently has focus
    ///
    /// Readable | Writable
    ///
    /// ## Signals
    ///
    ///
    /// #### `add-editable`
    ///  Indicates that editing has started on `renderer` and that `editable`
    /// should be added to the owning cell-layouting widget at `cell_area`.
    ///
    ///
    ///
    ///
    /// #### `apply-attributes`
    ///  This signal is emitted whenever applying attributes to `area` from `model`
    ///
    ///
    ///
    ///
    /// #### `focus-changed`
    ///  Indicates that focus changed on this `area`. This signal
    /// is emitted either as a result of focus handling or event
    /// handling.
    ///
    /// It's possible that the signal is emitted even if the
    /// currently focused renderer did not change, this is
    /// because focus may change to the same renderer in the
    /// same cell area for a different row of data.
    ///
    ///
    ///
    ///
    /// #### `remove-editable`
    ///  Indicates that editing finished on `renderer` and that `editable`
    /// should be removed from the owning cell-layouting widget.
    ///
    ///
    ///
    /// # Implements
    ///
    /// [`CellAreaExt`][trait@crate::prelude::CellAreaExt], [`trait@glib::ObjectExt`], [`BuildableExt`][trait@crate::prelude::BuildableExt], [`CellLayoutExt`][trait@crate::prelude::CellLayoutExt], [`BuildableExtManual`][trait@crate::prelude::BuildableExtManual]
    #[doc(alias = "GtkCellArea")]
    pub struct CellArea(Object<ffi::GtkCellArea, ffi::GtkCellAreaClass>) @implements Buildable, CellLayout;

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

impl CellArea {
    pub const NONE: Option<&'static CellArea> = None;
}

/// Trait containing all [`struct@CellArea`] methods.
///
/// # Implementors
///
/// [`CellAreaBox`][struct@crate::CellAreaBox], [`CellArea`][struct@crate::CellArea]
pub trait CellAreaExt: IsA<CellArea> + 'static {
    /// Activates `self`, usually by activating the currently focused
    /// cell, however some subclasses which embed widgets in the area
    /// can also activate a widget if it currently has the focus.
    /// ## `context`
    /// the [`CellAreaContext`][crate::CellAreaContext] in context with the current row data
    /// ## `widget`
    /// the [`Widget`][crate::Widget] that `self` is rendering on
    /// ## `cell_area`
    /// the size and location of `self` relative to `widget`’s allocation
    /// ## `flags`
    /// the [`CellRendererState`][crate::CellRendererState] flags for `self` for this row of data.
    /// ## `edit_only`
    /// if [`true`] then only cell renderers that are [`CellRendererMode::Editable`][crate::CellRendererMode::Editable]
    ///  will be activated.
    ///
    /// # Returns
    ///
    /// Whether `self` was successfully activated.
    #[doc(alias = "gtk_cell_area_activate")]
    fn activate(
        &self,
        context: &impl IsA<CellAreaContext>,
        widget: &impl IsA<Widget>,
        cell_area: &gdk::Rectangle,
        flags: CellRendererState,
        edit_only: bool,
    ) -> bool {
        unsafe {
            from_glib(ffi::gtk_cell_area_activate(
                self.as_ref().to_glib_none().0,
                context.as_ref().to_glib_none().0,
                widget.as_ref().to_glib_none().0,
                cell_area.to_glib_none().0,
                flags.into_glib(),
                edit_only.into_glib(),
            ))
        }
    }

    /// `activate()`
    /// implementation.
    /// ## `widget`
    /// the [`Widget`][crate::Widget] that `self` is rendering onto
    /// ## `renderer`
    /// the [`CellRenderer`][crate::CellRenderer] in `self` to activate
    /// ## `event`
    /// the `GdkEvent` for which cell activation should occur
    /// ## `cell_area`
    /// the [`gdk::Rectangle`][crate::gdk::Rectangle] in `widget` relative coordinates
    ///  of `renderer` for the current row.
    /// ## `flags`
    /// the [`CellRendererState`][crate::CellRendererState] for `renderer`
    ///
    /// # Returns
    ///
    /// whether cell activation was successful
    #[doc(alias = "gtk_cell_area_activate_cell")]
    fn activate_cell(
        &self,
        widget: &impl IsA<Widget>,
        renderer: &impl IsA<CellRenderer>,
        event: &gdk::Event,
        cell_area: &gdk::Rectangle,
        flags: CellRendererState,
    ) -> bool {
        unsafe {
            from_glib(ffi::gtk_cell_area_activate_cell(
                self.as_ref().to_glib_none().0,
                widget.as_ref().to_glib_none().0,
                renderer.as_ref().to_glib_none().0,
                mut_override(event.to_glib_none().0),
                cell_area.to_glib_none().0,
                flags.into_glib(),
            ))
        }
    }

    /// Adds `renderer` to `self` with the default child cell properties.
    /// ## `renderer`
    /// the [`CellRenderer`][crate::CellRenderer] to add to `self`
    #[doc(alias = "gtk_cell_area_add")]
    fn add(&self, renderer: &impl IsA<CellRenderer>) {
        unsafe {
            ffi::gtk_cell_area_add(
                self.as_ref().to_glib_none().0,
                renderer.as_ref().to_glib_none().0,
            );
        }
    }

    /// Adds `sibling` to `renderer`’s focusable area, focus will be drawn
    /// around `renderer` and all of its siblings if `renderer` can
    /// focus for a given row.
    ///
    /// Events handled by focus siblings can also activate the given
    /// focusable `renderer`.
    /// ## `renderer`
    /// the [`CellRenderer`][crate::CellRenderer] expected to have focus
    /// ## `sibling`
    /// the [`CellRenderer`][crate::CellRenderer] to add to `renderer`’s focus area
    #[doc(alias = "gtk_cell_area_add_focus_sibling")]
    fn add_focus_sibling(
        &self,
        renderer: &impl IsA<CellRenderer>,
        sibling: &impl IsA<CellRenderer>,
    ) {
        unsafe {
            ffi::gtk_cell_area_add_focus_sibling(
                self.as_ref().to_glib_none().0,
                renderer.as_ref().to_glib_none().0,
                sibling.as_ref().to_glib_none().0,
            );
        }
    }

    //#[doc(alias = "gtk_cell_area_add_with_properties")]
    //fn add_with_properties(&self, renderer: &impl IsA<CellRenderer>, first_prop_name: &str, : /*Unknown conversion*//*Unimplemented*/Basic: VarArgs) {
    //    unsafe { TODO: call ffi:gtk_cell_area_add_with_properties() }
    //}

    /// Applies any connected attributes to the renderers in
    /// `self` by pulling the values from `tree_model`.
    /// ## `tree_model`
    /// the [`TreeModel`][crate::TreeModel] to pull values from
    /// ## `iter`
    /// the [`TreeIter`][crate::TreeIter] in `tree_model` to apply values for
    /// ## `is_expander`
    /// whether `iter` has children
    /// ## `is_expanded`
    /// whether `iter` is expanded in the view and
    ///  children are visible
    #[doc(alias = "gtk_cell_area_apply_attributes")]
    fn apply_attributes(
        &self,
        tree_model: &impl IsA<TreeModel>,
        iter: &TreeIter,
        is_expander: bool,
        is_expanded: bool,
    ) {
        unsafe {
            ffi::gtk_cell_area_apply_attributes(
                self.as_ref().to_glib_none().0,
                tree_model.as_ref().to_glib_none().0,
                mut_override(iter.to_glib_none().0),
                is_expander.into_glib(),
                is_expanded.into_glib(),
            );
        }
    }

    /// Connects an `attribute` to apply values from `column` for the
    /// [`TreeModel`][crate::TreeModel] in use.
    /// ## `renderer`
    /// the [`CellRenderer`][crate::CellRenderer] to connect an attribute for
    /// ## `attribute`
    /// the attribute name
    /// ## `column`
    /// the [`TreeModel`][crate::TreeModel] column to fetch attribute values from
    #[doc(alias = "gtk_cell_area_attribute_connect")]
    fn attribute_connect(&self, renderer: &impl IsA<CellRenderer>, attribute: &str, column: i32) {
        unsafe {
            ffi::gtk_cell_area_attribute_connect(
                self.as_ref().to_glib_none().0,
                renderer.as_ref().to_glib_none().0,
                attribute.to_glib_none().0,
                column,
            );
        }
    }

    /// Disconnects `attribute` for the `renderer` in `self` so that
    /// attribute will no longer be updated with values from the
    /// model.
    /// ## `renderer`
    /// the [`CellRenderer`][crate::CellRenderer] to disconnect an attribute for
    /// ## `attribute`
    /// the attribute name
    #[doc(alias = "gtk_cell_area_attribute_disconnect")]
    fn attribute_disconnect(&self, renderer: &impl IsA<CellRenderer>, attribute: &str) {
        unsafe {
            ffi::gtk_cell_area_attribute_disconnect(
                self.as_ref().to_glib_none().0,
                renderer.as_ref().to_glib_none().0,
                attribute.to_glib_none().0,
            );
        }
    }

    /// Returns the model column that an attribute has been mapped to,
    /// or -1 if the attribute is not mapped.
    /// ## `renderer`
    /// a [`CellRenderer`][crate::CellRenderer]
    /// ## `attribute`
    /// an attribute on the renderer
    ///
    /// # Returns
    ///
    /// the model column, or -1
    #[doc(alias = "gtk_cell_area_attribute_get_column")]
    fn attribute_get_column(&self, renderer: &impl IsA<CellRenderer>, attribute: &str) -> i32 {
        unsafe {
            ffi::gtk_cell_area_attribute_get_column(
                self.as_ref().to_glib_none().0,
                renderer.as_ref().to_glib_none().0,
                attribute.to_glib_none().0,
            )
        }
    }

    //#[doc(alias = "gtk_cell_area_cell_get")]
    //fn cell_get(&self, renderer: &impl IsA<CellRenderer>, first_prop_name: &str, : /*Unknown conversion*//*Unimplemented*/Basic: VarArgs) {
    //    unsafe { TODO: call ffi:gtk_cell_area_cell_get() }
    //}

    /// Gets the value of a cell property for `renderer` in `self`.
    /// ## `renderer`
    /// a [`CellRenderer`][crate::CellRenderer] inside `self`
    /// ## `property_name`
    /// the name of the property to get
    ///
    /// # Returns
    ///
    ///
    /// ## `value`
    /// a location to return the value
    #[doc(alias = "gtk_cell_area_cell_get_property")]
    fn cell_get_property(
        &self,
        renderer: &impl IsA<CellRenderer>,
        property_name: &str,
    ) -> glib::Value {
        unsafe {
            let mut value = glib::Value::uninitialized();
            ffi::gtk_cell_area_cell_get_property(
                self.as_ref().to_glib_none().0,
                renderer.as_ref().to_glib_none().0,
                property_name.to_glib_none().0,
                value.to_glib_none_mut().0,
            );
            value
        }
    }

    //#[doc(alias = "gtk_cell_area_cell_get_valist")]
    //fn cell_get_valist(&self, renderer: &impl IsA<CellRenderer>, first_property_name: &str, var_args: /*Unknown conversion*//*Unimplemented*/Unsupported) {
    //    unsafe { TODO: call ffi:gtk_cell_area_cell_get_valist() }
    //}

    //#[doc(alias = "gtk_cell_area_cell_set")]
    //fn cell_set(&self, renderer: &impl IsA<CellRenderer>, first_prop_name: &str, : /*Unknown conversion*//*Unimplemented*/Basic: VarArgs) {
    //    unsafe { TODO: call ffi:gtk_cell_area_cell_set() }
    //}

    /// Sets a cell property for `renderer` in `self`.
    /// ## `renderer`
    /// a [`CellRenderer`][crate::CellRenderer] inside `self`
    /// ## `property_name`
    /// the name of the cell property to set
    /// ## `value`
    /// the value to set the cell property to
    #[doc(alias = "gtk_cell_area_cell_set_property")]
    fn cell_set_property(
        &self,
        renderer: &impl IsA<CellRenderer>,
        property_name: &str,
        value: &glib::Value,
    ) {
        unsafe {
            ffi::gtk_cell_area_cell_set_property(
                self.as_ref().to_glib_none().0,
                renderer.as_ref().to_glib_none().0,
                property_name.to_glib_none().0,
                value.to_glib_none().0,
            );
        }
    }

    //#[doc(alias = "gtk_cell_area_cell_set_valist")]
    //fn cell_set_valist(&self, renderer: &impl IsA<CellRenderer>, first_property_name: &str, var_args: /*Unknown conversion*//*Unimplemented*/Unsupported) {
    //    unsafe { TODO: call ffi:gtk_cell_area_cell_set_valist() }
    //}

    /// This is sometimes needed for cases where rows need to share
    /// alignments in one orientation but may be separately grouped
    /// in the opposing orientation.
    ///
    /// For instance, [`IconView`][crate::IconView] creates all icons (rows) to have
    /// the same width and the cells theirin to have the same
    /// horizontal alignments. However each row of icons may have
    /// a separate collective height. [`IconView`][crate::IconView] uses this to
    /// request the heights of each row based on a context which
    /// was already used to request all the row widths that are
    /// to be displayed.
    /// ## `context`
    /// the [`CellAreaContext`][crate::CellAreaContext] to copy
    ///
    /// # Returns
    ///
    /// a newly created [`CellAreaContext`][crate::CellAreaContext] copy of `context`.
    #[doc(alias = "gtk_cell_area_copy_context")]
    fn copy_context(&self, context: &impl IsA<CellAreaContext>) -> Option<CellAreaContext> {
        unsafe {
            from_glib_full(ffi::gtk_cell_area_copy_context(
                self.as_ref().to_glib_none().0,
                context.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Creates a [`CellAreaContext`][crate::CellAreaContext] to be used with `self` for
    /// all purposes. [`CellAreaContext`][crate::CellAreaContext] stores geometry information
    /// for rows for which it was operated on, it is important to use
    /// the same context for the same row of data at all times (i.e.
    /// one should render and handle events with the same [`CellAreaContext`][crate::CellAreaContext]
    /// which was used to request the size of those rows of data).
    ///
    /// # Returns
    ///
    /// a newly created [`CellAreaContext`][crate::CellAreaContext] which can be used with `self`.
    #[doc(alias = "gtk_cell_area_create_context")]
    fn create_context(&self) -> Option<CellAreaContext> {
        unsafe {
            from_glib_full(ffi::gtk_cell_area_create_context(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Delegates event handling to a [`CellArea`][crate::CellArea].
    /// ## `context`
    /// the [`CellAreaContext`][crate::CellAreaContext] for this row of data.
    /// ## `widget`
    /// the [`Widget`][crate::Widget] that `self` is rendering to
    /// ## `event`
    /// the `GdkEvent` to handle
    /// ## `cell_area`
    /// the `widget` relative coordinates for `self`
    /// ## `flags`
    /// the [`CellRendererState`][crate::CellRendererState] for `self` in this row.
    ///
    /// # Returns
    ///
    /// [`true`] if the event was handled by `self`.
    #[doc(alias = "gtk_cell_area_event")]
    fn event(
        &self,
        context: &impl IsA<CellAreaContext>,
        widget: &impl IsA<Widget>,
        event: &gdk::Event,
        cell_area: &gdk::Rectangle,
        flags: CellRendererState,
    ) -> i32 {
        unsafe {
            ffi::gtk_cell_area_event(
                self.as_ref().to_glib_none().0,
                context.as_ref().to_glib_none().0,
                widget.as_ref().to_glib_none().0,
                mut_override(event.to_glib_none().0),
                cell_area.to_glib_none().0,
                flags.into_glib(),
            )
        }
    }

    /// This should be called by the `self`’s owning layout widget
    /// when focus is to be passed to `self`, or moved within `self`
    /// for a given `direction` and row data.
    ///
    /// Implementing [`CellArea`][crate::CellArea] classes should implement this
    /// method to receive and navigate focus in its own way particular
    /// to how it lays out cells.
    /// ## `direction`
    /// the [`DirectionType`][crate::DirectionType]
    ///
    /// # Returns
    ///
    /// [`true`] if focus remains inside `self` as a result of this call.
    #[doc(alias = "gtk_cell_area_focus")]
    fn focus(&self, direction: DirectionType) -> bool {
        unsafe {
            from_glib(ffi::gtk_cell_area_focus(
                self.as_ref().to_glib_none().0,
                direction.into_glib(),
            ))
        }
    }

    /// Calls `callback` for every [`CellRenderer`][crate::CellRenderer] in `self`.
    /// ## `callback`
    /// the `GtkCellCallback` to call
    /// ## `callback_data`
    /// user provided data pointer
    #[doc(alias = "gtk_cell_area_foreach")]
    fn foreach<P: FnMut(&CellRenderer) -> bool>(&self, callback: P) {
        let mut callback_data: P = callback;
        unsafe extern "C" fn callback_func<P: FnMut(&CellRenderer) -> bool>(
            renderer: *mut ffi::GtkCellRenderer,
            data: glib::ffi::gpointer,
        ) -> glib::ffi::gboolean {
            unsafe {
                let renderer = from_glib_borrow(renderer);
                let callback = data as *mut P;
                (*callback)(&renderer).into_glib()
            }
        }
        let callback = Some(callback_func::<P> as _);
        let super_callback0: &mut P = &mut callback_data;
        unsafe {
            ffi::gtk_cell_area_foreach(
                self.as_ref().to_glib_none().0,
                callback,
                super_callback0 as *mut _ as *mut _,
            );
        }
    }

    /// Calls `callback` for every [`CellRenderer`][crate::CellRenderer] in `self` with the
    /// allocated rectangle inside `cell_area`.
    /// ## `context`
    /// the [`CellAreaContext`][crate::CellAreaContext] for this row of data.
    /// ## `widget`
    /// the [`Widget`][crate::Widget] that `self` is rendering to
    /// ## `cell_area`
    /// the `widget` relative coordinates and size for `self`
    /// ## `background_area`
    /// the `widget` relative coordinates of the background area
    /// ## `callback`
    /// the `GtkCellAllocCallback` to call
    /// ## `callback_data`
    /// user provided data pointer
    #[doc(alias = "gtk_cell_area_foreach_alloc")]
    fn foreach_alloc<P: FnMut(&CellRenderer, &gdk::Rectangle, &gdk::Rectangle) -> bool>(
        &self,
        context: &impl IsA<CellAreaContext>,
        widget: &impl IsA<Widget>,
        cell_area: &gdk::Rectangle,
        background_area: &gdk::Rectangle,
        callback: P,
    ) {
        let mut callback_data: P = callback;
        unsafe extern "C" fn callback_func<
            P: FnMut(&CellRenderer, &gdk::Rectangle, &gdk::Rectangle) -> bool,
        >(
            renderer: *mut ffi::GtkCellRenderer,
            cell_area: *const gdk::ffi::GdkRectangle,
            cell_background: *const gdk::ffi::GdkRectangle,
            data: glib::ffi::gpointer,
        ) -> glib::ffi::gboolean {
            unsafe {
                let renderer = from_glib_borrow(renderer);
                let cell_area = from_glib_borrow(cell_area);
                let cell_background = from_glib_borrow(cell_background);
                let callback = data as *mut P;
                (*callback)(&renderer, &cell_area, &cell_background).into_glib()
            }
        }
        let callback = Some(callback_func::<P> as _);
        let super_callback0: &mut P = &mut callback_data;
        unsafe {
            ffi::gtk_cell_area_foreach_alloc(
                self.as_ref().to_glib_none().0,
                context.as_ref().to_glib_none().0,
                widget.as_ref().to_glib_none().0,
                cell_area.to_glib_none().0,
                background_area.to_glib_none().0,
                callback,
                super_callback0 as *mut _ as *mut _,
            );
        }
    }

    /// Derives the allocation of `renderer` inside `self` if `self`
    /// were to be renderered in `cell_area`.
    /// ## `context`
    /// the [`CellAreaContext`][crate::CellAreaContext] used to hold sizes for `self`.
    /// ## `widget`
    /// the [`Widget`][crate::Widget] that `self` is rendering on
    /// ## `renderer`
    /// the [`CellRenderer`][crate::CellRenderer] to get the allocation for
    /// ## `cell_area`
    /// the whole allocated area for `self` in `widget`
    ///  for this row
    ///
    /// # Returns
    ///
    ///
    /// ## `allocation`
    /// where to store the allocation for `renderer`
    #[doc(alias = "gtk_cell_area_get_cell_allocation")]
    #[doc(alias = "get_cell_allocation")]
    fn cell_allocation(
        &self,
        context: &impl IsA<CellAreaContext>,
        widget: &impl IsA<Widget>,
        renderer: &impl IsA<CellRenderer>,
        cell_area: &gdk::Rectangle,
    ) -> gdk::Rectangle {
        unsafe {
            let mut allocation = gdk::Rectangle::uninitialized();
            ffi::gtk_cell_area_get_cell_allocation(
                self.as_ref().to_glib_none().0,
                context.as_ref().to_glib_none().0,
                widget.as_ref().to_glib_none().0,
                renderer.as_ref().to_glib_none().0,
                cell_area.to_glib_none().0,
                allocation.to_glib_none_mut().0,
            );
            allocation
        }
    }

    /// Gets the [`CellRenderer`][crate::CellRenderer] at `x` and `y` coordinates inside `self` and optionally
    /// returns the full cell allocation for it inside `cell_area`.
    /// ## `context`
    /// the [`CellAreaContext`][crate::CellAreaContext] used to hold sizes for `self`.
    /// ## `widget`
    /// the [`Widget`][crate::Widget] that `self` is rendering on
    /// ## `cell_area`
    /// the whole allocated area for `self` in `widget`
    ///  for this row
    /// ## `x`
    /// the x position
    /// ## `y`
    /// the y position
    ///
    /// # Returns
    ///
    /// the [`CellRenderer`][crate::CellRenderer] at `x` and `y`.
    ///
    /// ## `alloc_area`
    /// where to store the inner allocated area of the
    ///  returned cell renderer, or [`None`].
    #[doc(alias = "gtk_cell_area_get_cell_at_position")]
    #[doc(alias = "get_cell_at_position")]
    fn cell_at_position(
        &self,
        context: &impl IsA<CellAreaContext>,
        widget: &impl IsA<Widget>,
        cell_area: &gdk::Rectangle,
        x: i32,
        y: i32,
    ) -> (CellRenderer, gdk::Rectangle) {
        unsafe {
            let mut alloc_area = gdk::Rectangle::uninitialized();
            let ret = from_glib_none(ffi::gtk_cell_area_get_cell_at_position(
                self.as_ref().to_glib_none().0,
                context.as_ref().to_glib_none().0,
                widget.as_ref().to_glib_none().0,
                cell_area.to_glib_none().0,
                x,
                y,
                alloc_area.to_glib_none_mut().0,
            ));
            (ret, alloc_area)
        }
    }

    /// Gets the current [`TreePath`][crate::TreePath] string for the currently
    /// applied [`TreeIter`][crate::TreeIter], this is implicitly updated when
    /// [`apply_attributes()`][Self::apply_attributes()] is called and can be
    /// used to interact with renderers from [`CellArea`][crate::CellArea]
    /// subclasses.
    ///
    /// # Returns
    ///
    /// The current [`TreePath`][crate::TreePath] string for the current
    /// attributes applied to `self`. This string belongs to the area and
    /// should not be freed.
    #[doc(alias = "gtk_cell_area_get_current_path_string")]
    #[doc(alias = "get_current_path_string")]
    fn current_path_string(&self) -> Option<glib::GString> {
        unsafe {
            from_glib_none(ffi::gtk_cell_area_get_current_path_string(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the [`CellEditable`][crate::CellEditable] widget currently used
    /// to edit the currently edited cell.
    ///
    /// # Returns
    ///
    /// The currently active [`CellEditable`][crate::CellEditable] widget
    #[doc(alias = "gtk_cell_area_get_edit_widget")]
    #[doc(alias = "get_edit_widget")]
    #[doc(alias = "edit-widget")]
    fn edit_widget(&self) -> Option<CellEditable> {
        unsafe {
            from_glib_none(ffi::gtk_cell_area_get_edit_widget(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the [`CellRenderer`][crate::CellRenderer] in `self` that is currently
    /// being edited.
    ///
    /// # Returns
    ///
    /// The currently edited [`CellRenderer`][crate::CellRenderer]
    #[doc(alias = "gtk_cell_area_get_edited_cell")]
    #[doc(alias = "get_edited_cell")]
    #[doc(alias = "edited-cell")]
    fn edited_cell(&self) -> Option<CellRenderer> {
        unsafe {
            from_glib_none(ffi::gtk_cell_area_get_edited_cell(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Retrieves the currently focused cell for `self`
    ///
    /// # Returns
    ///
    /// the currently focused cell in `self`.
    #[doc(alias = "gtk_cell_area_get_focus_cell")]
    #[doc(alias = "get_focus_cell")]
    #[doc(alias = "focus-cell")]
    fn focus_cell(&self) -> Option<CellRenderer> {
        unsafe {
            from_glib_none(ffi::gtk_cell_area_get_focus_cell(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the [`CellRenderer`][crate::CellRenderer] which is expected to be focusable
    /// for which `renderer` is, or may be a sibling.
    ///
    /// This is handy for [`CellArea`][crate::CellArea] subclasses when handling events,
    /// after determining the renderer at the event location it can
    /// then chose to activate the focus cell for which the event
    /// cell may have been a sibling.
    /// ## `renderer`
    /// the [`CellRenderer`][crate::CellRenderer]
    ///
    /// # Returns
    ///
    /// the [`CellRenderer`][crate::CellRenderer] for which `renderer`
    ///  is a sibling, or [`None`].
    #[doc(alias = "gtk_cell_area_get_focus_from_sibling")]
    #[doc(alias = "get_focus_from_sibling")]
    fn focus_from_sibling(&self, renderer: &impl IsA<CellRenderer>) -> Option<CellRenderer> {
        unsafe {
            from_glib_none(ffi::gtk_cell_area_get_focus_from_sibling(
                self.as_ref().to_glib_none().0,
                renderer.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets the focus sibling cell renderers for `renderer`.
    /// ## `renderer`
    /// the [`CellRenderer`][crate::CellRenderer] expected to have focus
    ///
    /// # Returns
    ///
    /// A `GList` of `GtkCellRenderers`.
    ///  The returned list is internal and should not be freed.
    #[doc(alias = "gtk_cell_area_get_focus_siblings")]
    #[doc(alias = "get_focus_siblings")]
    fn focus_siblings(&self, renderer: &impl IsA<CellRenderer>) -> Vec<CellRenderer> {
        unsafe {
            FromGlibPtrContainer::from_glib_none(ffi::gtk_cell_area_get_focus_siblings(
                self.as_ref().to_glib_none().0,
                renderer.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Retrieves a cell area’s initial minimum and natural height.
    ///
    /// `self` will store some geometrical information in `context` along the way;
    /// when requesting sizes over an arbitrary number of rows, it’s not important
    /// to check the `minimum_height` and `natural_height` of this call but rather to
    /// consult [`CellAreaContextExt::preferred_height()`][crate::prelude::CellAreaContextExt::preferred_height()] after a series of
    /// requests.
    /// ## `context`
    /// the [`CellAreaContext`][crate::CellAreaContext] to perform this request with
    /// ## `widget`
    /// the [`Widget`][crate::Widget] where `self` will be rendering
    ///
    /// # Returns
    ///
    ///
    /// ## `minimum_height`
    /// location to store the minimum height, or [`None`]
    ///
    /// ## `natural_height`
    /// location to store the natural height, or [`None`]
    #[doc(alias = "gtk_cell_area_get_preferred_height")]
    #[doc(alias = "get_preferred_height")]
    fn preferred_height(
        &self,
        context: &impl IsA<CellAreaContext>,
        widget: &impl IsA<Widget>,
    ) -> (i32, i32) {
        unsafe {
            let mut minimum_height = std::mem::MaybeUninit::uninit();
            let mut natural_height = std::mem::MaybeUninit::uninit();
            ffi::gtk_cell_area_get_preferred_height(
                self.as_ref().to_glib_none().0,
                context.as_ref().to_glib_none().0,
                widget.as_ref().to_glib_none().0,
                minimum_height.as_mut_ptr(),
                natural_height.as_mut_ptr(),
            );
            (minimum_height.assume_init(), natural_height.assume_init())
        }
    }

    /// Retrieves a cell area’s minimum and natural height if it would be given
    /// the specified `width`.
    ///
    /// `self` stores some geometrical information in `context` along the way
    /// while calling [`preferred_width()`][Self::preferred_width()]. It’s important to
    /// perform a series of [`preferred_width()`][Self::preferred_width()] requests with
    /// `context` first and then call [`preferred_height_for_width()`][Self::preferred_height_for_width()]
    /// on each cell area individually to get the height for width of each
    /// fully requested row.
    ///
    /// If at some point, the width of a single row changes, it should be
    /// requested with [`preferred_width()`][Self::preferred_width()] again and then
    /// the full width of the requested rows checked again with
    /// [`CellAreaContextExt::preferred_width()`][crate::prelude::CellAreaContextExt::preferred_width()].
    /// ## `context`
    /// the [`CellAreaContext`][crate::CellAreaContext] which has already been requested for widths.
    /// ## `widget`
    /// the [`Widget`][crate::Widget] where `self` will be rendering
    /// ## `width`
    /// the width for which to check the height of this area
    ///
    /// # Returns
    ///
    ///
    /// ## `minimum_height`
    /// location to store the minimum height, or [`None`]
    ///
    /// ## `natural_height`
    /// location to store the natural height, or [`None`]
    #[doc(alias = "gtk_cell_area_get_preferred_height_for_width")]
    #[doc(alias = "get_preferred_height_for_width")]
    fn preferred_height_for_width(
        &self,
        context: &impl IsA<CellAreaContext>,
        widget: &impl IsA<Widget>,
        width: i32,
    ) -> (i32, i32) {
        unsafe {
            let mut minimum_height = std::mem::MaybeUninit::uninit();
            let mut natural_height = std::mem::MaybeUninit::uninit();
            ffi::gtk_cell_area_get_preferred_height_for_width(
                self.as_ref().to_glib_none().0,
                context.as_ref().to_glib_none().0,
                widget.as_ref().to_glib_none().0,
                width,
                minimum_height.as_mut_ptr(),
                natural_height.as_mut_ptr(),
            );
            (minimum_height.assume_init(), natural_height.assume_init())
        }
    }

    /// Retrieves a cell area’s initial minimum and natural width.
    ///
    /// `self` will store some geometrical information in `context` along the way;
    /// when requesting sizes over an arbitrary number of rows, it’s not important
    /// to check the `minimum_width` and `natural_width` of this call but rather to
    /// consult [`CellAreaContextExt::preferred_width()`][crate::prelude::CellAreaContextExt::preferred_width()] after a series of
    /// requests.
    /// ## `context`
    /// the [`CellAreaContext`][crate::CellAreaContext] to perform this request with
    /// ## `widget`
    /// the [`Widget`][crate::Widget] where `self` will be rendering
    ///
    /// # Returns
    ///
    ///
    /// ## `minimum_width`
    /// location to store the minimum width, or [`None`]
    ///
    /// ## `natural_width`
    /// location to store the natural width, or [`None`]
    #[doc(alias = "gtk_cell_area_get_preferred_width")]
    #[doc(alias = "get_preferred_width")]
    fn preferred_width(
        &self,
        context: &impl IsA<CellAreaContext>,
        widget: &impl IsA<Widget>,
    ) -> (i32, i32) {
        unsafe {
            let mut minimum_width = std::mem::MaybeUninit::uninit();
            let mut natural_width = std::mem::MaybeUninit::uninit();
            ffi::gtk_cell_area_get_preferred_width(
                self.as_ref().to_glib_none().0,
                context.as_ref().to_glib_none().0,
                widget.as_ref().to_glib_none().0,
                minimum_width.as_mut_ptr(),
                natural_width.as_mut_ptr(),
            );
            (minimum_width.assume_init(), natural_width.assume_init())
        }
    }

    /// Retrieves a cell area’s minimum and natural width if it would be given
    /// the specified `height`.
    ///
    /// `self` stores some geometrical information in `context` along the way
    /// while calling [`preferred_height()`][Self::preferred_height()]. It’s important to
    /// perform a series of [`preferred_height()`][Self::preferred_height()] requests with
    /// `context` first and then call [`preferred_width_for_height()`][Self::preferred_width_for_height()]
    /// on each cell area individually to get the height for width of each
    /// fully requested row.
    ///
    /// If at some point, the height of a single row changes, it should be
    /// requested with [`preferred_height()`][Self::preferred_height()] again and then
    /// the full height of the requested rows checked again with
    /// [`CellAreaContextExt::preferred_height()`][crate::prelude::CellAreaContextExt::preferred_height()].
    /// ## `context`
    /// the [`CellAreaContext`][crate::CellAreaContext] which has already been requested for widths.
    /// ## `widget`
    /// the [`Widget`][crate::Widget] where `self` will be rendering
    /// ## `height`
    /// the height for which to check the width of this area
    ///
    /// # Returns
    ///
    ///
    /// ## `minimum_width`
    /// location to store the minimum width, or [`None`]
    ///
    /// ## `natural_width`
    /// location to store the natural width, or [`None`]
    #[doc(alias = "gtk_cell_area_get_preferred_width_for_height")]
    #[doc(alias = "get_preferred_width_for_height")]
    fn preferred_width_for_height(
        &self,
        context: &impl IsA<CellAreaContext>,
        widget: &impl IsA<Widget>,
        height: i32,
    ) -> (i32, i32) {
        unsafe {
            let mut minimum_width = std::mem::MaybeUninit::uninit();
            let mut natural_width = std::mem::MaybeUninit::uninit();
            ffi::gtk_cell_area_get_preferred_width_for_height(
                self.as_ref().to_glib_none().0,
                context.as_ref().to_glib_none().0,
                widget.as_ref().to_glib_none().0,
                height,
                minimum_width.as_mut_ptr(),
                natural_width.as_mut_ptr(),
            );
            (minimum_width.assume_init(), natural_width.assume_init())
        }
    }

    /// Gets whether the area prefers a height-for-width layout
    /// or a width-for-height layout.
    ///
    /// # Returns
    ///
    /// The [`SizeRequestMode`][crate::SizeRequestMode] preferred by `self`.
    #[doc(alias = "gtk_cell_area_get_request_mode")]
    #[doc(alias = "get_request_mode")]
    fn request_mode(&self) -> SizeRequestMode {
        unsafe {
            from_glib(ffi::gtk_cell_area_get_request_mode(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Checks if `self` contains `renderer`.
    /// ## `renderer`
    /// the [`CellRenderer`][crate::CellRenderer] to check
    ///
    /// # Returns
    ///
    /// [`true`] if `renderer` is in the `self`.
    #[doc(alias = "gtk_cell_area_has_renderer")]
    fn has_renderer(&self, renderer: &impl IsA<CellRenderer>) -> bool {
        unsafe {
            from_glib(ffi::gtk_cell_area_has_renderer(
                self.as_ref().to_glib_none().0,
                renderer.as_ref().to_glib_none().0,
            ))
        }
    }

    /// This is a convenience function for [`CellArea`][crate::CellArea] implementations
    /// to get the inner area where a given [`CellRenderer`][crate::CellRenderer] will be
    /// rendered. It removes any padding previously added by [`request_renderer()`][Self::request_renderer()].
    /// ## `widget`
    /// the [`Widget`][crate::Widget] that `self` is rendering onto
    /// ## `cell_area`
    /// the `widget` relative coordinates where one of `self`’s cells
    ///  is to be placed
    ///
    /// # Returns
    ///
    ///
    /// ## `inner_area`
    /// the return location for the inner cell area
    #[doc(alias = "gtk_cell_area_inner_cell_area")]
    fn inner_cell_area(
        &self,
        widget: &impl IsA<Widget>,
        cell_area: &gdk::Rectangle,
    ) -> gdk::Rectangle {
        unsafe {
            let mut inner_area = gdk::Rectangle::uninitialized();
            ffi::gtk_cell_area_inner_cell_area(
                self.as_ref().to_glib_none().0,
                widget.as_ref().to_glib_none().0,
                cell_area.to_glib_none().0,
                inner_area.to_glib_none_mut().0,
            );
            inner_area
        }
    }

    /// Returns whether the area can do anything when activated,
    /// after applying new attributes to `self`.
    ///
    /// # Returns
    ///
    /// whether `self` can do anything when activated.
    #[doc(alias = "gtk_cell_area_is_activatable")]
    fn is_activatable(&self) -> bool {
        unsafe {
            from_glib(ffi::gtk_cell_area_is_activatable(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Returns whether `sibling` is one of `renderer`’s focus siblings
    /// (see [`add_focus_sibling()`][Self::add_focus_sibling()]).
    /// ## `renderer`
    /// the [`CellRenderer`][crate::CellRenderer] expected to have focus
    /// ## `sibling`
    /// the [`CellRenderer`][crate::CellRenderer] to check against `renderer`’s sibling list
    ///
    /// # Returns
    ///
    /// [`true`] if `sibling` is a focus sibling of `renderer`
    #[doc(alias = "gtk_cell_area_is_focus_sibling")]
    fn is_focus_sibling(
        &self,
        renderer: &impl IsA<CellRenderer>,
        sibling: &impl IsA<CellRenderer>,
    ) -> bool {
        unsafe {
            from_glib(ffi::gtk_cell_area_is_focus_sibling(
                self.as_ref().to_glib_none().0,
                renderer.as_ref().to_glib_none().0,
                sibling.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Removes `renderer` from `self`.
    /// ## `renderer`
    /// the [`CellRenderer`][crate::CellRenderer] to remove from `self`
    #[doc(alias = "gtk_cell_area_remove")]
    fn remove(&self, renderer: &impl IsA<CellRenderer>) {
        unsafe {
            ffi::gtk_cell_area_remove(
                self.as_ref().to_glib_none().0,
                renderer.as_ref().to_glib_none().0,
            );
        }
    }

    /// Removes `sibling` from `renderer`’s focus sibling list
    /// (see [`add_focus_sibling()`][Self::add_focus_sibling()]).
    /// ## `renderer`
    /// the [`CellRenderer`][crate::CellRenderer] expected to have focus
    /// ## `sibling`
    /// the [`CellRenderer`][crate::CellRenderer] to remove from `renderer`’s focus area
    #[doc(alias = "gtk_cell_area_remove_focus_sibling")]
    fn remove_focus_sibling(
        &self,
        renderer: &impl IsA<CellRenderer>,
        sibling: &impl IsA<CellRenderer>,
    ) {
        unsafe {
            ffi::gtk_cell_area_remove_focus_sibling(
                self.as_ref().to_glib_none().0,
                renderer.as_ref().to_glib_none().0,
                sibling.as_ref().to_glib_none().0,
            );
        }
    }

    /// Renders `self`’s cells according to `self`’s layout onto `widget` at
    /// the given coordinates.
    /// ## `context`
    /// the [`CellAreaContext`][crate::CellAreaContext] for this row of data.
    /// ## `widget`
    /// the [`Widget`][crate::Widget] that `self` is rendering to
    /// ## `cr`
    /// the [`cairo::Context`][crate::cairo::Context] to render with
    /// ## `background_area`
    /// the `widget` relative coordinates for `self`’s background
    /// ## `cell_area`
    /// the `widget` relative coordinates for `self`
    /// ## `flags`
    /// the [`CellRendererState`][crate::CellRendererState] for `self` in this row.
    /// ## `paint_focus`
    /// whether `self` should paint focus on focused cells for focused rows or not.
    #[doc(alias = "gtk_cell_area_render")]
    fn render(
        &self,
        context: &impl IsA<CellAreaContext>,
        widget: &impl IsA<Widget>,
        cr: &cairo::Context,
        background_area: &gdk::Rectangle,
        cell_area: &gdk::Rectangle,
        flags: CellRendererState,
        paint_focus: bool,
    ) {
        unsafe {
            ffi::gtk_cell_area_render(
                self.as_ref().to_glib_none().0,
                context.as_ref().to_glib_none().0,
                widget.as_ref().to_glib_none().0,
                mut_override(cr.to_glib_none().0),
                background_area.to_glib_none().0,
                cell_area.to_glib_none().0,
                flags.into_glib(),
                paint_focus.into_glib(),
            );
        }
    }

    /// This is a convenience function for [`CellArea`][crate::CellArea] implementations
    /// to request size for cell renderers. It’s important to use this
    /// function to request size and then use [`inner_cell_area()`][Self::inner_cell_area()]
    /// at render and event time since this function will add padding
    /// around the cell for focus painting.
    /// ## `renderer`
    /// the [`CellRenderer`][crate::CellRenderer] to request size for
    /// ## `orientation`
    /// the [`Orientation`][crate::Orientation] in which to request size
    /// ## `widget`
    /// the [`Widget`][crate::Widget] that `self` is rendering onto
    /// ## `for_size`
    /// the allocation contextual size to request for, or -1 if
    /// the base request for the orientation is to be returned.
    ///
    /// # Returns
    ///
    ///
    /// ## `minimum_size`
    /// location to store the minimum size, or [`None`]
    ///
    /// ## `natural_size`
    /// location to store the natural size, or [`None`]
    #[doc(alias = "gtk_cell_area_request_renderer")]
    fn request_renderer(
        &self,
        renderer: &impl IsA<CellRenderer>,
        orientation: Orientation,
        widget: &impl IsA<Widget>,
        for_size: i32,
    ) -> (i32, i32) {
        unsafe {
            let mut minimum_size = std::mem::MaybeUninit::uninit();
            let mut natural_size = std::mem::MaybeUninit::uninit();
            ffi::gtk_cell_area_request_renderer(
                self.as_ref().to_glib_none().0,
                renderer.as_ref().to_glib_none().0,
                orientation.into_glib(),
                widget.as_ref().to_glib_none().0,
                for_size,
                minimum_size.as_mut_ptr(),
                natural_size.as_mut_ptr(),
            );
            (minimum_size.assume_init(), natural_size.assume_init())
        }
    }

    /// Explicitly sets the currently focused cell to `renderer`.
    ///
    /// This is generally called by implementations of
    /// `GtkCellAreaClass.focus()` or `GtkCellAreaClass.event()`,
    /// however it can also be used to implement functions such
    /// as [`TreeViewExt::set_cursor_on_cell()`][crate::prelude::TreeViewExt::set_cursor_on_cell()].
    /// ## `renderer`
    /// the [`CellRenderer`][crate::CellRenderer] to give focus to
    #[doc(alias = "gtk_cell_area_set_focus_cell")]
    #[doc(alias = "focus-cell")]
    fn set_focus_cell(&self, renderer: &impl IsA<CellRenderer>) {
        unsafe {
            ffi::gtk_cell_area_set_focus_cell(
                self.as_ref().to_glib_none().0,
                renderer.as_ref().to_glib_none().0,
            );
        }
    }

    /// Explicitly stops the editing of the currently edited cell.
    ///
    /// If `canceled` is [`true`], the currently edited cell renderer
    /// will emit the ::editing-canceled signal, otherwise the
    /// the ::editing-done signal will be emitted on the current
    /// edit widget.
    ///
    /// See [`edited_cell()`][Self::edited_cell()] and [`edit_widget()`][Self::edit_widget()].
    /// ## `canceled`
    /// whether editing was canceled.
    #[doc(alias = "gtk_cell_area_stop_editing")]
    fn stop_editing(&self, canceled: bool) {
        unsafe {
            ffi::gtk_cell_area_stop_editing(self.as_ref().to_glib_none().0, canceled.into_glib());
        }
    }

    /// Indicates that editing has started on `renderer` and that `editable`
    /// should be added to the owning cell-layouting widget at `cell_area`.
    /// ## `renderer`
    /// the [`CellRenderer`][crate::CellRenderer] that started the edited
    /// ## `editable`
    /// the [`CellEditable`][crate::CellEditable] widget to add
    /// ## `cell_area`
    /// the [`Widget`][crate::Widget] relative [`gdk::Rectangle`][crate::gdk::Rectangle] coordinates
    ///  where `editable` should be added
    /// ## `path`
    /// the [`TreePath`][crate::TreePath] string this edit was initiated for
    #[doc(alias = "add-editable")]
    fn connect_add_editable<
        F: Fn(&Self, &CellRenderer, &CellEditable, &gdk::Rectangle, TreePath) + 'static,
    >(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn add_editable_trampoline<
            P: IsA<CellArea>,
            F: Fn(&P, &CellRenderer, &CellEditable, &gdk::Rectangle, TreePath) + 'static,
        >(
            this: *mut ffi::GtkCellArea,
            renderer: *mut ffi::GtkCellRenderer,
            editable: *mut ffi::GtkCellEditable,
            cell_area: *mut gdk::ffi::GdkRectangle,
            path: *mut std::ffi::c_char,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                let path = from_glib_full(crate::ffi::gtk_tree_path_new_from_string(path));
                f(
                    CellArea::from_glib_borrow(this).unsafe_cast_ref(),
                    &from_glib_borrow(renderer),
                    &from_glib_borrow(editable),
                    &from_glib_borrow(cell_area),
                    path,
                )
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"add-editable".as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    add_editable_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    /// This signal is emitted whenever applying attributes to `area` from `model`
    /// ## `model`
    /// the [`TreeModel`][crate::TreeModel] to apply the attributes from
    /// ## `iter`
    /// the [`TreeIter`][crate::TreeIter] indicating which row to apply the attributes of
    /// ## `is_expander`
    /// whether the view shows children for this row
    /// ## `is_expanded`
    /// whether the view is currently showing the children of this row
    #[doc(alias = "apply-attributes")]
    fn connect_apply_attributes<F: Fn(&Self, &TreeModel, &TreeIter, bool, bool) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn apply_attributes_trampoline<
            P: IsA<CellArea>,
            F: Fn(&P, &TreeModel, &TreeIter, bool, bool) + 'static,
        >(
            this: *mut ffi::GtkCellArea,
            model: *mut ffi::GtkTreeModel,
            iter: *mut ffi::GtkTreeIter,
            is_expander: glib::ffi::gboolean,
            is_expanded: glib::ffi::gboolean,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                f(
                    CellArea::from_glib_borrow(this).unsafe_cast_ref(),
                    &from_glib_borrow(model),
                    &from_glib_borrow(iter),
                    from_glib(is_expander),
                    from_glib(is_expanded),
                )
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"apply-attributes".as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    apply_attributes_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    /// Indicates that focus changed on this `area`. This signal
    /// is emitted either as a result of focus handling or event
    /// handling.
    ///
    /// It's possible that the signal is emitted even if the
    /// currently focused renderer did not change, this is
    /// because focus may change to the same renderer in the
    /// same cell area for a different row of data.
    /// ## `renderer`
    /// the [`CellRenderer`][crate::CellRenderer] that has focus
    /// ## `path`
    /// the current [`TreePath`][crate::TreePath] string set for `area`
    #[doc(alias = "focus-changed")]
    fn connect_focus_changed<F: Fn(&Self, &CellRenderer, TreePath) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn focus_changed_trampoline<
            P: IsA<CellArea>,
            F: Fn(&P, &CellRenderer, TreePath) + 'static,
        >(
            this: *mut ffi::GtkCellArea,
            renderer: *mut ffi::GtkCellRenderer,
            path: *mut std::ffi::c_char,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                let path = from_glib_full(crate::ffi::gtk_tree_path_new_from_string(path));
                f(
                    CellArea::from_glib_borrow(this).unsafe_cast_ref(),
                    &from_glib_borrow(renderer),
                    path,
                )
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"focus-changed".as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    focus_changed_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    /// Indicates that editing finished on `renderer` and that `editable`
    /// should be removed from the owning cell-layouting widget.
    /// ## `renderer`
    /// the [`CellRenderer`][crate::CellRenderer] that finished editeding
    /// ## `editable`
    /// the [`CellEditable`][crate::CellEditable] widget to remove
    #[doc(alias = "remove-editable")]
    fn connect_remove_editable<F: Fn(&Self, &CellRenderer, &CellEditable) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn remove_editable_trampoline<
            P: IsA<CellArea>,
            F: Fn(&P, &CellRenderer, &CellEditable) + 'static,
        >(
            this: *mut ffi::GtkCellArea,
            renderer: *mut ffi::GtkCellRenderer,
            editable: *mut ffi::GtkCellEditable,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                f(
                    CellArea::from_glib_borrow(this).unsafe_cast_ref(),
                    &from_glib_borrow(renderer),
                    &from_glib_borrow(editable),
                )
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"remove-editable".as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    remove_editable_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "edit-widget")]
    fn connect_edit_widget_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_edit_widget_trampoline<
            P: IsA<CellArea>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::GtkCellArea,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                f(CellArea::from_glib_borrow(this).unsafe_cast_ref())
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"notify::edit-widget".as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_edit_widget_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "edited-cell")]
    fn connect_edited_cell_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_edited_cell_trampoline<
            P: IsA<CellArea>,
            F: Fn(&P) + 'static,
        >(
            this: *mut ffi::GtkCellArea,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                f(CellArea::from_glib_borrow(this).unsafe_cast_ref())
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"notify::edited-cell".as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_edited_cell_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "focus-cell")]
    fn connect_focus_cell_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_focus_cell_trampoline<P: IsA<CellArea>, F: Fn(&P) + 'static>(
            this: *mut ffi::GtkCellArea,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            unsafe {
                let f: &F = &*(f as *const F);
                f(CellArea::from_glib_borrow(this).unsafe_cast_ref())
            }
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                c"notify::focus-cell".as_ptr(),
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_focus_cell_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl<O: IsA<CellArea>> CellAreaExt for O {}