// This file was generated by gir (https://github.com/gtk-rs/gir)
// from
// from gir-files (https://github.com/gtk-rs/gir-files.git)
// DO NOT EDIT

use crate::ffi;
use glib::{
    prelude::*,
    signal::{connect_raw, SignalHandlerId},
    translate::*,
};
use std::boxed::Box as Box_;

glib::wrapper! {
    /// A tag that can be applied to text in a [`Buffer`][crate::Buffer].
    ///
    /// [`Tag`][crate::Tag] is a subclass of [`gtk::TextTag`][crate::gtk::TextTag] that adds properties useful for
    /// the GtkSourceView library.
    ///
    /// If, for a certain tag, [`gtk::TextTag`][crate::gtk::TextTag] is sufficient, it's better that you create
    /// a [`gtk::TextTag`][crate::gtk::TextTag], not a [`Tag`][crate::Tag].
    ///
    /// ## Properties
    ///
    ///
    /// #### `draw-spaces`
    ///  Whether to draw white spaces.
    ///
    /// This property takes precedence over the value defined by the [`SpaceDrawer`][crate::SpaceDrawer]'s
    /// [`matrix`][struct@crate::SpaceDrawer#matrix] property (only where the tag is applied).
    ///
    /// Setting this property also changes [`draw-spaces-set`][struct@crate::Tag#draw-spaces-set] to
    /// [`true`].
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `draw-spaces-set`
    ///  Whether the [`draw-spaces`][struct@crate::Tag#draw-spaces] property is set and must be
    /// taken into account.
    ///
    /// Readable | Writeable
    /// <details><summary><h4>TextTag</h4></summary>
    ///
    ///
    /// #### `accumulative-margin`
    ///  Whether the margins accumulate or override each other.
    ///
    /// When set to [`true`] the margins of this tag are added to the margins
    /// of any other non-accumulative margins present. When set to [`false`]
    /// the margins override one another (the default).
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `allow-breaks`
    ///  Whether breaks are allowed.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `allow-breaks-set`
    ///  Whether the `allow-breaks` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `background`
    ///  Background color as a string.
    ///
    /// Writeable
    ///
    ///
    /// #### `background-full-height`
    ///  Whether the background color fills the entire line height
    /// or only the height of the tagged characters.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `background-full-height-set`
    ///  Whether the `background-full-height` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `background-rgba`
    ///  Background color as a [`gdk::RGBA`][crate::gdk::RGBA].
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `background-set`
    ///  Whether the `background` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `direction`
    ///  Text direction, e.g. right-to-left or left-to-right.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `editable`
    ///  Whether the text can be modified by the user.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `editable-set`
    ///  Whether the `editable` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `fallback`
    ///  Whether font fallback is enabled.
    ///
    /// When set to [`true`], other fonts will be substituted
    /// where the current font is missing glyphs.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `fallback-set`
    ///  Whether the `fallback` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `family`
    ///  Name of the font family, e.g. Sans, Helvetica, Times, Monospace.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `family-set`
    ///  Whether the `family` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `font`
    ///  Font description as string, e.g. \"Sans Italic 12\".
    ///
    /// Note that the initial value of this property depends on
    /// the internals of [`pango::FontDescription`][crate::pango::FontDescription].
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `font-desc`
    ///  Font description as a [`pango::FontDescription`][crate::pango::FontDescription].
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `font-features`
    ///  OpenType font features, as a string.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `font-features-set`
    ///  Whether the `font-features` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `foreground`
    ///  Foreground color as a string.
    ///
    /// Writeable
    ///
    ///
    /// #### `foreground-rgba`
    ///  Foreground color as a [`gdk::RGBA`][crate::gdk::RGBA].
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `foreground-set`
    ///  Whether the `foreground` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `indent`
    ///  Amount to indent the paragraph, in pixels.
    ///
    /// A negative value of indent will produce a hanging indentation.
    /// That is, the first line will have the full width, and subsequent
    /// lines will be indented by the absolute value of indent.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `indent-set`
    ///  Whether the `indent` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `insert-hyphens`
    ///  Whether to insert hyphens at breaks.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `insert-hyphens-set`
    ///  Whether the `insert-hyphens` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `invisible`
    ///  Whether this text is hidden.
    ///
    /// Note that there may still be problems with the support for invisible
    /// text, in particular when navigating programmatically inside a buffer
    /// containing invisible segments.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `invisible-set`
    ///  Whether the `invisible` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `justification`
    ///  Left, right, or center justification.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `justification-set`
    ///  Whether the `justification` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `language`
    ///  The language this text is in, as an ISO code.
    ///
    /// Pango can use this as a hint when rendering the text.
    /// If not set, an appropriate default will be used.
    ///
    /// Note that the initial value of this property depends
    /// on the current locale, see also `get_default_language()`.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `language-set`
    ///  Whether the `language` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `left-margin`
    ///  Width of the left margin in pixels.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `left-margin-set`
    ///  Whether the `left-margin` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `letter-spacing`
    ///  Extra spacing between graphemes, in Pango units.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `letter-spacing-set`
    ///  Whether the `letter-spacing` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `line-height`
    ///  Factor to scale line height by.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `line-height-set`
    ///  Whether the `line-height` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `name`
    ///  The name used to refer to the tag.
    ///
    /// [`None`] for anonymous tags.
    ///
    /// Readable | Writeable | Construct Only
    ///
    ///
    /// #### `overline`
    ///  Style of overline for this text.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `overline-rgba`
    ///  This property modifies the color of overlines.
    ///
    /// If not set, overlines will use the foreground color.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `overline-rgba-set`
    ///  Whether the `overline-rgba` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `overline-set`
    ///  Whether the `overline` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `paragraph-background`
    ///  The paragraph background color as a string.
    ///
    /// Writeable
    ///
    ///
    /// #### `paragraph-background-rgba`
    ///  The paragraph background color as a [`gdk::RGBA`][crate::gdk::RGBA].
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `paragraph-background-set`
    ///  Whether the `paragraph-background` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `pixels-above-lines`
    ///  Pixels of blank space above paragraphs.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `pixels-above-lines-set`
    ///  Whether the `pixels-above-lines` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `pixels-below-lines`
    ///  Pixels of blank space below paragraphs.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `pixels-below-lines-set`
    ///  Whether the `pixels-below-lines` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `pixels-inside-wrap`
    ///  Pixels of blank space between wrapped lines in a paragraph.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `pixels-inside-wrap-set`
    ///  Whether the `pixels-inside-wrap` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `right-margin`
    ///  Width of the right margin, in pixels.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `right-margin-set`
    ///  Whether the `right-margin` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `rise`
    ///  Offset of text above the baseline, in Pango units.
    ///
    /// Negative values go below the baseline.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `rise-set`
    ///  Whether the `rise` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `scale`
    ///  Font size as a scale factor relative to the default font size.
    ///
    /// This properly adapts to theme changes, etc. so is recommended.
    /// Pango predefines some scales such as `PANGO_SCALE_X_LARGE`.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `scale-set`
    ///  Whether the `scale` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `sentence`
    ///  Whether this tag represents a single sentence.
    ///
    /// This affects cursor movement.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `sentence-set`
    ///  Whether the `sentence` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `show-spaces`
    ///  How to render invisible characters.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `show-spaces-set`
    ///  Whether the `show-spaces` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `size`
    ///  Font size in Pango units.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `size-points`
    ///  Font size in points.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `size-set`
    ///  Whether the `size` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `stretch`
    ///  Font stretch as a [`pango::Stretch`][crate::pango::Stretch], e.g. [`pango::Stretch::Condensed`][crate::pango::Stretch::Condensed].
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `stretch-set`
    ///  Whether the `stretch` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `strikethrough`
    ///  Whether to strike through the text.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `strikethrough-rgba`
    ///  This property modifies the color of strikeouts.
    ///
    /// If not set, strikeouts will use the foreground color.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `strikethrough-rgba-set`
    ///  If the `strikethrough-rgba` property has been set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `strikethrough-set`
    ///  Whether the `strikethrough` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `style`
    ///  Font style as a [`pango::Style`][crate::pango::Style], e.g. [`pango::Style::Italic`][crate::pango::Style::Italic].
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `style-set`
    ///  Whether the `style` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `tabs`
    ///  Custom tabs for this text.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `tabs-set`
    ///  Whether the `tabs` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `text-transform`
    ///  How to transform the text for display.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `text-transform-set`
    ///  Whether the `text-transform` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `underline`
    ///  Style of underline for this text.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `underline-rgba`
    ///  This property modifies the color of underlines.
    ///
    /// If not set, underlines will use the foreground color.
    ///
    /// If [`underline`][struct@crate::gtk::TextTag#underline] is set to [`pango::Underline::Error`][crate::pango::Underline::Error],
    /// an alternate color may be applied instead of the foreground. Setting
    /// this property will always override those defaults.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `underline-rgba-set`
    ///  If the `underline-rgba` property has been set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `underline-set`
    ///  Whether the `underline` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `variant`
    ///  Font variant as a [`pango::Variant`][crate::pango::Variant], e.g. [`pango::Variant::SmallCaps`][crate::pango::Variant::SmallCaps].
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `variant-set`
    ///  Whether the `variant` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `weight`
    ///  Font weight as an integer.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `weight-set`
    ///  Whether the `weight` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `word`
    ///  Whether this tag represents a single word.
    ///
    /// This affects line breaks and cursor movement.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `word-set`
    ///  Whether the `word` property is set.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `wrap-mode`
    ///  Whether to wrap lines never, at word boundaries, or
    /// at character boundaries.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `wrap-mode-set`
    ///  Whether the `wrap-mode` property is set.
    ///
    /// Readable | Writeable
    /// </details>
    ///
    /// # Implements
    ///
    /// [`TagExt`][trait@crate::prelude::TagExt], [`trait@gtk::prelude::TextTagExt`], [`trait@glib::ObjectExt`]
    #[doc(alias = "GtkSourceTag")]
    pub struct Tag(Object<ffi::GtkSourceTag, ffi::GtkSourceTagClass>) @extends gtk::TextTag;

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

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

    /// Creates a [`Tag`][crate::Tag].
    ///
    /// Configure the tag using object arguments, i.e. using [`ObjectExt::set()`][crate::glib::prelude::ObjectExt::set()].
    ///
    /// For usual cases, `Buffer::create_source_tag()` is more convenient to
    /// use.
    /// ## `name`
    /// tag name, or [`None`].
    ///
    /// # Returns
    ///
    /// a new [`Tag`][crate::Tag].
    #[doc(alias = "gtk_source_tag_new")]
    pub fn new(name: Option<&str>) -> Tag {
        assert_initialized_main_thread!();
        unsafe {
            gtk::TextTag::from_glib_full(ffi::gtk_source_tag_new(name.to_glib_none().0))
                .unsafe_cast()
        }
    }

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

impl Default for Tag {
    fn default() -> Self {
        glib::object::Object::new::<Self>()
    }
}

// rustdoc-stripper-ignore-next
/// A [builder-pattern] type to construct [`Tag`] 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 TagBuilder {
    builder: glib::object::ObjectBuilder<'static, Tag>,
}

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

    /// Whether to draw white spaces.
    ///
    /// This property takes precedence over the value defined by the [`SpaceDrawer`][crate::SpaceDrawer]'s
    /// [`matrix`][struct@crate::SpaceDrawer#matrix] property (only where the tag is applied).
    ///
    /// Setting this property also changes [`draw-spaces-set`][struct@crate::Tag#draw-spaces-set] to
    /// [`true`].
    pub fn draw_spaces(self, draw_spaces: bool) -> Self {
        Self {
            builder: self.builder.property("draw-spaces", draw_spaces),
        }
    }

    /// Whether the [`draw-spaces`][struct@crate::Tag#draw-spaces] property is set and must be
    /// taken into account.
    pub fn draw_spaces_set(self, draw_spaces_set: bool) -> Self {
        Self {
            builder: self.builder.property("draw-spaces-set", draw_spaces_set),
        }
    }

    /// Whether the margins accumulate or override each other.
    ///
    /// When set to [`true`] the margins of this tag are added to the margins
    /// of any other non-accumulative margins present. When set to [`false`]
    /// the margins override one another (the default).
    pub fn accumulative_margin(self, accumulative_margin: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("accumulative-margin", accumulative_margin),
        }
    }

    /// Whether breaks are allowed.
    pub fn allow_breaks(self, allow_breaks: bool) -> Self {
        Self {
            builder: self.builder.property("allow-breaks", allow_breaks),
        }
    }

    /// Whether the `allow-breaks` property is set.
    pub fn allow_breaks_set(self, allow_breaks_set: bool) -> Self {
        Self {
            builder: self.builder.property("allow-breaks-set", allow_breaks_set),
        }
    }

    /// Background color as a string.
    pub fn background(self, background: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("background", background.into()),
        }
    }

    /// Whether the background color fills the entire line height
    /// or only the height of the tagged characters.
    pub fn background_full_height(self, background_full_height: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("background-full-height", background_full_height),
        }
    }

    /// Whether the `background-full-height` property is set.
    pub fn background_full_height_set(self, background_full_height_set: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("background-full-height-set", background_full_height_set),
        }
    }

    /// 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),
        }
    }

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

    /// Text direction, e.g. right-to-left or left-to-right.
    pub fn direction(self, direction: gtk::TextDirection) -> Self {
        Self {
            builder: self.builder.property("direction", direction),
        }
    }

    /// Whether the text can be modified by the user.
    pub fn editable(self, editable: bool) -> Self {
        Self {
            builder: self.builder.property("editable", editable),
        }
    }

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

    /// Whether font fallback is enabled.
    ///
    /// When set to [`true`], other fonts will be substituted
    /// where the current font is missing glyphs.
    pub fn fallback(self, fallback: bool) -> Self {
        Self {
            builder: self.builder.property("fallback", fallback),
        }
    }

    /// Whether the `fallback` property is set.
    pub fn fallback_set(self, fallback_set: bool) -> Self {
        Self {
            builder: self.builder.property("fallback-set", fallback_set),
        }
    }

    /// Name of the font family, e.g. Sans, Helvetica, Times, Monospace.
    pub fn family(self, family: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("family", family.into()),
        }
    }

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

    /// Font description as string, e.g. \"Sans Italic 12\".
    ///
    /// Note that the initial value of this property depends on
    /// the internals of [`pango::FontDescription`][crate::pango::FontDescription].
    pub fn font(self, font: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("font", font.into()),
        }
    }

    /// Font description as a [`pango::FontDescription`][crate::pango::FontDescription].
    pub fn font_desc(self, font_desc: &pango::FontDescription) -> Self {
        Self {
            builder: self.builder.property("font-desc", font_desc),
        }
    }

    /// OpenType font features, as a string.
    pub fn font_features(self, font_features: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("font-features", font_features.into()),
        }
    }

    /// Whether the `font-features` property is set.
    pub fn font_features_set(self, font_features_set: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("font-features-set", font_features_set),
        }
    }

    /// Foreground color as a string.
    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),
        }
    }

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

    /// Amount to indent the paragraph, in pixels.
    ///
    /// A negative value of indent will produce a hanging indentation.
    /// That is, the first line will have the full width, and subsequent
    /// lines will be indented by the absolute value of indent.
    pub fn indent(self, indent: i32) -> Self {
        Self {
            builder: self.builder.property("indent", indent),
        }
    }

    /// Whether the `indent` property is set.
    pub fn indent_set(self, indent_set: bool) -> Self {
        Self {
            builder: self.builder.property("indent-set", indent_set),
        }
    }

    /// Whether to insert hyphens at breaks.
    pub fn insert_hyphens(self, insert_hyphens: bool) -> Self {
        Self {
            builder: self.builder.property("insert-hyphens", insert_hyphens),
        }
    }

    /// Whether the `insert-hyphens` property is set.
    pub fn insert_hyphens_set(self, insert_hyphens_set: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("insert-hyphens-set", insert_hyphens_set),
        }
    }

    /// Whether this text is hidden.
    ///
    /// Note that there may still be problems with the support for invisible
    /// text, in particular when navigating programmatically inside a buffer
    /// containing invisible segments.
    pub fn invisible(self, invisible: bool) -> Self {
        Self {
            builder: self.builder.property("invisible", invisible),
        }
    }

    /// Whether the `invisible` property is set.
    pub fn invisible_set(self, invisible_set: bool) -> Self {
        Self {
            builder: self.builder.property("invisible-set", invisible_set),
        }
    }

    /// Left, right, or center justification.
    pub fn justification(self, justification: gtk::Justification) -> Self {
        Self {
            builder: self.builder.property("justification", justification),
        }
    }

    /// Whether the `justification` property is set.
    pub fn justification_set(self, justification_set: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("justification-set", justification_set),
        }
    }

    /// The language this text is in, as an ISO code.
    ///
    /// Pango can use this as a hint when rendering the text.
    /// If not set, an appropriate default will be used.
    ///
    /// Note that the initial value of this property depends
    /// on the current locale, see also `get_default_language()`.
    pub fn language(self, language: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("language", language.into()),
        }
    }

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

    /// Width of the left margin in pixels.
    pub fn left_margin(self, left_margin: i32) -> Self {
        Self {
            builder: self.builder.property("left-margin", left_margin),
        }
    }

    /// Whether the `left-margin` property is set.
    pub fn left_margin_set(self, left_margin_set: bool) -> Self {
        Self {
            builder: self.builder.property("left-margin-set", left_margin_set),
        }
    }

    /// Extra spacing between graphemes, in Pango units.
    pub fn letter_spacing(self, letter_spacing: i32) -> Self {
        Self {
            builder: self.builder.property("letter-spacing", letter_spacing),
        }
    }

    /// Whether the `letter-spacing` property is set.
    pub fn letter_spacing_set(self, letter_spacing_set: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("letter-spacing-set", letter_spacing_set),
        }
    }

    /// Factor to scale line height by.
    #[cfg(feature = "gtk_v4_6")]
    #[cfg_attr(docsrs, doc(cfg(feature = "gtk_v4_6")))]
    pub fn line_height(self, line_height: f32) -> Self {
        Self {
            builder: self.builder.property("line-height", line_height),
        }
    }

    /// Whether the `line-height` property is set.
    pub fn line_height_set(self, line_height_set: bool) -> Self {
        Self {
            builder: self.builder.property("line-height-set", line_height_set),
        }
    }

    /// The name used to refer to the tag.
    ///
    /// [`None`] for anonymous tags.
    pub fn name(self, name: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("name", name.into()),
        }
    }

    /// Style of overline for this text.
    pub fn overline(self, overline: pango::Overline) -> Self {
        Self {
            builder: self.builder.property("overline", overline),
        }
    }

    /// This property modifies the color of overlines.
    ///
    /// If not set, overlines will use the foreground color.
    pub fn overline_rgba(self, overline_rgba: &gdk::RGBA) -> Self {
        Self {
            builder: self.builder.property("overline-rgba", overline_rgba),
        }
    }

    /// Whether the `overline-rgba` property is set.
    pub fn overline_rgba_set(self, overline_rgba_set: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("overline-rgba-set", overline_rgba_set),
        }
    }

    /// Whether the `overline` property is set.
    pub fn overline_set(self, overline_set: bool) -> Self {
        Self {
            builder: self.builder.property("overline-set", overline_set),
        }
    }

    /// The paragraph background color as a string.
    pub fn paragraph_background(self, paragraph_background: impl Into<glib::GString>) -> Self {
        Self {
            builder: self
                .builder
                .property("paragraph-background", paragraph_background.into()),
        }
    }

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

    /// Whether the `paragraph-background` property is set.
    pub fn paragraph_background_set(self, paragraph_background_set: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("paragraph-background-set", paragraph_background_set),
        }
    }

    /// Pixels of blank space above paragraphs.
    pub fn pixels_above_lines(self, pixels_above_lines: i32) -> Self {
        Self {
            builder: self
                .builder
                .property("pixels-above-lines", pixels_above_lines),
        }
    }

    /// Whether the `pixels-above-lines` property is set.
    pub fn pixels_above_lines_set(self, pixels_above_lines_set: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("pixels-above-lines-set", pixels_above_lines_set),
        }
    }

    /// Pixels of blank space below paragraphs.
    pub fn pixels_below_lines(self, pixels_below_lines: i32) -> Self {
        Self {
            builder: self
                .builder
                .property("pixels-below-lines", pixels_below_lines),
        }
    }

    /// Whether the `pixels-below-lines` property is set.
    pub fn pixels_below_lines_set(self, pixels_below_lines_set: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("pixels-below-lines-set", pixels_below_lines_set),
        }
    }

    /// Pixels of blank space between wrapped lines in a paragraph.
    pub fn pixels_inside_wrap(self, pixels_inside_wrap: i32) -> Self {
        Self {
            builder: self
                .builder
                .property("pixels-inside-wrap", pixels_inside_wrap),
        }
    }

    /// Whether the `pixels-inside-wrap` property is set.
    pub fn pixels_inside_wrap_set(self, pixels_inside_wrap_set: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("pixels-inside-wrap-set", pixels_inside_wrap_set),
        }
    }

    /// Width of the right margin, in pixels.
    pub fn right_margin(self, right_margin: i32) -> Self {
        Self {
            builder: self.builder.property("right-margin", right_margin),
        }
    }

    /// Whether the `right-margin` property is set.
    pub fn right_margin_set(self, right_margin_set: bool) -> Self {
        Self {
            builder: self.builder.property("right-margin-set", right_margin_set),
        }
    }

    /// Offset of text above the baseline, in Pango units.
    ///
    /// Negative values go below the baseline.
    pub fn rise(self, rise: i32) -> Self {
        Self {
            builder: self.builder.property("rise", rise),
        }
    }

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

    /// Font size as a scale factor relative to the default font size.
    ///
    /// This properly adapts to theme changes, etc. so is recommended.
    /// Pango predefines some scales such as `PANGO_SCALE_X_LARGE`.
    pub fn scale(self, scale: f64) -> Self {
        Self {
            builder: self.builder.property("scale", scale),
        }
    }

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

    /// Whether this tag represents a single sentence.
    ///
    /// This affects cursor movement.
    #[cfg(feature = "gtk_v4_6")]
    #[cfg_attr(docsrs, doc(cfg(feature = "gtk_v4_6")))]
    pub fn sentence(self, sentence: bool) -> Self {
        Self {
            builder: self.builder.property("sentence", sentence),
        }
    }

    /// Whether the `sentence` property is set.
    pub fn sentence_set(self, sentence_set: bool) -> Self {
        Self {
            builder: self.builder.property("sentence-set", sentence_set),
        }
    }

    /// How to render invisible characters.
    pub fn show_spaces(self, show_spaces: pango::ShowFlags) -> Self {
        Self {
            builder: self.builder.property("show-spaces", show_spaces),
        }
    }

    /// Whether the `show-spaces` property is set.
    pub fn show_spaces_set(self, show_spaces_set: bool) -> Self {
        Self {
            builder: self.builder.property("show-spaces-set", show_spaces_set),
        }
    }

    /// Font size in Pango units.
    pub fn size(self, size: i32) -> Self {
        Self {
            builder: self.builder.property("size", size),
        }
    }

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

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

    /// Font stretch as a [`pango::Stretch`][crate::pango::Stretch], e.g. [`pango::Stretch::Condensed`][crate::pango::Stretch::Condensed].
    pub fn stretch(self, stretch: pango::Stretch) -> Self {
        Self {
            builder: self.builder.property("stretch", stretch),
        }
    }

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

    /// Whether to strike through the text.
    pub fn strikethrough(self, strikethrough: bool) -> Self {
        Self {
            builder: self.builder.property("strikethrough", strikethrough),
        }
    }

    /// This property modifies the color of strikeouts.
    ///
    /// If not set, strikeouts will use the foreground color.
    pub fn strikethrough_rgba(self, strikethrough_rgba: &gdk::RGBA) -> Self {
        Self {
            builder: self
                .builder
                .property("strikethrough-rgba", strikethrough_rgba),
        }
    }

    /// If the `strikethrough-rgba` property has been set.
    pub fn strikethrough_rgba_set(self, strikethrough_rgba_set: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("strikethrough-rgba-set", strikethrough_rgba_set),
        }
    }

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

    /// Font style as a [`pango::Style`][crate::pango::Style], e.g. [`pango::Style::Italic`][crate::pango::Style::Italic].
    pub fn style(self, style: pango::Style) -> Self {
        Self {
            builder: self.builder.property("style", style),
        }
    }

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

    /// Custom tabs for this text.
    pub fn tabs(self, tabs: &pango::TabArray) -> Self {
        Self {
            builder: self.builder.property("tabs", tabs),
        }
    }

    /// Whether the `tabs` property is set.
    pub fn tabs_set(self, tabs_set: bool) -> Self {
        Self {
            builder: self.builder.property("tabs-set", tabs_set),
        }
    }

    /// How to transform the text for display.
    #[cfg(feature = "gtk_v4_6")]
    #[cfg_attr(docsrs, doc(cfg(feature = "gtk_v4_6")))]
    pub fn text_transform(self, text_transform: pango::TextTransform) -> Self {
        Self {
            builder: self.builder.property("text-transform", text_transform),
        }
    }

    /// Whether the `text-transform` property is set.
    pub fn text_transform_set(self, text_transform_set: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("text-transform-set", text_transform_set),
        }
    }

    /// Style of underline for this text.
    pub fn underline(self, underline: pango::Underline) -> Self {
        Self {
            builder: self.builder.property("underline", underline),
        }
    }

    /// This property modifies the color of underlines.
    ///
    /// If not set, underlines will use the foreground color.
    ///
    /// If [`underline`][struct@crate::gtk::TextTag#underline] is set to [`pango::Underline::Error`][crate::pango::Underline::Error],
    /// an alternate color may be applied instead of the foreground. Setting
    /// this property will always override those defaults.
    pub fn underline_rgba(self, underline_rgba: &gdk::RGBA) -> Self {
        Self {
            builder: self.builder.property("underline-rgba", underline_rgba),
        }
    }

    /// If the `underline-rgba` property has been set.
    pub fn underline_rgba_set(self, underline_rgba_set: bool) -> Self {
        Self {
            builder: self
                .builder
                .property("underline-rgba-set", underline_rgba_set),
        }
    }

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

    /// Font variant as a [`pango::Variant`][crate::pango::Variant], e.g. [`pango::Variant::SmallCaps`][crate::pango::Variant::SmallCaps].
    pub fn variant(self, variant: pango::Variant) -> Self {
        Self {
            builder: self.builder.property("variant", variant),
        }
    }

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

    /// Font weight as an integer.
    pub fn weight(self, weight: i32) -> Self {
        Self {
            builder: self.builder.property("weight", weight),
        }
    }

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

    /// Whether this tag represents a single word.
    ///
    /// This affects line breaks and cursor movement.
    #[cfg(feature = "gtk_v4_6")]
    #[cfg_attr(docsrs, doc(cfg(feature = "gtk_v4_6")))]
    pub fn word(self, word: bool) -> Self {
        Self {
            builder: self.builder.property("word", word),
        }
    }

    /// Whether the `word` property is set.
    pub fn word_set(self, word_set: bool) -> Self {
        Self {
            builder: self.builder.property("word-set", word_set),
        }
    }

    /// Whether to wrap lines never, at word boundaries, or
    /// at character boundaries.
    pub fn wrap_mode(self, wrap_mode: gtk::WrapMode) -> Self {
        Self {
            builder: self.builder.property("wrap-mode", wrap_mode),
        }
    }

    /// Whether the `wrap-mode` property is set.
    pub fn wrap_mode_set(self, wrap_mode_set: bool) -> Self {
        Self {
            builder: self.builder.property("wrap-mode-set", wrap_mode_set),
        }
    }

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

