gtk4/auto/

cell_renderer_combo.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, CellRenderer, CellRendererMode, CellRendererText, TreeIter, TreeModel, TreePath};
use glib::{
    prelude::*,
    signal::{connect_raw, SignalHandlerId},
    translate::*,
};
use std::boxed::Box as Box_;

glib::wrapper! {
    /// List views use widgets to display their contents. You
    ///   should use [`DropDown`][crate::DropDown] instead
    /// Renders a combobox in a cell
    ///
    /// [`CellRendererCombo`][crate::CellRendererCombo] renders text in a cell like [`CellRendererText`][crate::CellRendererText] from
    /// which it is derived. But while [`CellRendererText`][crate::CellRendererText] offers a simple entry to
    /// edit the text, [`CellRendererCombo`][crate::CellRendererCombo] offers a [`ComboBox`][crate::ComboBox]
    /// widget to edit the text. The values to display in the combo box are taken from
    /// the tree model specified in the [`CellRendererCombo`][crate::CellRendererCombo]:model property.
    ///
    /// The combo cell renderer takes care of adding a text cell renderer to the combo
    /// box and sets it to display the column specified by its
    /// [`CellRendererCombo`][crate::CellRendererCombo]:text-column property. Further properties of the combo box
    /// can be set in a handler for the `GtkCellRenderer::editing-started` signal.
    ///
    /// ## Properties
    ///
    ///
    /// #### `has-entry`
    ///  If [`true`], the cell renderer will include an entry and allow to enter
    /// values other than the ones in the popup list.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `model`
    ///  Holds a tree model containing the possible values for the combo box.
    /// Use the text_column property to specify the column holding the values.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `text-column`
    ///  Specifies the model column which holds the possible values for the
    /// combo box.
    ///
    /// Note that this refers to the model specified in the model property,
    /// not the model backing the tree view to which
    /// this cell renderer is attached.
    ///
    /// [`CellRendererCombo`][crate::CellRendererCombo] automatically adds a text cell renderer for
    /// this column to its combo box.
    ///
    /// Readable | Writeable
    /// <details><summary><h4>CellRendererText</h4></summary>
    ///
    ///
    /// #### `align-set`
    ///  Readable | Writeable
    ///
    ///
    /// #### `alignment`
    ///  Specifies how to align the lines of text with respect to each other.
    ///
    /// Note that this property describes how to align the lines of text in
    /// case there are several of them. The "xalign" property of [`CellRenderer`][crate::CellRenderer],
    /// on the other hand, sets the horizontal alignment of the whole text.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `attributes`
    ///  Readable | Writeable
    ///
    ///
    /// #### `background`
    ///  Writeable
    ///
    ///
    /// #### `background-rgba`
    ///  Background color as a [`gdk::RGBA`][crate::gdk::RGBA]
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `background-set`
    ///  Readable | Writeable
    ///
    ///
    /// #### `editable`
    ///  Readable | Writeable
    ///
    ///
    /// #### `editable-set`
    ///  Readable | Writeable
    ///
    ///
    /// #### `ellipsize`
    ///  Specifies the preferred place to ellipsize the string, if the cell renderer
    /// does not have enough room to display the entire string. Setting it to
    /// [`pango::EllipsizeMode::None`][crate::pango::EllipsizeMode::None] turns off ellipsizing. See the wrap-width property
    /// for another way of making the text fit into a given width.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `ellipsize-set`
    ///  Readable | Writeable
    ///
    ///
    /// #### `family`
    ///  Readable | Writeable
    ///
    ///
    /// #### `family-set`
    ///  Readable | Writeable
    ///
    ///
    /// #### `font`
    ///  Readable | Writeable
    ///
    ///
    /// #### `font-desc`
    ///  Readable | Writeable
    ///
    ///
    /// #### `foreground`
    ///  Writeable
    ///
    ///
    /// #### `foreground-rgba`
    ///  Foreground color as a [`gdk::RGBA`][crate::gdk::RGBA]
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `foreground-set`
    ///  Readable | Writeable
    ///
    ///
    /// #### `language`
    ///  Readable | Writeable
    ///
    ///
    /// #### `language-set`
    ///  Readable | Writeable
    ///
    ///
    /// #### `markup`
    ///  Writeable
    ///
    ///
    /// #### `max-width-chars`
    ///  The desired maximum width of the cell, in characters. If this property
    /// is set to -1, the width will be calculated automatically.
    ///
    /// For cell renderers that ellipsize or wrap text; this property
    /// controls the maximum reported width of the cell. The
    /// cell should not receive any greater allocation unless it is
    /// set to expand in its [`CellLayout`][crate::CellLayout] and all of the cell's siblings
    /// have received their natural width.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `placeholder-text`
    ///  The text that will be displayed in the [`CellRenderer`][crate::CellRenderer] if
    /// `GtkCellRendererText:editable` is [`true`] and the cell is empty.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `rise`
    ///  Readable | Writeable
    ///
    ///
    /// #### `rise-set`
    ///  Readable | Writeable
    ///
    ///
    /// #### `scale`
    ///  Readable | Writeable
    ///
    ///
    /// #### `scale-set`
    ///  Readable | Writeable
    ///
    ///
    /// #### `single-paragraph-mode`
    ///  Readable | Writeable
    ///
    ///
    /// #### `size`
    ///  Readable | Writeable
    ///
    ///
    /// #### `size-points`
    ///  Readable | Writeable
    ///
    ///
    /// #### `size-set`
    ///  Readable | Writeable
    ///
    ///
    /// #### `stretch`
    ///  Readable | Writeable
    ///
    ///
    /// #### `stretch-set`
    ///  Readable | Writeable
    ///
    ///
    /// #### `strikethrough`
    ///  Readable | Writeable
    ///
    ///
    /// #### `strikethrough-set`
    ///  Readable | Writeable
    ///
    ///
    /// #### `style`
    ///  Readable | Writeable
    ///
    ///
    /// #### `style-set`
    ///  Readable | Writeable
    ///
    ///
    /// #### `text`
    ///  Readable | Writeable
    ///
    ///
    /// #### `underline`
    ///  Readable | Writeable
    ///
    ///
    /// #### `underline-set`
    ///  Readable | Writeable
    ///
    ///
    /// #### `variant`
    ///  Readable | Writeable
    ///
    ///
    /// #### `variant-set`
    ///  Readable | Writeable
    ///
    ///
    /// #### `weight`
    ///  Readable | Writeable
    ///
    ///
    /// #### `weight-set`
    ///  Readable | Writeable
    ///
    ///
    /// #### `width-chars`
    ///  The desired width of the cell, in characters. If this property is set to
    /// -1, the width will be calculated automatically, otherwise the cell will
    /// request either 3 characters or the property value, whichever is greater.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `wrap-mode`
    ///  Specifies how to break the string into multiple lines, if the cell
    /// renderer does not have enough room to display the entire string.
    /// This property has no effect unless the wrap-width property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `wrap-width`
    ///  Specifies the minimum width at which the text is wrapped. The wrap-mode property can
    /// be used to influence at what character positions the line breaks can be placed.
    /// Setting wrap-width to -1 turns wrapping off.
    ///
    /// Readable | Writeable
    /// </details>
    /// <details><summary><h4>CellRenderer</h4></summary>
    ///
    ///
    /// #### `cell-background`
    ///  Writeable
    ///
    ///
    /// #### `cell-background-rgba`
    ///  Cell background as a [`gdk::RGBA`][crate::gdk::RGBA]
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `cell-background-set`
    ///  Readable | Writeable
    ///
    ///
    /// #### `editing`
    ///  Readable
    ///
    ///
    /// #### `height`
    ///  Readable | Writeable
    ///
    ///
    /// #### `is-expanded`
    ///  Readable | Writeable
    ///
    ///
    /// #### `is-expander`
    ///  Readable | Writeable
    ///
    ///
    /// #### `mode`
    ///  Readable | Writeable
    ///
    ///
    /// #### `sensitive`
    ///  Readable | Writeable
    ///
    ///
    /// #### `visible`
    ///  Readable | Writeable
    ///
    ///
    /// #### `width`
    ///  Readable | Writeable
    ///
    ///
    /// #### `xalign`
    ///  Readable | Writeable
    ///
    ///
    /// #### `xpad`
    ///  Readable | Writeable
    ///
    ///
    /// #### `yalign`
    ///  Readable | Writeable
    ///
    ///
    /// #### `ypad`
    ///  Readable | Writeable
    /// </details>
    ///
    /// ## Signals
    ///
    ///
    /// #### `changed`
    ///  This signal is emitted each time after the user selected an item in
    /// the combo box, either by using the mouse or the arrow keys.  Contrary
    /// to GtkComboBox, GtkCellRendererCombo::changed is not emitted for
    /// changes made to a selected item in the entry.  The argument @new_iter
    /// corresponds to the newly selected item in the combo box and it is relative
    /// to the GtkTreeModel set via the model property on GtkCellRendererCombo.
    ///
    /// Note that as soon as you change the model displayed in the tree view,
    /// the tree view will immediately cease the editing operating.  This
    /// means that you most probably want to refrain from changing the model
    /// until the combo cell renderer emits the edited or editing_canceled signal.
    ///
    ///
    /// <details><summary><h4>CellRendererText</h4></summary>
    ///
    ///
    /// #### `edited`
    ///  This signal is emitted after @renderer has been edited.
    ///
    /// It is the responsibility of the application to update the model
    /// and store @new_text at the position indicated by @path.
    ///
    ///
    /// </details>
    /// <details><summary><h4>CellRenderer</h4></summary>
    ///
    ///
    /// #### `editing-canceled`
    ///  This signal gets emitted when the user cancels the process of editing a
    /// cell.  For example, an editable cell renderer could be written to cancel
    /// editing when the user presses Escape.
    ///
    /// See also: gtk_cell_renderer_stop_editing().
    ///
    ///
    ///
    ///
    /// #### `editing-started`
    ///  This signal gets emitted when a cell starts to be edited.
    /// The intended use of this signal is to do special setup
    /// on @editable, e.g. adding a [`EntryCompletion`][crate::EntryCompletion] or setting
    /// up additional columns in a [`ComboBox`][crate::ComboBox].
    ///
    /// See gtk_cell_editable_start_editing() for information on the lifecycle of
    /// the @editable and a way to do setup that doesn’t depend on the @renderer.
    ///
    /// Note that GTK doesn't guarantee that cell renderers will
    /// continue to use the same kind of widget for editing in future
    /// releases, therefore you should check the type of @editable
    /// before doing any specific setup, as in the following example:
    ///
    ///
    /// **⚠️ The following code is in C ⚠️**
    ///
    /// ```C
    /// static void
    /// text_editing_started (GtkCellRenderer *cell,
    ///                       GtkCellEditable *editable,
    ///                       const char      *path,
    ///                       gpointer         data)
    /// {
    ///   if (GTK_IS_ENTRY (editable))
    ///     {
    ///       GtkEntry *entry = GTK_ENTRY (editable);
    ///
    ///       // ... create a GtkEntryCompletion
    ///
    ///       gtk_entry_set_completion (entry, completion);
    ///     }
    /// }
    /// ```
    ///
    ///
    /// </details>
    ///
    /// # Implements
    ///
    /// [`CellRendererTextExt`][trait@crate::prelude::CellRendererTextExt], [`CellRendererExt`][trait@crate::prelude::CellRendererExt], [`trait@glib::ObjectExt`], [`CellRendererExtManual`][trait@crate::prelude::CellRendererExtManual]
    #[doc(alias = "GtkCellRendererCombo")]
    pub struct CellRendererCombo(Object<ffi::GtkCellRendererCombo>) @extends CellRendererText, CellRenderer;

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

impl CellRendererCombo {
    /// Creates a new [`CellRendererCombo`][crate::CellRendererCombo].
    /// Adjust how text is drawn using object properties.
    /// Object properties can be set globally (with g_object_set()).
    /// Also, with [`TreeViewColumn`][crate::TreeViewColumn], you can bind a property to a value
    /// in a [`TreeModel`][crate::TreeModel]. For example, you can bind the “text” property
    /// on the cell renderer to a string value in the model, thus rendering
    /// a different string in each row of the [`TreeView`][crate::TreeView].
    ///
    /// # Deprecated since 4.10
    ///
    ///
    /// # Returns
    ///
    /// the new cell renderer
    #[cfg_attr(feature = "v4_10", deprecated = "Since 4.10")]
    #[allow(deprecated)]
    #[doc(alias = "gtk_cell_renderer_combo_new")]
    pub fn new() -> CellRendererCombo {
        assert_initialized_main_thread!();
        unsafe { CellRenderer::from_glib_none(ffi::gtk_cell_renderer_combo_new()).unsafe_cast() }
    }

    // rustdoc-stripper-ignore-next
    /// Creates a new builder-pattern struct instance to construct [`CellRendererCombo`] objects.
    ///
    /// This method returns an instance of [`CellRendererComboBuilder`](crate::builders::CellRendererComboBuilder) which can be used to create [`CellRendererCombo`] objects.
    pub fn builder() -> CellRendererComboBuilder {
        CellRendererComboBuilder::new()
    }

    /// If [`true`], the cell renderer will include an entry and allow to enter
    /// values other than the ones in the popup list.
    #[doc(alias = "has-entry")]
    pub fn has_entry(&self) -> bool {
        ObjectExt::property(self, "has-entry")
    }

    /// If [`true`], the cell renderer will include an entry and allow to enter
    /// values other than the ones in the popup list.
    #[doc(alias = "has-entry")]
    pub fn set_has_entry(&self, has_entry: bool) {
        ObjectExt::set_property(self, "has-entry", has_entry)
    }

    /// Holds a tree model containing the possible values for the combo box.
    /// Use the text_column property to specify the column holding the values.
    pub fn model(&self) -> Option<TreeModel> {
        ObjectExt::property(self, "model")
    }

    /// Holds a tree model containing the possible values for the combo box.
    /// Use the text_column property to specify the column holding the values.
    pub fn set_model<P: IsA<TreeModel>>(&self, model: Option<&P>) {
        ObjectExt::set_property(self, "model", model)
    }

    /// Specifies the model column which holds the possible values for the
    /// combo box.
    ///
    /// Note that this refers to the model specified in the model property,
    /// not the model backing the tree view to which
    /// this cell renderer is attached.
    ///
    /// [`CellRendererCombo`][crate::CellRendererCombo] automatically adds a text cell renderer for
    /// this column to its combo box.
    #[doc(alias = "text-column")]
    pub fn text_column(&self) -> i32 {
        ObjectExt::property(self, "text-column")
    }

    /// Specifies the model column which holds the possible values for the
    /// combo box.
    ///
    /// Note that this refers to the model specified in the model property,
    /// not the model backing the tree view to which
    /// this cell renderer is attached.
    ///
    /// [`CellRendererCombo`][crate::CellRendererCombo] automatically adds a text cell renderer for
    /// this column to its combo box.
    #[doc(alias = "text-column")]
    pub fn set_text_column(&self, text_column: i32) {
        ObjectExt::set_property(self, "text-column", text_column)
    }

    /// This signal is emitted each time after the user selected an item in
    /// the combo box, either by using the mouse or the arrow keys.  Contrary
    /// to GtkComboBox, GtkCellRendererCombo::changed is not emitted for
    /// changes made to a selected item in the entry.  The argument @new_iter
    /// corresponds to the newly selected item in the combo box and it is relative
    /// to the GtkTreeModel set via the model property on GtkCellRendererCombo.
    ///
    /// Note that as soon as you change the model displayed in the tree view,
    /// the tree view will immediately cease the editing operating.  This
    /// means that you most probably want to refrain from changing the model
    /// until the combo cell renderer emits the edited or editing_canceled signal.
    /// ## `path_string`
    /// a string of the path identifying the edited cell
    ///               (relative to the tree view model)
    /// ## `new_iter`
    /// the new iter selected in the combo box
    ///            (relative to the combo box model)
    #[doc(alias = "changed")]
    pub fn connect_changed<F: Fn(&Self, TreePath, &TreeIter) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn changed_trampoline<
            F: Fn(&CellRendererCombo, TreePath, &TreeIter) + 'static,
        >(
            this: *mut ffi::GtkCellRendererCombo,
            path_string: *mut std::ffi::c_char,
            new_iter: *mut ffi::GtkTreeIter,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            let path = from_glib_full(crate::ffi::gtk_tree_path_new_from_string(path_string));
            f(&from_glib_borrow(this), path, &from_glib_borrow(new_iter))
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"changed\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    changed_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "has-entry")]
    pub fn connect_has_entry_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_has_entry_trampoline<F: Fn(&CellRendererCombo) + 'static>(
            this: *mut ffi::GtkCellRendererCombo,
            _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 _,
                b"notify::has-entry\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_has_entry_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "model")]
    pub fn connect_model_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_model_trampoline<F: Fn(&CellRendererCombo) + 'static>(
            this: *mut ffi::GtkCellRendererCombo,
            _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 _,
                b"notify::model\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_model_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "text-column")]
    pub fn connect_text_column_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_text_column_trampoline<F: Fn(&CellRendererCombo) + 'static>(
            this: *mut ffi::GtkCellRendererCombo,
            _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 _,
                b"notify::text-column\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_text_column_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl Default for CellRendererCombo {
    fn default() -> Self {
        Self::new()
    }
}

// rustdoc-stripper-ignore-next
/// A [builder-pattern] type to construct [`CellRendererCombo`] objects.
///
/// [builder-pattern]: https://doc.rust-lang.org/1.0.0/style/ownership/builders.html
#[must_use = "The builder must be built to be used"]
pub struct CellRendererComboBuilder {
    builder: glib::object::ObjectBuilder<'static, CellRendererCombo>,
}

impl CellRendererComboBuilder {
    fn new() -> Self {
        Self {
            builder: glib::object::Object::builder(),
        }
    }

    /// If [`true`], the cell renderer will include an entry and allow to enter
    /// values other than the ones in the popup list.
    pub fn has_entry(self, has_entry: bool) -> Self {
        Self {
            builder: self.builder.property("has-entry", has_entry),
        }
    }

    /// Holds a tree model containing the possible values for the combo box.
    /// Use the text_column property to specify the column holding the values.
    pub fn model(self, model: &impl IsA<TreeModel>) -> Self {
        Self {
            builder: self.builder.property("model", model.clone().upcast()),
        }
    }

    /// Specifies the model column which holds the possible values for the
    /// combo box.
    ///
    /// Note that this refers to the model specified in the model property,
    /// not the model backing the tree view to which
    /// this cell renderer is attached.
    ///
    /// [`CellRendererCombo`][crate::CellRendererCombo] automatically adds a text cell renderer for
    /// this column to its combo box.
    pub fn text_column(self, text_column: i32) -> Self {
        Self {
            builder: self.builder.property("text-column", text_column),
        }
    }

    pub fn align_set(self, align_set: bool) -> Self {
        Self {
            builder: self.builder.property("align-set", align_set),
        }
    }

    /// Specifies how to align the lines of text with respect to each other.
    ///
    /// Note that this property describes how to align the lines of text in
    /// case there are several of them. The "xalign" property of [`CellRenderer`][crate::CellRenderer],
    /// on the other hand, sets the horizontal alignment of the whole text.
    pub fn alignment(self, alignment: pango::Alignment) -> Self {
        Self {
            builder: self.builder.property("alignment", alignment),
        }
    }

    pub fn attributes(self, attributes: &pango::AttrList) -> Self {
        Self {
            builder: self.builder.property("attributes", attributes.clone()),
        }
    }

    pub fn background(self, background: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("background", background.into()),
        }
    }

    /// Background color as a [`gdk::RGBA`][crate::gdk::RGBA]
    pub fn background_rgba(self, background_rgba: &gdk::RGBA) -> Self {
        Self {
            builder: self.builder.property("background-rgba", background_rgba),
        }
    }

    pub fn background_set(self, background_set: bool) -> Self {
        Self {
            builder: self.builder.property("background-set", background_set),
        }
    }

    pub fn editable(self, editable: bool) -> Self {
        Self {
            builder: self.builder.property("editable", editable),
        }
    }

    pub fn editable_set(self, editable_set: bool) -> Self {
        Self {
            builder: self.builder.property("editable-set", editable_set),
        }
    }

    /// Specifies the preferred place to ellipsize the string, if the cell renderer
    /// does not have enough room to display the entire string. Setting it to
    /// [`pango::EllipsizeMode::None`][crate::pango::EllipsizeMode::None] turns off ellipsizing. See the wrap-width property
    /// for another way of making the text fit into a given width.
    pub fn ellipsize(self, ellipsize: pango::EllipsizeMode) -> Self {
        Self {
            builder: self.builder.property("ellipsize", ellipsize),
        }
    }

    pub fn ellipsize_set(self, ellipsize_set: bool) -> Self {
        Self {
            builder: self.builder.property("ellipsize-set", ellipsize_set),
        }
    }

    pub fn family(self, family: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("family", family.into()),
        }
    }

    pub fn family_set(self, family_set: bool) -> Self {
        Self {
            builder: self.builder.property("family-set", family_set),
        }
    }

    pub fn font(self, font: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("font", font.into()),
        }
    }

    pub fn font_desc(self, font_desc: &pango::FontDescription) -> Self {
        Self {
            builder: self.builder.property("font-desc", font_desc),
        }
    }

    pub fn foreground(self, foreground: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("foreground", foreground.into()),
        }
    }

    /// Foreground color as a [`gdk::RGBA`][crate::gdk::RGBA]
    pub fn foreground_rgba(self, foreground_rgba: &gdk::RGBA) -> Self {
        Self {
            builder: self.builder.property("foreground-rgba", foreground_rgba),
        }
    }

    pub fn foreground_set(self, foreground_set: bool) -> Self {
        Self {
            builder: self.builder.property("foreground-set", foreground_set),
        }
    }

    pub fn language(self, language: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("language", language.into()),
        }
    }

    pub fn language_set(self, language_set: bool) -> Self {
        Self {
            builder: self.builder.property("language-set", language_set),
        }
    }

    pub fn markup(self, markup: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("markup", markup.into()),
        }
    }

    /// The desired maximum width of the cell, in characters. If this property
    /// is set to -1, the width will be calculated automatically.
    ///
    /// For cell renderers that ellipsize or wrap text; this property
    /// controls the maximum reported width of the cell. The
    /// cell should not receive any greater allocation unless it is
    /// set to expand in its [`CellLayout`][crate::CellLayout] and all of the cell's siblings
    /// have received their natural width.
    pub fn max_width_chars(self, max_width_chars: i32) -> Self {
        Self {
            builder: self.builder.property("max-width-chars", max_width_chars),
        }
    }

    /// The text that will be displayed in the [`CellRenderer`][crate::CellRenderer] if
    /// `GtkCellRendererText:editable` is [`true`] and the cell is empty.
    pub fn placeholder_text(self, placeholder_text: impl Into<glib::GString>) -> Self {
        Self {
            builder: self
                .builder
                .property("placeholder-text", placeholder_text.into()),
        }
    }

    pub fn rise(self, rise: i32) -> Self {
        Self {
            builder: self.builder.property("rise", rise),
        }
    }

    pub fn rise_set(self, rise_set: bool) -> Self {
        Self {
            builder: self.builder.property("rise-set", rise_set),
        }
    }

    pub fn scale(self, scale: f64) -> Self {
        Self {
            builder: self.builder.property("scale", scale),
        }
    }

    pub fn scale_set(self, scale_set: bool) -> Self {
        Self {
            builder: self.builder.property("scale-set", scale_set),
        }
    }

    pub fn single_paragraph_mode(self, single_paragraph_mode: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("single-paragraph-mode", single_paragraph_mode),
        }
    }

    pub fn size(self, size: i32) -> Self {
        Self {
            builder: self.builder.property("size", size),
        }
    }

    pub fn size_points(self, size_points: f64) -> Self {
        Self {
            builder: self.builder.property("size-points", size_points),
        }
    }

    pub fn size_set(self, size_set: bool) -> Self {
        Self {
            builder: self.builder.property("size-set", size_set),
        }
    }

    pub fn stretch(self, stretch: pango::Stretch) -> Self {
        Self {
            builder: self.builder.property("stretch", stretch),
        }
    }

    pub fn stretch_set(self, stretch_set: bool) -> Self {
        Self {
            builder: self.builder.property("stretch-set", stretch_set),
        }
    }

    pub fn strikethrough(self, strikethrough: bool) -> Self {
        Self {
            builder: self.builder.property("strikethrough", strikethrough),
        }
    }

    pub fn strikethrough_set(self, strikethrough_set: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("strikethrough-set", strikethrough_set),
        }
    }

    pub fn style(self, style: pango::Style) -> Self {
        Self {
            builder: self.builder.property("style", style),
        }
    }

    pub fn style_set(self, style_set: bool) -> Self {
        Self {
            builder: self.builder.property("style-set", style_set),
        }
    }

    pub fn text(self, text: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("text", text.into()),
        }
    }

    pub fn underline(self, underline: pango::Underline) -> Self {
        Self {
            builder: self.builder.property("underline", underline),
        }
    }

    pub fn underline_set(self, underline_set: bool) -> Self {
        Self {
            builder: self.builder.property("underline-set", underline_set),
        }
    }

    pub fn variant(self, variant: pango::Variant) -> Self {
        Self {
            builder: self.builder.property("variant", variant),
        }
    }

    pub fn variant_set(self, variant_set: bool) -> Self {
        Self {
            builder: self.builder.property("variant-set", variant_set),
        }
    }

    pub fn weight(self, weight: i32) -> Self {
        Self {
            builder: self.builder.property("weight", weight),
        }
    }

    pub fn weight_set(self, weight_set: bool) -> Self {
        Self {
            builder: self.builder.property("weight-set", weight_set),
        }
    }

    /// The desired width of the cell, in characters. If this property is set to
    /// -1, the width will be calculated automatically, otherwise the cell will
    /// request either 3 characters or the property value, whichever is greater.
    pub fn width_chars(self, width_chars: i32) -> Self {
        Self {
            builder: self.builder.property("width-chars", width_chars),
        }
    }

    /// Specifies how to break the string into multiple lines, if the cell
    /// renderer does not have enough room to display the entire string.
    /// This property has no effect unless the wrap-width property is set.
    pub fn wrap_mode(self, wrap_mode: pango::WrapMode) -> Self {
        Self {
            builder: self.builder.property("wrap-mode", wrap_mode),
        }
    }

    /// Specifies the minimum width at which the text is wrapped. The wrap-mode property can
    /// be used to influence at what character positions the line breaks can be placed.
    /// Setting wrap-width to -1 turns wrapping off.
    pub fn wrap_width(self, wrap_width: i32) -> Self {
        Self {
            builder: self.builder.property("wrap-width", wrap_width),
        }
    }

    pub fn cell_background(self, cell_background: impl Into<glib::GString>) -> Self {
        Self {
            builder: self
                .builder
                .property("cell-background", cell_background.into()),
        }
    }

    /// Cell background as a [`gdk::RGBA`][crate::gdk::RGBA]
    pub fn cell_background_rgba(self, cell_background_rgba: &gdk::RGBA) -> Self {
        Self {
            builder: self
                .builder
                .property("cell-background-rgba", cell_background_rgba),
        }
    }

    pub fn cell_background_set(self, cell_background_set: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("cell-background-set", cell_background_set),
        }
    }

    pub fn height(self, height: i32) -> Self {
        Self {
            builder: self.builder.property("height", height),
        }
    }

    pub fn is_expanded(self, is_expanded: bool) -> Self {
        Self {
            builder: self.builder.property("is-expanded", is_expanded),
        }
    }

    pub fn is_expander(self, is_expander: bool) -> Self {
        Self {
            builder: self.builder.property("is-expander", is_expander),
        }
    }

    pub fn mode(self, mode: CellRendererMode) -> Self {
        Self {
            builder: self.builder.property("mode", mode),
        }
    }

    pub fn sensitive(self, sensitive: bool) -> Self {
        Self {
            builder: self.builder.property("sensitive", sensitive),
        }
    }

    pub fn visible(self, visible: bool) -> Self {
        Self {
            builder: self.builder.property("visible", visible),
        }
    }

    pub fn width(self, width: i32) -> Self {
        Self {
            builder: self.builder.property("width", width),
        }
    }

    pub fn xalign(self, xalign: f32) -> Self {
        Self {
            builder: self.builder.property("xalign", xalign),
        }
    }

    pub fn xpad(self, xpad: u32) -> Self {
        Self {
            builder: self.builder.property("xpad", xpad),
        }
    }

    pub fn yalign(self, yalign: f32) -> Self {
        Self {
            builder: self.builder.property("yalign", yalign),
        }
    }

    pub fn ypad(self, ypad: u32) -> Self {
        Self {
            builder: self.builder.property("ypad", ypad),
        }
    }

    // rustdoc-stripper-ignore-next
    /// Build the [`CellRendererCombo`].
    #[must_use = "Building the object from the builder is usually expensive and is not expected to have side effects"]
    pub fn build(self) -> CellRendererCombo {
        self.builder.build()
    }
}