mod sealed {
    pub trait Sealed {}
    impl<T: super::IsA<super::Tag>> Sealed for T {}
}

/// Trait containing all [`struct@Tag`] methods.
///
/// # Implementors
///
/// [`Tag`][struct@crate::Tag]
pub trait TagExt: IsA<Tag> + sealed::Sealed + 'static {
    /// Whether to draw white spaces.
    ///
    /// This property takes precedence over the value defined by the [`SpaceDrawer`][crate::SpaceDrawer]'s
    /// [`matrix`][struct@crate::SpaceDrawer#matrix] property (only where the tag is applied).
    ///
    /// Setting this property also changes [`draw-spaces-set`][struct@crate::Tag#draw-spaces-set] to
    /// [`true`].
    #[doc(alias = "draw-spaces")]
    fn draws_spaces(&self) -> bool {
        ObjectExt::property(self.as_ref(), "draw-spaces")
    }

    /// Whether to draw white spaces.
    ///
    /// This property takes precedence over the value defined by the [`SpaceDrawer`][crate::SpaceDrawer]'s
    /// [`matrix`][struct@crate::SpaceDrawer#matrix] property (only where the tag is applied).
    ///
    /// Setting this property also changes [`draw-spaces-set`][struct@crate::Tag#draw-spaces-set] to
    /// [`true`].
    #[doc(alias = "draw-spaces")]
    fn set_draw_spaces(&self, draw_spaces: bool) {
        ObjectExt::set_property(self.as_ref(), "draw-spaces", draw_spaces)
    }

    /// Whether the [`draw-spaces`][struct@crate::Tag#draw-spaces] property is set and must be
    /// taken into account.
    #[doc(alias = "draw-spaces-set")]
    fn draws_spaces_set(&self) -> bool {
        ObjectExt::property(self.as_ref(), "draw-spaces-set")
    }

    /// Whether the [`draw-spaces`][struct@crate::Tag#draw-spaces] property is set and must be
    /// taken into account.
    #[doc(alias = "draw-spaces-set")]
    fn set_draw_spaces_set(&self, draw_spaces_set: bool) {
        ObjectExt::set_property(self.as_ref(), "draw-spaces-set", draw_spaces_set)
    }

    #[doc(alias = "draw-spaces")]
    fn connect_draw_spaces_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_draw_spaces_trampoline<P: IsA<Tag>, F: Fn(&P) + 'static>(
            this: *mut ffi::GtkSourceTag,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(Tag::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::draw-spaces\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_draw_spaces_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[doc(alias = "draw-spaces-set")]
    fn connect_draw_spaces_set_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_draw_spaces_set_trampoline<P: IsA<Tag>, F: Fn(&P) + 'static>(
            this: *mut ffi::GtkSourceTag,
            _param_spec: glib::ffi::gpointer,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(Tag::from_glib_borrow(this).unsafe_cast_ref())
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::draw-spaces-set\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_draw_spaces_set_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl<O: IsA<Tag>> TagExt for O {}