gtk4/auto/

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

#[cfg(feature = "v4_14")]
#[cfg_attr(docsrs, doc(cfg(feature = "v4_14")))]
use crate::AccessibleText;
#[cfg(feature = "v4_6")]
#[cfg_attr(docsrs, doc(cfg(feature = "v4_6")))]
use crate::NaturalWrapMode;
use crate::{
    ffi, Accessible, AccessibleRole, Align, Buildable, ConstraintTarget, Justification,
    LayoutManager, MovementStep, Overflow, Widget,
};
use glib::{
    prelude::*,
    signal::{connect_raw, SignalHandlerId},
    translate::*,
};
use std::boxed::Box as Box_;

#[cfg(feature = "v4_14")]
#[cfg_attr(docsrs, doc(cfg(feature = "v4_14")))]
glib::wrapper! {
    /// Displays a small amount of text.
    ///
    /// Most labels are used to label another widget (such as an [`Entry`][crate::Entry]).
    ///
    /// ![An example GtkLabel](label.png)
    ///
    /// ## Shortcuts and Gestures
    ///
    /// [`Label`][crate::Label] supports the following keyboard shortcuts, when the cursor is
    /// visible:
    ///
    /// - <kbd>Shift</kbd>+<kbd>F10</kbd> or <kbd>Menu</kbd> opens the context menu.
    /// - <kbd>Ctrl</kbd>+<kbd>A</kbd> or <kbd>Ctrl</kbd>+<kbd>&sol;</kbd>
    ///   selects all.
    /// - <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd> or
    ///   <kbd>Ctrl</kbd>+<kbd>&bsol;</kbd> unselects all.
    ///
    /// Additionally, the following signals have default keybindings:
    ///
    /// - [`activate-current-link`][struct@crate::Label#activate-current-link]
    /// - [`copy-clipboard`][struct@crate::Label#copy-clipboard]
    /// - [`move-cursor`][struct@crate::Label#move-cursor]
    ///
    /// ## Actions
    ///
    /// [`Label`][crate::Label] defines a set of built-in actions:
    ///
    /// - `clipboard.copy` copies the text to the clipboard.
    /// - `clipboard.cut` doesn't do anything, since text in labels can't be deleted.
    /// - `clipboard.paste` doesn't do anything, since text in labels can't be
    ///   edited.
    /// - `link.open` opens the link, when activated on a link inside the label.
    /// - `link.copy` copies the link to the clipboard, when activated on a link
    ///   inside the label.
    /// - `menu.popup` opens the context menu.
    /// - `selection.delete` doesn't do anything, since text in labels can't be
    ///   deleted.
    /// - `selection.select-all` selects all of the text, if the label allows
    ///   selection.
    ///
    /// ## CSS nodes
    ///
    /// ```text
    /// label
    /// ├── [selection]
    /// ├── [link]
    /// ┊
    /// ╰── [link]
    /// ```
    ///
    /// [`Label`][crate::Label] has a single CSS node with the name label. A wide variety
    /// of style classes may be applied to labels, such as .title, .subtitle,
    /// .dim-label, etc. In the [`ShortcutsWindow`][crate::ShortcutsWindow], labels are used with the
    /// .keycap style class.
    ///
    /// If the label has a selection, it gets a subnode with name selection.
    ///
    /// If the label has links, there is one subnode per link. These subnodes
    /// carry the link or visited state depending on whether they have been
    /// visited. In this case, label node also gets a .link style class.
    ///
    /// ## GtkLabel as GtkBuildable
    ///
    /// The GtkLabel implementation of the GtkBuildable interface supports a
    /// custom `<attributes>` element, which supports any number of `<attribute>`
    /// elements. The `<attribute>` element has attributes named “name“, “value“,
    /// “start“ and “end“ and allows you to specify `Pango::Attribute`
    /// values for this label.
    ///
    /// An example of a UI definition fragment specifying Pango attributes:
    ///
    /// ```xml
    /// <object class="GtkLabel">
    ///   <attributes>
    ///     <attribute name="weight" value="PANGO_WEIGHT_BOLD"/>
    ///     <attribute name="background" value="red" start="5" end="10"/>
    ///   </attributes>
    /// </object>
    /// ```
    ///
    /// The start and end attributes specify the range of characters to which the
    /// Pango attribute applies. If start and end are not specified, the attribute is
    /// applied to the whole text. Note that specifying ranges does not make much
    /// sense with translatable attributes. Use markup embedded in the translatable
    /// content instead.
    ///
    /// ## Accessibility
    ///
    /// [`Label`][crate::Label] uses the [enum@Gtk.AccessibleRole.label] role.
    ///
    /// ## Mnemonics
    ///
    /// Labels may contain “mnemonics”. Mnemonics are underlined characters in the
    /// label, used for keyboard navigation. Mnemonics are created by providing a
    /// string with an underscore before the mnemonic character, such as `"_File"`,
    /// to the functions [`with_mnemonic()`][Self::with_mnemonic()] or
    /// [`set_text_with_mnemonic()`][Self::set_text_with_mnemonic()].
    ///
    /// Mnemonics automatically activate any activatable widget the label is
    /// inside, such as a [`Button`][crate::Button]; if the label is not inside the
    /// mnemonic’s target widget, you have to tell the label about the target
    /// using [`set_mnemonic_widget()`][Self::set_mnemonic_widget()].
    ///
    /// Here’s a simple example where the label is inside a button:
    ///
    /// **⚠️ The following code is in c ⚠️**
    ///
    /// ```c
    /// // Pressing Alt+H will activate this button
    /// GtkWidget *button = gtk_button_new ();
    /// GtkWidget *label = gtk_label_new_with_mnemonic ("_Hello");
    /// gtk_button_set_child (GTK_BUTTON (button), label);
    /// ```
    ///
    /// There’s a convenience function to create buttons with a mnemonic label
    /// already inside:
    ///
    /// **⚠️ The following code is in c ⚠️**
    ///
    /// ```c
    /// // Pressing Alt+H will activate this button
    /// GtkWidget *button = gtk_button_new_with_mnemonic ("_Hello");
    /// ```
    ///
    /// To create a mnemonic for a widget alongside the label, such as a
    /// [`Entry`][crate::Entry], you have to point the label at the entry with
    /// [`set_mnemonic_widget()`][Self::set_mnemonic_widget()]:
    ///
    /// **⚠️ The following code is in c ⚠️**
    ///
    /// ```c
    /// // Pressing Alt+H will focus the entry
    /// GtkWidget *entry = gtk_entry_new ();
    /// GtkWidget *label = gtk_label_new_with_mnemonic ("_Hello");
    /// gtk_label_set_mnemonic_widget (GTK_LABEL (label), entry);
    /// ```
    ///
    /// ## Markup (styled text)
    ///
    /// To make it easy to format text in a label (changing colors, fonts, etc.),
    /// label text can be provided in a simple markup format:
    ///
    /// Here’s how to create a label with a small font:
    /// **⚠️ The following code is in c ⚠️**
    ///
    /// ```c
    /// GtkWidget *label = gtk_label_new (NULL);
    /// gtk_label_set_markup (GTK_LABEL (label), "<small>Small text</small>");
    /// ```
    ///
    /// (See the Pango manual for complete documentation] of available
    /// tags, `parse_markup()`)
    ///
    /// The markup passed to [`set_markup()`][Self::set_markup()] must be valid XML; for example,
    /// literal `<`, `>` and `&` characters must be escaped as `&lt;`, `&gt;`, and `&amp;`.
    /// If you pass text obtained from the user, file, or a network to
    /// [`set_markup()`][Self::set_markup()], you’ll want to escape it with
    /// `markup_escape_text()` or `markup_printf_escaped()`.
    ///
    /// Markup strings are just a convenient way to set the [`pango::AttrList`][crate::pango::AttrList]
    /// on a label; [`set_attributes()`][Self::set_attributes()] may be a simpler way to set
    /// attributes in some cases. Be careful though; [`pango::AttrList`][crate::pango::AttrList] tends
    /// to cause internationalization problems, unless you’re applying attributes
    /// to the entire string (i.e. unless you set the range of each attribute
    /// to [0, `G_MAXINT`)). The reason is that specifying the `start_index` and
    /// `end_index` for a `Pango::Attribute` requires knowledge of the exact
    /// string being displayed, so translations will cause problems.
    ///
    /// ## Selectable labels
    ///
    /// Labels can be made selectable with [`set_selectable()`][Self::set_selectable()].
    /// Selectable labels allow the user to copy the label contents to the
    /// clipboard. Only labels that contain useful-to-copy information — such
    /// as error messages — should be made selectable.
    ///
    /// ## Text layout
    ///
    /// A label can contain any number of paragraphs, but will have
    /// performance problems if it contains more than a small number.
    /// Paragraphs are separated by newlines or other paragraph separators
    /// understood by Pango.
    ///
    /// Labels can automatically wrap text if you call [`set_wrap()`][Self::set_wrap()].
    ///
    /// [`set_justify()`][Self::set_justify()] sets how the lines in a label align
    /// with one another. If you want to set how the label as a whole aligns
    /// in its available space, see the [`halign`][struct@crate::Widget#halign] and
    /// [`valign`][struct@crate::Widget#valign] properties.
    ///
    /// The [`width-chars`][struct@crate::Label#width-chars] and [`max-width-chars`][struct@crate::Label#max-width-chars]
    /// properties can be used to control the size allocation of ellipsized or
    /// wrapped labels. For ellipsizing labels, if either is specified (and less
    /// than the actual text size), it is used as the minimum width, and the actual
    /// text size is used as the natural width of the label. For wrapping labels,
    /// width-chars is used as the minimum width, if specified, and max-width-chars
    /// is used as the natural width. Even if max-width-chars specified, wrapping
    /// labels will be rewrapped to use all of the available width.
    ///
    /// ## Links
    ///
    /// GTK supports markup for clickable hyperlinks in addition to regular Pango
    /// markup. The markup for links is borrowed from HTML, using the `<a>` tag
    /// with “href“, “title“ and “class“ attributes. GTK renders links similar to
    /// the way they appear in web browsers, with colored, underlined text. The
    /// “title“ attribute is displayed as a tooltip on the link. The “class“
    /// attribute is used as style class on the CSS node for the link.
    ///
    /// An example of inline links looks like this:
    ///
    /// **⚠️ The following code is in c ⚠️**
    ///
    /// ```c
    /// const char *text =
    /// "Go to the "
    /// "<a href=\"https://www.gtk.org\" title=\"&lt;i&gt;Our&lt;/i&gt; website\">"
    /// "GTK website</a> for more...";
    /// GtkWidget *label = gtk_label_new (NULL);
    /// gtk_label_set_markup (GTK_LABEL (label), text);
    /// ```
    ///
    /// It is possible to implement custom handling for links and their tooltips
    /// with the [`activate-link`][struct@crate::Label#activate-link] signal and the
    /// [`current_uri()`][Self::current_uri()] function.
    ///
    /// ## Properties
    ///
    ///
    /// #### `attributes`
    ///  A list of style attributes to apply to the text of the label.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `ellipsize`
    ///  The preferred place to ellipsize the string, if the label does
    /// not have enough room to display the entire string.
    ///
    /// Note that setting this property to a value other than
    /// [enum.Pango.EllipsizeMode.none] has the side-effect that the label requests
    /// only enough space to display the ellipsis "...". In particular, this
    /// means that ellipsizing labels do not work well in notebook tabs, unless
    /// the [`tab-expand`][struct@crate::NotebookPage#tab-expand] child property is set to true.
    ///
    /// Other ways to set a label's width are [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()]
    /// and [`Label::set_width_chars()`][crate::Label::set_width_chars()].
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `extra-menu`
    ///  A menu model whose contents will be appended to the context menu.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `justify`
    ///  The alignment of the lines in the text of the label, relative to each other.
    ///
    /// This does *not* affect the alignment of the label within its allocation.
    /// See [`xalign`][struct@crate::Label#xalign] for that.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `label`
    ///  The contents of the label.
    ///
    /// If the string contains Pango markup (see `parse_markup()`),
    /// you will have to set the [`use-markup`][struct@crate::Label#use-markup] property to
    /// true in order for the label to display the markup attributes. See also
    /// [`Label::set_markup()`][crate::Label::set_markup()] for a convenience function that sets both
    /// this property and the [`use-markup`][struct@crate::Label#use-markup] property at the
    /// same time.
    ///
    /// If the string contains underlines acting as mnemonics, you will have to
    /// set the [`use-underline`][struct@crate::Label#use-underline] property to true in order
    /// for the label to display them.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `lines`
    ///  The number of lines to which an ellipsized, wrapping label
    /// should be limited.
    ///
    /// This property has no effect if the label is not wrapping or ellipsized.
    ///
    /// Set this property to -1 if you don't want to limit the number of lines.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `max-width-chars`
    ///  The desired maximum width of the label, in characters.
    ///
    /// If this property is set to -1, the width will be calculated automatically.
    ///
    /// See the section on [text layout](class.Label.html#text-layout) for details
    /// of how [`width-chars`][struct@crate::Label#width-chars] and [`max-width-chars`][struct@crate::Label#max-width-chars]
    /// determine the width of ellipsized and wrapped labels.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `mnemonic-keyval`
    ///  The mnemonic accelerator key for the label.
    ///
    /// Readable
    ///
    ///
    /// #### `mnemonic-widget`
    ///  The widget to be activated when the labels mnemonic key is pressed.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `natural-wrap-mode`
    ///  Select the line wrapping for the natural size request.
    ///
    /// This only affects the natural size requested. For the actual wrapping
    /// used, see the [`wrap-mode`][struct@crate::Label#wrap-mode] property.
    ///
    /// The default is [enum@Gtk.NaturalWrapMode.inherit], which inherits
    /// the behavior of the [`wrap-mode`][struct@crate::Label#wrap-mode] property.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `selectable`
    ///  Whether the label text can be selected with the mouse.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `single-line-mode`
    ///  Whether the label is in single line mode.
    ///
    /// In single line mode, the height of the label does not depend on the
    /// actual text, it is always set to ascent + descent of the font. This
    /// can be an advantage in situations where resizing the label because
    /// of text changes would be distracting, e.g. in a statusbar.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `tabs`
    ///  Custom tabs for this label.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `use-markup`
    ///  True if the text of the label includes Pango markup.
    ///
    /// See `parse_markup()`.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `use-underline`
    ///  True if the text of the label indicates a mnemonic with an `_`
    /// before the mnemonic character.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `width-chars`
    ///  The desired width of the label, in characters.
    ///
    /// If this property is set to -1, the width will be calculated automatically.
    ///
    /// See the section on [text layout](class.Label.html#text-layout) for details
    /// of how [`width-chars`][struct@crate::Label#width-chars] and [`max-width-chars`][struct@crate::Label#max-width-chars]
    /// determine the width of ellipsized and wrapped labels.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `wrap`
    ///  True if the label text will wrap if it gets too wide.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `wrap-mode`
    ///  Controls how the line wrapping is done.
    ///
    /// This only affects the formatting if line wrapping is on (see the
    /// [`wrap`][struct@crate::Label#wrap] property). The default is [enum@Pango.WrapMode.word],
    /// which means wrap on word boundaries.
    ///
    /// For sizing behavior, also consider the [`natural-wrap-mode`][struct@crate::Label#natural-wrap-mode]
    /// property.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `xalign`
    ///  The horizontal alignment of the label text inside its size allocation.
    ///
    /// Compare this to [`halign`][struct@crate::Widget#halign], which determines how the
    /// labels size allocation is positioned in the space available for the label.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `yalign`
    ///  The vertical alignment of the label text inside its size allocation.
    ///
    /// Compare this to [`valign`][struct@crate::Widget#valign], which determines how the
    /// labels size allocation is positioned in the space available for the label.
    ///
    /// Readable | Writeable
    /// <details><summary><h4>Widget</h4></summary>
    ///
    ///
    /// #### `can-focus`
    ///  Whether the widget or any of its descendents can accept
    /// the input focus.
    ///
    /// This property is meant to be set by widget implementations,
    /// typically in their instance init function.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `can-target`
    ///  Whether the widget can receive pointer events.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `css-classes`
    ///  A list of css classes applied to this widget.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `css-name`
    ///  The name of this widget in the CSS tree.
    ///
    /// This property is meant to be set by widget implementations,
    /// typically in their instance init function.
    ///
    /// Readable | Writeable | Construct Only
    ///
    ///
    /// #### `cursor`
    ///  The cursor used by @widget.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `focus-on-click`
    ///  Whether the widget should grab focus when it is clicked with the mouse.
    ///
    /// This property is only relevant for widgets that can take focus.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `focusable`
    ///  Whether this widget itself will accept the input focus.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `halign`
    ///  How to distribute horizontal space if widget gets extra space.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `has-default`
    ///  Whether the widget is the default widget.
    ///
    /// Readable
    ///
    ///
    /// #### `has-focus`
    ///  Whether the widget has the input focus.
    ///
    /// Readable
    ///
    ///
    /// #### `has-tooltip`
    ///  Enables or disables the emission of the [`query-tooltip`][struct@crate::Widget#query-tooltip]
    /// signal on @widget.
    ///
    /// A true value indicates that @widget can have a tooltip, in this case
    /// the widget will be queried using [`query-tooltip`][struct@crate::Widget#query-tooltip] to
    /// determine whether it will provide a tooltip or not.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `height-request`
    ///  Overrides for height request of the widget.
    ///
    /// If this is -1, the natural request will be used.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `hexpand`
    ///  Whether to expand horizontally.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `hexpand-set`
    ///  Whether to use the `hexpand` property.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `layout-manager`
    ///  The [`LayoutManager`][crate::LayoutManager] instance to use to compute
    /// the preferred size of the widget, and allocate its children.
    ///
    /// This property is meant to be set by widget implementations,
    /// typically in their instance init function.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `margin-bottom`
    ///  Margin on bottom side of widget.
    ///
    /// This property adds margin outside of the widget's normal size
    /// request, the margin will be added in addition to the size from
    /// [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()] for example.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `margin-end`
    ///  Margin on end of widget, horizontally.
    ///
    /// This property supports left-to-right and right-to-left text
    /// directions.
    ///
    /// This property adds margin outside of the widget's normal size
    /// request, the margin will be added in addition to the size from
    /// [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()] for example.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `margin-start`
    ///  Margin on start of widget, horizontally.
    ///
    /// This property supports left-to-right and right-to-left text
    /// directions.
    ///
    /// This property adds margin outside of the widget's normal size
    /// request, the margin will be added in addition to the size from
    /// [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()] for example.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `margin-top`
    ///  Margin on top side of widget.
    ///
    /// This property adds margin outside of the widget's normal size
    /// request, the margin will be added in addition to the size from
    /// [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()] for example.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `name`
    ///  The name of the widget.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `opacity`
    ///  The requested opacity of the widget.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `overflow`
    ///  How content outside the widget's content area is treated.
    ///
    /// This property is meant to be set by widget implementations,
    /// typically in their instance init function.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `parent`
    ///  The parent widget of this widget.
    ///
    /// Readable
    ///
    ///
    /// #### `receives-default`
    ///  Whether the widget will receive the default action when it is focused.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `root`
    ///  The [`Root`][crate::Root] widget of the widget tree containing this widget.
    ///
    /// This will be `NULL` if the widget is not contained in a root widget.
    ///
    /// Readable
    ///
    ///
    /// #### `scale-factor`
    ///  The scale factor of the widget.
    ///
    /// Readable
    ///
    ///
    /// #### `sensitive`
    ///  Whether the widget responds to input.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `tooltip-markup`
    ///  Sets the text of tooltip to be the given string, which is marked up
    /// with Pango markup.
    ///
    /// Also see [`Tooltip::set_markup()`][crate::Tooltip::set_markup()].
    ///
    /// This is a convenience property which will take care of getting the
    /// tooltip shown if the given string is not `NULL`:
    /// [`has-tooltip`][struct@crate::Widget#has-tooltip] will automatically be set to true
    /// and there will be taken care of [`query-tooltip`][struct@crate::Widget#query-tooltip] in
    /// the default signal handler.
    ///
    /// Note that if both [`tooltip-text`][struct@crate::Widget#tooltip-text] and
    /// [`tooltip-markup`][struct@crate::Widget#tooltip-markup] are set, the last one wins.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `tooltip-text`
    ///  Sets the text of tooltip to be the given string.
    ///
    /// Also see [`Tooltip::set_text()`][crate::Tooltip::set_text()].
    ///
    /// This is a convenience property which will take care of getting the
    /// tooltip shown if the given string is not `NULL`:
    /// [`has-tooltip`][struct@crate::Widget#has-tooltip] will automatically be set to true
    /// and there will be taken care of [`query-tooltip`][struct@crate::Widget#query-tooltip] in
    /// the default signal handler.
    ///
    /// Note that if both [`tooltip-text`][struct@crate::Widget#tooltip-text] and
    /// [`tooltip-markup`][struct@crate::Widget#tooltip-markup] are set, the last one wins.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `valign`
    ///  How to distribute vertical space if widget gets extra space.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `vexpand`
    ///  Whether to expand vertically.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `vexpand-set`
    ///  Whether to use the `vexpand` property.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `visible`
    ///  Whether the widget is visible.
    ///
    /// Readable | Writeable
    ///
    ///
    /// #### `width-request`
    ///  Overrides for width request of the widget.
    ///
    /// If this is -1, the natural request will be used.
    ///
    /// Readable | Writeable
    /// </details>
    /// <details><summary><h4>Accessible</h4></summary>
    ///
    ///
    /// #### `accessible-role`
    ///  The accessible role of the given [`Accessible`][crate::Accessible] implementation.
    ///
    /// The accessible role cannot be changed once set.
    ///
    /// Readable | Writeable
    /// </details>
    ///
    /// ## Signals
    ///
    ///
    /// #### `activate-current-link`
    ///  Gets emitted when the user activates a link in the label.
    ///
    /// The `::activate-current-link` is a [keybinding signal](class.SignalAction.html).
    ///
    /// Applications may also emit the signal with g_signal_emit_by_name()
    /// if they need to control activation of URIs programmatically.
    ///
    /// The default bindings for this signal are all forms of the <kbd>Enter</kbd> key.
    ///
    /// Action
    ///
    ///
    /// #### `activate-link`
    ///  Gets emitted to activate a URI.
    ///
    /// Applications may connect to it to override the default behaviour,
    /// which is to call [`FileLauncher::launch()`][crate::FileLauncher::launch()].
    ///
    ///
    ///
    ///
    /// #### `copy-clipboard`
    ///  Gets emitted to copy the selection to the clipboard.
    ///
    /// The `::copy-clipboard` signal is a [keybinding signal](class.SignalAction.html).
    ///
    /// The default binding for this signal is <kbd>Ctrl</kbd>+<kbd>c</kbd>.
    ///
    /// Action
    ///
    ///
    /// #### `move-cursor`
    ///  Gets emitted when the user initiates a cursor movement.
    ///
    /// The `::move-cursor` signal is a [keybinding signal](class.SignalAction.html).
    /// If the cursor is not visible in @entry, this signal causes the viewport to
    /// be moved instead.
    ///
    /// Applications should not connect to it, but may emit it with
    /// `signal_emit_by_name()` if they need to control
    /// the cursor programmatically.
    ///
    /// The default bindings for this signal come in two variants, the
    /// variant with the <kbd>Shift</kbd> modifier extends the selection,
    /// the variant without the <kbd>Shift</kbd> modifier does not.
    /// There are too many key combinations to list them all here.
    ///
    /// - <kbd>←</kbd>, <kbd>→</kbd>, <kbd>↑</kbd>, <kbd>↓</kbd>
    ///   move by individual characters/lines
    /// - <kbd>Ctrl</kbd>+<kbd>←</kbd>, etc. move by words/paragraphs
    /// - <kbd>Home</kbd> and <kbd>End</kbd> move to the ends of the buffer
    ///
    /// Action
    /// <details><summary><h4>Widget</h4></summary>
    ///
    ///
    /// #### `destroy`
    ///  Signals that all holders of a reference to the widget should release
    /// the reference that they hold.
    ///
    /// May result in finalization of the widget if all references are released.
    ///
    /// This signal is not suitable for saving widget state.
    ///
    ///
    ///
    ///
    /// #### `direction-changed`
    ///  Emitted when the text direction of a widget changes.
    ///
    ///
    ///
    ///
    /// #### `hide`
    ///  Emitted when @widget is hidden.
    ///
    ///
    ///
    ///
    /// #### `keynav-failed`
    ///  Emitted if keyboard navigation fails.
    ///
    /// See [`WidgetExt::keynav_failed()`][crate::prelude::WidgetExt::keynav_failed()] for details.
    ///
    ///
    ///
    ///
    /// #### `map`
    ///  Emitted when @widget is going to be mapped.
    ///
    /// A widget is mapped when the widget is visible (which is controlled with
    /// [`visible`][struct@crate::Widget#visible]) and all its parents up to the toplevel widget
    /// are also visible.
    ///
    /// The `::map` signal can be used to determine whether a widget will be drawn,
    /// for instance it can resume an animation that was stopped during the
    /// emission of [`unmap`][struct@crate::Widget#unmap].
    ///
    ///
    ///
    ///
    /// #### `mnemonic-activate`
    ///  Emitted when a widget is activated via a mnemonic.
    ///
    /// The default handler for this signal activates @widget if @group_cycling
    /// is false, or just makes @widget grab focus if @group_cycling is true.
    ///
    ///
    ///
    ///
    /// #### `move-focus`
    ///  Emitted when the focus is moved.
    ///
    /// The `::move-focus` signal is a [keybinding signal](class.SignalAction.html).
    ///
    /// The default bindings for this signal are <kbd>Tab</kbd> to move forward,
    /// and <kbd>Shift</kbd>+<kbd>Tab</kbd> to move backward.
    ///
    /// Action
    ///
    ///
    /// #### `query-tooltip`
    ///  Emitted when the widget’s tooltip is about to be shown.
    ///
    /// This happens when the [`has-tooltip`][struct@crate::Widget#has-tooltip] property
    /// is true and the hover timeout has expired with the cursor hovering
    /// above @widget; or emitted when @widget got focus in keyboard mode.
    ///
    /// Using the given coordinates, the signal handler should determine
    /// whether a tooltip should be shown for @widget. If this is the case
    /// true should be returned, false otherwise. Note that if @keyboard_mode
    /// is true, the values of @x and @y are undefined and should not be used.
    ///
    /// The signal handler is free to manipulate @tooltip with the therefore
    /// destined function calls.
    ///
    ///
    ///
    ///
    /// #### `realize`
    ///  Emitted when @widget is associated with a [`gdk::Surface`][crate::gdk::Surface].
    ///
    /// This means that [`WidgetExt::realize()`][crate::prelude::WidgetExt::realize()] has been called
    /// or the widget has been mapped (that is, it is going to be drawn).
    ///
    ///
    ///
    ///
    /// #### `show`
    ///  Emitted when @widget is shown.
    ///
    ///
    ///
    ///
    /// #### `state-flags-changed`
    ///  Emitted when the widget state changes.
    ///
    /// See [`WidgetExt::state_flags()`][crate::prelude::WidgetExt::state_flags()].
    ///
    ///
    ///
    ///
    /// #### `unmap`
    ///  Emitted when @widget is going to be unmapped.
    ///
    /// A widget is unmapped when either it or any of its parents up to the
    /// toplevel widget have been set as hidden.
    ///
    /// As `::unmap` indicates that a widget will not be shown any longer,
    /// it can be used to, for example, stop an animation on the widget.
    ///
    ///
    ///
    ///
    /// #### `unrealize`
    ///  Emitted when the [`gdk::Surface`][crate::gdk::Surface] associated with @widget is destroyed.
    ///
    /// This means that [`WidgetExt::unrealize()`][crate::prelude::WidgetExt::unrealize()] has been called
    /// or the widget has been unmapped (that is, it is going to be hidden).
    ///
    ///
    /// </details>
    ///
    /// # Implements
    ///
    /// [`WidgetExt`][trait@crate::prelude::WidgetExt], [`trait@glib::ObjectExt`], [`AccessibleExt`][trait@crate::prelude::AccessibleExt], [`BuildableExt`][trait@crate::prelude::BuildableExt], [`ConstraintTargetExt`][trait@crate::prelude::ConstraintTargetExt], [`AccessibleTextExt`][trait@crate::prelude::AccessibleTextExt], [`WidgetExtManual`][trait@crate::prelude::WidgetExtManual], [`AccessibleExtManual`][trait@crate::prelude::AccessibleExtManual]
    #[doc(alias = "GtkLabel")]
    pub struct Label(Object<ffi::GtkLabel>) @extends Widget, @implements Accessible, Buildable, ConstraintTarget, AccessibleText;

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

#[cfg(not(any(feature = "v4_14")))]
glib::wrapper! {
    #[doc(alias = "GtkLabel")]
    pub struct Label(Object<ffi::GtkLabel>) @extends Widget, @implements Accessible, Buildable, ConstraintTarget;

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

impl Label {
    /// Creates a new label with the given text inside it.
    ///
    /// You can pass `NULL` to get an empty label widget.
    /// ## `str`
    /// the text of the label
    ///
    /// # Returns
    ///
    /// the new label
    #[doc(alias = "gtk_label_new")]
    pub fn new(str: Option<&str>) -> Label {
        assert_initialized_main_thread!();
        unsafe { Widget::from_glib_none(ffi::gtk_label_new(str.to_glib_none().0)).unsafe_cast() }
    }

    /// Creates a new label with the given text inside it, and a mnemonic.
    ///
    /// If characters in @str are preceded by an underscore, they are
    /// underlined. If you need a literal underscore character in a label, use
    /// '__' (two underscores). The first underlined character represents a
    /// keyboard accelerator called a mnemonic. The mnemonic key can be used
    /// to activate another widget, chosen automatically, or explicitly using
    /// [`set_mnemonic_widget()`][Self::set_mnemonic_widget()].
    ///
    /// If [`set_mnemonic_widget()`][Self::set_mnemonic_widget()] is not called, then the first
    /// activatable ancestor of the label will be chosen as the mnemonic
    /// widget. For instance, if the label is inside a button or menu item,
    /// the button or menu item will automatically become the mnemonic widget
    /// and be activated by the mnemonic.
    /// ## `str`
    /// the text of the label, with an underscore in front of the
    ///   mnemonic character
    ///
    /// # Returns
    ///
    /// the new label
    #[doc(alias = "gtk_label_new_with_mnemonic")]
    #[doc(alias = "new_with_mnemonic")]
    pub fn with_mnemonic(str: &str) -> Label {
        assert_initialized_main_thread!();
        unsafe {
            Widget::from_glib_none(ffi::gtk_label_new_with_mnemonic(str.to_glib_none().0))
                .unsafe_cast()
        }
    }

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

    /// Gets the label's attribute list.
    ///
    /// This is the [`pango::AttrList`][crate::pango::AttrList] that was set on the label using
    /// [`set_attributes()`][Self::set_attributes()], if any. This function does not
    /// reflect attributes that come from the label's markup (see
    /// [`set_markup()`][Self::set_markup()]). If you want to get the effective
    /// attributes for the label, use
    /// `pango_layout_get_attributes (gtk_label_get_layout (self))`.
    ///
    /// # Returns
    ///
    /// the attribute list
    #[doc(alias = "gtk_label_get_attributes")]
    #[doc(alias = "get_attributes")]
    pub fn attributes(&self) -> Option<pango::AttrList> {
        unsafe { from_glib_none(ffi::gtk_label_get_attributes(self.to_glib_none().0)) }
    }

    /// Returns the URI for the active link in the label.
    ///
    /// The active link is the one under the mouse pointer or, in a
    /// selectable label, the link in which the text cursor is currently
    /// positioned.
    ///
    /// This function is intended for use in a [`activate-link`][struct@crate::Label#activate-link]
    /// handler or for use in a [`query-tooltip`][struct@crate::Widget#query-tooltip] handler.
    ///
    /// # Returns
    ///
    /// the active URI
    #[doc(alias = "gtk_label_get_current_uri")]
    #[doc(alias = "get_current_uri")]
    pub fn current_uri(&self) -> Option<glib::GString> {
        unsafe { from_glib_none(ffi::gtk_label_get_current_uri(self.to_glib_none().0)) }
    }

    /// Returns the ellipsization mode of the label.
    ///
    /// See [`set_ellipsize()`][Self::set_ellipsize()].
    ///
    /// # Returns
    ///
    /// the ellipsization mode
    #[doc(alias = "gtk_label_get_ellipsize")]
    #[doc(alias = "get_ellipsize")]
    pub fn ellipsize(&self) -> pango::EllipsizeMode {
        unsafe { from_glib(ffi::gtk_label_get_ellipsize(self.to_glib_none().0)) }
    }

    /// Gets the extra menu model of the label.
    ///
    /// See [`set_extra_menu()`][Self::set_extra_menu()].
    ///
    /// # Returns
    ///
    /// the menu model
    #[doc(alias = "gtk_label_get_extra_menu")]
    #[doc(alias = "get_extra_menu")]
    #[doc(alias = "extra-menu")]
    pub fn extra_menu(&self) -> Option<gio::MenuModel> {
        unsafe { from_glib_none(ffi::gtk_label_get_extra_menu(self.to_glib_none().0)) }
    }

    /// Returns the justification of the label.
    ///
    /// See [`set_justify()`][Self::set_justify()].
    ///
    /// # Returns
    ///
    /// the justification value
    #[doc(alias = "gtk_label_get_justify")]
    #[doc(alias = "get_justify")]
    pub fn justify(&self) -> Justification {
        unsafe { from_glib(ffi::gtk_label_get_justify(self.to_glib_none().0)) }
    }

    /// Fetches the text from a label.
    ///
    /// The returned text includes any embedded underlines indicating
    /// mnemonics and Pango markup. (See [`text()`][Self::text()]).
    ///
    /// # Returns
    ///
    /// the text of the label widget
    #[doc(alias = "gtk_label_get_label")]
    #[doc(alias = "get_label")]
    pub fn label(&self) -> glib::GString {
        unsafe { from_glib_none(ffi::gtk_label_get_label(self.to_glib_none().0)) }
    }

    /// Gets the Pango layout used to display the label.
    ///
    /// The layout is useful to e.g. convert text positions to pixel
    /// positions, in combination with [`layout_offsets()`][Self::layout_offsets()].
    /// The returned layout is owned by the @label so need not be
    /// freed by the caller. The @label is free to recreate its layout
    /// at any time, so it should be considered read-only.
    ///
    /// # Returns
    ///
    /// the [`pango::Layout`][crate::pango::Layout] for this label
    #[doc(alias = "gtk_label_get_layout")]
    #[doc(alias = "get_layout")]
    pub fn layout(&self) -> pango::Layout {
        unsafe { from_glib_none(ffi::gtk_label_get_layout(self.to_glib_none().0)) }
    }

    /// Obtains the coordinates where the label will draw its Pango layout.
    ///
    /// The coordinates are useful to convert mouse events into coordinates
    /// inside the [`pango::Layout`][crate::pango::Layout], e.g. to take some action if some part
    /// of the label is clicked. Remember when using the [`pango::Layout`][crate::pango::Layout]
    /// functions you need to convert to and from pixels using `PANGO_PIXELS()`
    /// or `Pango::SCALE`.
    ///
    /// # Returns
    ///
    ///
    /// ## `x`
    /// location to store X offset of layout
    ///
    /// ## `y`
    /// location to store Y offset of layout
    #[doc(alias = "gtk_label_get_layout_offsets")]
    #[doc(alias = "get_layout_offsets")]
    pub fn layout_offsets(&self) -> (i32, i32) {
        unsafe {
            let mut x = std::mem::MaybeUninit::uninit();
            let mut y = std::mem::MaybeUninit::uninit();
            ffi::gtk_label_get_layout_offsets(
                self.to_glib_none().0,
                x.as_mut_ptr(),
                y.as_mut_ptr(),
            );
            (x.assume_init(), y.assume_init())
        }
    }

    /// Gets the number of lines to which an ellipsized, wrapping
    /// label should be limited.
    ///
    /// See [`set_lines()`][Self::set_lines()].
    ///
    /// # Returns
    ///
    /// the number of lines
    #[doc(alias = "gtk_label_get_lines")]
    #[doc(alias = "get_lines")]
    pub fn lines(&self) -> i32 {
        unsafe { ffi::gtk_label_get_lines(self.to_glib_none().0) }
    }

    /// Retrieves the maximum width of the label in characters.
    ///
    /// See [`set_width_chars()`][Self::set_width_chars()].
    ///
    /// # Returns
    ///
    /// the maximum width of the label, in characters
    #[doc(alias = "gtk_label_get_max_width_chars")]
    #[doc(alias = "get_max_width_chars")]
    #[doc(alias = "max-width-chars")]
    pub fn max_width_chars(&self) -> i32 {
        unsafe { ffi::gtk_label_get_max_width_chars(self.to_glib_none().0) }
    }

    /// Retrieves the mnemonic target of this label.
    ///
    /// See [`set_mnemonic_widget()`][Self::set_mnemonic_widget()].
    ///
    /// # Returns
    ///
    /// the target of the label’s mnemonic,
    ///   or `NULL` if none has been set and the default algorithm will be used.
    #[doc(alias = "gtk_label_get_mnemonic_widget")]
    #[doc(alias = "get_mnemonic_widget")]
    #[doc(alias = "mnemonic-widget")]
    pub fn mnemonic_widget(&self) -> Option<Widget> {
        unsafe { from_glib_none(ffi::gtk_label_get_mnemonic_widget(self.to_glib_none().0)) }
    }

    /// Returns natural line wrap mode used by the label.
    ///
    /// See [`set_natural_wrap_mode()`][Self::set_natural_wrap_mode()].
    ///
    /// # Returns
    ///
    /// the natural line wrap mode
    #[cfg(feature = "v4_6")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v4_6")))]
    #[doc(alias = "gtk_label_get_natural_wrap_mode")]
    #[doc(alias = "get_natural_wrap_mode")]
    #[doc(alias = "natural-wrap-mode")]
    pub fn natural_wrap_mode(&self) -> NaturalWrapMode {
        unsafe { from_glib(ffi::gtk_label_get_natural_wrap_mode(self.to_glib_none().0)) }
    }

    /// Returns whether the label is selectable.
    ///
    /// # Returns
    ///
    /// true if the user can copy text from the label
    #[doc(alias = "gtk_label_get_selectable")]
    #[doc(alias = "get_selectable")]
    #[doc(alias = "selectable")]
    pub fn is_selectable(&self) -> bool {
        unsafe { from_glib(ffi::gtk_label_get_selectable(self.to_glib_none().0)) }
    }

    /// Gets the selected range of characters in the label.
    ///
    /// The returned @start and @end positions are in characters.
    ///
    /// # Returns
    ///
    /// true if selection is non-empty
    ///
    /// ## `start`
    /// return location for start of selection
    ///
    /// ## `end`
    /// return location for end of selection
    #[doc(alias = "gtk_label_get_selection_bounds")]
    #[doc(alias = "get_selection_bounds")]
    pub fn selection_bounds(&self) -> Option<(i32, i32)> {
        unsafe {
            let mut start = std::mem::MaybeUninit::uninit();
            let mut end = std::mem::MaybeUninit::uninit();
            let ret = from_glib(ffi::gtk_label_get_selection_bounds(
                self.to_glib_none().0,
                start.as_mut_ptr(),
                end.as_mut_ptr(),
            ));
            if ret {
                Some((start.assume_init(), end.assume_init()))
            } else {
                None
            }
        }
    }

    /// Returns whether the label is in single line mode.
    ///
    /// # Returns
    ///
    /// true if the label is in single line mode
    #[doc(alias = "gtk_label_get_single_line_mode")]
    #[doc(alias = "get_single_line_mode")]
    #[doc(alias = "single-line-mode")]
    pub fn is_single_line_mode(&self) -> bool {
        unsafe { from_glib(ffi::gtk_label_get_single_line_mode(self.to_glib_none().0)) }
    }

    /// Gets the tab stops for the label.
    ///
    /// The returned array will be `NULL` if “standard” (8-space) tabs are used.
    ///
    /// # Returns
    ///
    /// copy of default tab array,
    ///   or `NULL` if standard tabs are used
    #[cfg(feature = "v4_8")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v4_8")))]
    #[doc(alias = "gtk_label_get_tabs")]
    #[doc(alias = "get_tabs")]
    pub fn tabs(&self) -> Option<pango::TabArray> {
        unsafe { from_glib_full(ffi::gtk_label_get_tabs(self.to_glib_none().0)) }
    }

    /// Gets the text of the label.
    ///
    /// The returned text is as it appears on screen. This does not include
    /// any embedded underlines indicating mnemonics or Pango markup. (See
    /// [`label()`][Self::label()])
    ///
    /// # Returns
    ///
    /// the text in the label widget
    #[doc(alias = "gtk_label_get_text")]
    #[doc(alias = "get_text")]
    pub fn text(&self) -> glib::GString {
        unsafe { from_glib_none(ffi::gtk_label_get_text(self.to_glib_none().0)) }
    }

    /// Returns whether the label’s text is interpreted as Pango markup.
    ///
    /// See [`set_use_markup()`][Self::set_use_markup()].
    ///
    /// # Returns
    ///
    /// true if the label’s text will be parsed for markup
    #[doc(alias = "gtk_label_get_use_markup")]
    #[doc(alias = "get_use_markup")]
    #[doc(alias = "use-markup")]
    pub fn uses_markup(&self) -> bool {
        unsafe { from_glib(ffi::gtk_label_get_use_markup(self.to_glib_none().0)) }
    }

    /// Returns whether underlines in the label indicate mnemonics.
    ///
    /// See [`set_use_underline()`][Self::set_use_underline()].
    ///
    /// # Returns
    ///
    /// true if underlines in the label indicate mnemonics
    #[doc(alias = "gtk_label_get_use_underline")]
    #[doc(alias = "get_use_underline")]
    #[doc(alias = "use-underline")]
    pub fn uses_underline(&self) -> bool {
        unsafe { from_glib(ffi::gtk_label_get_use_underline(self.to_glib_none().0)) }
    }

    /// Retrieves the desired width of the label in characters.
    ///
    /// See [`set_width_chars()`][Self::set_width_chars()].
    ///
    /// # Returns
    ///
    /// the desired width of the label, in characters
    #[doc(alias = "gtk_label_get_width_chars")]
    #[doc(alias = "get_width_chars")]
    #[doc(alias = "width-chars")]
    pub fn width_chars(&self) -> i32 {
        unsafe { ffi::gtk_label_get_width_chars(self.to_glib_none().0) }
    }

    /// Returns whether lines in the label are automatically wrapped.
    ///
    /// See [`set_wrap()`][Self::set_wrap()].
    ///
    /// # Returns
    ///
    /// true if the lines of the label are automatically wrapped
    #[doc(alias = "gtk_label_get_wrap")]
    #[doc(alias = "get_wrap")]
    #[doc(alias = "wrap")]
    pub fn wraps(&self) -> bool {
        unsafe { from_glib(ffi::gtk_label_get_wrap(self.to_glib_none().0)) }
    }

    /// Returns line wrap mode used by the label.
    ///
    /// See [`set_wrap_mode()`][Self::set_wrap_mode()].
    ///
    /// # Returns
    ///
    /// the line wrap mode
    #[doc(alias = "gtk_label_get_wrap_mode")]
    #[doc(alias = "get_wrap_mode")]
    #[doc(alias = "wrap-mode")]
    pub fn wrap_mode(&self) -> pango::WrapMode {
        unsafe { from_glib(ffi::gtk_label_get_wrap_mode(self.to_glib_none().0)) }
    }

    /// Gets the `xalign` of the label.
    ///
    /// See the [`xalign`][struct@crate::Label#xalign] property.
    ///
    /// # Returns
    ///
    /// the xalign value
    #[doc(alias = "gtk_label_get_xalign")]
    #[doc(alias = "get_xalign")]
    pub fn xalign(&self) -> f32 {
        unsafe { ffi::gtk_label_get_xalign(self.to_glib_none().0) }
    }

    /// Gets the `yalign` of the label.
    ///
    /// See the [`yalign`][struct@crate::Label#yalign] property.
    ///
    /// # Returns
    ///
    /// the yalign value
    #[doc(alias = "gtk_label_get_yalign")]
    #[doc(alias = "get_yalign")]
    pub fn yalign(&self) -> f32 {
        unsafe { ffi::gtk_label_get_yalign(self.to_glib_none().0) }
    }

    /// Selects a range of characters in the label, if the label is selectable.
    ///
    /// See [`set_selectable()`][Self::set_selectable()]. If the label is not selectable,
    /// this function has no effect. If @start_offset or
    /// @end_offset are -1, then the end of the label will be substituted.
    /// ## `start_offset`
    /// start offset, in characters
    /// ## `end_offset`
    /// end offset, in characters
    #[doc(alias = "gtk_label_select_region")]
    pub fn select_region(&self, start_offset: i32, end_offset: i32) {
        unsafe {
            ffi::gtk_label_select_region(self.to_glib_none().0, start_offset, end_offset);
        }
    }

    /// Apply attributes to the label text.
    ///
    /// The attributes set with this function will be applied and merged with
    /// any other attributes previously effected by way of the
    /// [`use-underline`][struct@crate::Label#use-underline] or [`use-markup`][struct@crate::Label#use-markup]
    /// properties
    ///
    /// While it is not recommended to mix markup strings with manually set
    /// attributes, if you must; know that the attributes will be applied
    /// to the label after the markup string is parsed.
    /// ## `attrs`
    /// a list of style attributes
    #[doc(alias = "gtk_label_set_attributes")]
    #[doc(alias = "attributes")]
    pub fn set_attributes(&self, attrs: Option<&pango::AttrList>) {
        unsafe {
            ffi::gtk_label_set_attributes(self.to_glib_none().0, attrs.to_glib_none().0);
        }
    }

    /// Sets the mode used to ellipsize the text.
    ///
    /// The text will be ellipsized if there is not
    /// enough space to render the entire string.
    /// ## `mode`
    /// the ellipsization mode
    #[doc(alias = "gtk_label_set_ellipsize")]
    #[doc(alias = "ellipsize")]
    pub fn set_ellipsize(&self, mode: pango::EllipsizeMode) {
        unsafe {
            ffi::gtk_label_set_ellipsize(self.to_glib_none().0, mode.into_glib());
        }
    }

    /// Sets a menu model to add to the context menu of the label.
    /// ## `model`
    /// a menu model
    #[doc(alias = "gtk_label_set_extra_menu")]
    #[doc(alias = "extra-menu")]
    pub fn set_extra_menu(&self, model: Option<&impl IsA<gio::MenuModel>>) {
        unsafe {
            ffi::gtk_label_set_extra_menu(
                self.to_glib_none().0,
                model.map(|p| p.as_ref()).to_glib_none().0,
            );
        }
    }

    /// Sets the alignment of lines in the label relative to each other.
    ///
    /// This function has no effect on labels containing only a single line.
    ///
    /// [enum@Gtk.Justification.left] is the default value when the widget
    /// is first created with [`new()`][Self::new()].
    ///
    /// If you instead want to set the alignment of the label as a whole,
    /// use [`WidgetExt::set_halign()`][crate::prelude::WidgetExt::set_halign()] instead.
    /// ## `jtype`
    /// the new justification
    #[doc(alias = "gtk_label_set_justify")]
    #[doc(alias = "justify")]
    pub fn set_justify(&self, jtype: Justification) {
        unsafe {
            ffi::gtk_label_set_justify(self.to_glib_none().0, jtype.into_glib());
        }
    }

    /// Sets the text of the label.
    ///
    /// The label is interpreted as including embedded underlines and/or Pango
    /// markup depending on the values of the [`use-underline`][struct@crate::Label#use-underline]
    /// and [`use-markup`][struct@crate::Label#use-markup] properties.
    /// ## `str`
    /// the new text to set for the label
    #[doc(alias = "gtk_label_set_label")]
    #[doc(alias = "label")]
    pub fn set_label(&self, str: &str) {
        unsafe {
            ffi::gtk_label_set_label(self.to_glib_none().0, str.to_glib_none().0);
        }
    }

    /// Sets the number of lines to which an ellipsized, wrapping label
    /// should be limited.
    ///
    /// This has no effect if the label is not wrapping or ellipsized.
    /// Set this to -1 if you don’t want to limit the number of lines.
    /// ## `lines`
    /// the desired number of lines, or -1
    #[doc(alias = "gtk_label_set_lines")]
    #[doc(alias = "lines")]
    pub fn set_lines(&self, lines: i32) {
        unsafe {
            ffi::gtk_label_set_lines(self.to_glib_none().0, lines);
        }
    }

    /// Sets the labels text and attributes from markup.
    ///
    /// The string must be marked up with Pango markup
    /// (see `parse_markup()`).
    ///
    /// If @str is external data, you may need to escape it
    /// with `markup_escape_text()` or `markup_printf_escaped()`:
    ///
    /// **⚠️ The following code is in c ⚠️**
    ///
    /// ```c
    /// GtkWidget *self = gtk_label_new (NULL);
    /// const char *str = "...";
    /// const char *format = "<span style=\"italic\">\%s</span>";
    /// char *markup;
    ///
    /// markup = g_markup_printf_escaped (format, str);
    /// gtk_label_set_markup (GTK_LABEL (self), markup);
    /// g_free (markup);
    /// ```
    ///
    /// This function sets the [`use-markup`][struct@crate::Label#use-markup] property
    /// to true.
    ///
    /// Also see [`set_text()`][Self::set_text()].
    /// ## `str`
    /// the markup string
    #[doc(alias = "gtk_label_set_markup")]
    pub fn set_markup(&self, str: &str) {
        unsafe {
            ffi::gtk_label_set_markup(self.to_glib_none().0, str.to_glib_none().0);
        }
    }

    /// Sets the labels text, attributes and mnemonic from markup.
    ///
    /// Parses @str which is marked up with Pango markup (see `parse_markup()`),
    /// setting the label’s text and attribute list based on the parse results.
    /// If characters in @str are preceded by an underscore, they are underlined
    /// indicating that they represent a keyboard accelerator called a mnemonic.
    ///
    /// The mnemonic key can be used to activate another widget, chosen
    /// automatically, or explicitly using [`set_mnemonic_widget()`][Self::set_mnemonic_widget()].
    /// ## `str`
    /// the markup string
    #[doc(alias = "gtk_label_set_markup_with_mnemonic")]
    pub fn set_markup_with_mnemonic(&self, str: &str) {
        unsafe {
            ffi::gtk_label_set_markup_with_mnemonic(self.to_glib_none().0, str.to_glib_none().0);
        }
    }

    /// Sets the maximum width of the label in characters.
    /// ## `n_chars`
    /// the new maximum width, in characters.
    #[doc(alias = "gtk_label_set_max_width_chars")]
    #[doc(alias = "max-width-chars")]
    pub fn set_max_width_chars(&self, n_chars: i32) {
        unsafe {
            ffi::gtk_label_set_max_width_chars(self.to_glib_none().0, n_chars);
        }
    }

    /// Associate the label with its mnemonic target.
    ///
    /// If the label has been set so that it has a mnemonic key (using
    /// i.e. [`set_markup_with_mnemonic()`][Self::set_markup_with_mnemonic()],
    /// [`set_text_with_mnemonic()`][Self::set_text_with_mnemonic()],
    /// [`with_mnemonic()`][Self::with_mnemonic()]
    /// or the [`use_underline`][struct@crate::Label#use_underline] property) the label can
    /// be associated with a widget that is the target of the mnemonic.
    /// When the label is inside a widget (like a [`Button`][crate::Button] or a
    /// [`Notebook`][crate::Notebook] tab) it is automatically associated with the
    /// correct widget, but sometimes (i.e. when the target is a [`Entry`][crate::Entry]
    /// next to the label) you need to set it explicitly using this function.
    ///
    /// The target widget will be accelerated by emitting the
    /// [`mnemonic-activate`][struct@crate::Widget#mnemonic-activate] signal on it. The default handler
    /// for this signal will activate the widget if there are no mnemonic
    /// collisions and toggle focus between the colliding widgets otherwise.
    /// ## `widget`
    /// the target widget
    #[doc(alias = "gtk_label_set_mnemonic_widget")]
    #[doc(alias = "mnemonic-widget")]
    pub fn set_mnemonic_widget(&self, widget: Option<&impl IsA<Widget>>) {
        unsafe {
            ffi::gtk_label_set_mnemonic_widget(
                self.to_glib_none().0,
                widget.map(|p| p.as_ref()).to_glib_none().0,
            );
        }
    }

    /// Selects the line wrapping for the natural size request.
    ///
    /// This only affects the natural size requested, for the actual wrapping used,
    /// see the [`wrap-mode`][struct@crate::Label#wrap-mode] property.
    /// ## `wrap_mode`
    /// the line wrapping mode
    #[cfg(feature = "v4_6")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v4_6")))]
    #[doc(alias = "gtk_label_set_natural_wrap_mode")]
    #[doc(alias = "natural-wrap-mode")]
    pub fn set_natural_wrap_mode(&self, wrap_mode: NaturalWrapMode) {
        unsafe {
            ffi::gtk_label_set_natural_wrap_mode(self.to_glib_none().0, wrap_mode.into_glib());
        }
    }

    /// Makes text in the label selectable.
    ///
    /// Selectable labels allow the user to select text from the label,
    /// for copy-and-paste.
    /// ## `setting`
    /// true to allow selecting text in the label
    #[doc(alias = "gtk_label_set_selectable")]
    #[doc(alias = "selectable")]
    pub fn set_selectable(&self, setting: bool) {
        unsafe {
            ffi::gtk_label_set_selectable(self.to_glib_none().0, setting.into_glib());
        }
    }

    /// Sets whether the label is in single line mode.
    /// ## `single_line_mode`
    /// true to enable single line mode
    #[doc(alias = "gtk_label_set_single_line_mode")]
    #[doc(alias = "single-line-mode")]
    pub fn set_single_line_mode(&self, single_line_mode: bool) {
        unsafe {
            ffi::gtk_label_set_single_line_mode(
                self.to_glib_none().0,
                single_line_mode.into_glib(),
            );
        }
    }

    /// Sets tab stops for the label.
    /// ## `tabs`
    /// tab stops
    #[cfg(feature = "v4_8")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v4_8")))]
    #[doc(alias = "gtk_label_set_tabs")]
    #[doc(alias = "tabs")]
    pub fn set_tabs(&self, tabs: Option<&pango::TabArray>) {
        unsafe {
            ffi::gtk_label_set_tabs(self.to_glib_none().0, mut_override(tabs.to_glib_none().0));
        }
    }

    /// Sets the text for the label.
    ///
    /// It overwrites any text that was there before and clears any
    /// previously set mnemonic accelerators, and sets the
    /// [`use-underline`][struct@crate::Label#use-underline] and
    /// [`use-markup`][struct@crate::Label#use-markup] properties to false.
    ///
    /// Also see [`set_markup()`][Self::set_markup()].
    /// ## `str`
    /// the text to show in @self
    #[doc(alias = "gtk_label_set_text")]
    pub fn set_text(&self, str: &str) {
        unsafe {
            ffi::gtk_label_set_text(self.to_glib_none().0, str.to_glib_none().0);
        }
    }

    /// Sets the text for the label, with mnemonics.
    ///
    /// If characters in @str are preceded by an underscore, they are underlined
    /// indicating that they represent a keyboard accelerator called a mnemonic.
    /// The mnemonic key can be used to activate another widget, chosen
    /// automatically, or explicitly using [`set_mnemonic_widget()`][Self::set_mnemonic_widget()].
    /// ## `str`
    /// the text
    #[doc(alias = "gtk_label_set_text_with_mnemonic")]
    pub fn set_text_with_mnemonic(&self, str: &str) {
        unsafe {
            ffi::gtk_label_set_text_with_mnemonic(self.to_glib_none().0, str.to_glib_none().0);
        }
    }

    /// Sets whether the text of the label contains markup.
    ///
    /// See [`set_markup()`][Self::set_markup()].
    /// ## `setting`
    /// true if the label’s text should be parsed for markup.
    #[doc(alias = "gtk_label_set_use_markup")]
    #[doc(alias = "use-markup")]
    pub fn set_use_markup(&self, setting: bool) {
        unsafe {
            ffi::gtk_label_set_use_markup(self.to_glib_none().0, setting.into_glib());
        }
    }

    /// Sets whether underlines in the text indicate mnemonics.
    /// ## `setting`
    /// true if underlines in the text indicate mnemonics
    #[doc(alias = "gtk_label_set_use_underline")]
    #[doc(alias = "use-underline")]
    pub fn set_use_underline(&self, setting: bool) {
        unsafe {
            ffi::gtk_label_set_use_underline(self.to_glib_none().0, setting.into_glib());
        }
    }

    /// Sets the desired width in characters of the label.
    /// ## `n_chars`
    /// the new desired width, in characters.
    #[doc(alias = "gtk_label_set_width_chars")]
    #[doc(alias = "width-chars")]
    pub fn set_width_chars(&self, n_chars: i32) {
        unsafe {
            ffi::gtk_label_set_width_chars(self.to_glib_none().0, n_chars);
        }
    }

    /// Toggles line wrapping within the label.
    ///
    /// True makes it break lines if text exceeds the widget’s size.
    /// false lets the text get cut off by the edge of the widget if
    /// it exceeds the widget size.
    ///
    /// Note that setting line wrapping to true does not make the label
    /// wrap at its parent widget’s width, because GTK widgets conceptually
    /// can’t make their requisition depend on the parent  widget’s size.
    /// For a label that wraps at a specific position, set the label’s width
    /// using [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()].
    /// ## `wrap`
    /// whether to wrap lines
    #[doc(alias = "gtk_label_set_wrap")]
    #[doc(alias = "wrap")]
    pub fn set_wrap(&self, wrap: bool) {
        unsafe {
            ffi::gtk_label_set_wrap(self.to_glib_none().0, wrap.into_glib());
        }
    }

    /// Controls how line wrapping is done.
    ///
    /// This only affects the label if line wrapping is on. (See
    /// [`set_wrap()`][Self::set_wrap()])
    ///
    /// The default is [enum@Pango.WrapMode.word], which means
    /// wrap on word boundaries.
    ///
    /// For sizing behavior, also consider the
    /// [`natural-wrap-mode`][struct@crate::Label#natural-wrap-mode] property.
    /// ## `wrap_mode`
    /// the line wrapping mode
    #[doc(alias = "gtk_label_set_wrap_mode")]
    #[doc(alias = "wrap-mode")]
    pub fn set_wrap_mode(&self, wrap_mode: pango::WrapMode) {
        unsafe {
            ffi::gtk_label_set_wrap_mode(self.to_glib_none().0, wrap_mode.into_glib());
        }
    }

    /// Sets the `xalign` of the label.
    ///
    /// See the [`xalign`][struct@crate::Label#xalign] property.
    /// ## `xalign`
    /// the new xalign value, between 0 and 1
    #[doc(alias = "gtk_label_set_xalign")]
    #[doc(alias = "xalign")]
    pub fn set_xalign(&self, xalign: f32) {
        unsafe {
            ffi::gtk_label_set_xalign(self.to_glib_none().0, xalign);
        }
    }

    /// Sets the `yalign` of the label.
    ///
    /// See the [`yalign`][struct@crate::Label#yalign] property.
    /// ## `yalign`
    /// the new yalign value, between 0 and 1
    #[doc(alias = "gtk_label_set_yalign")]
    #[doc(alias = "yalign")]
    pub fn set_yalign(&self, yalign: f32) {
        unsafe {
            ffi::gtk_label_set_yalign(self.to_glib_none().0, yalign);
        }
    }

    /// Gets emitted when the user activates a link in the label.
    ///
    /// The `::activate-current-link` is a [keybinding signal](class.SignalAction.html).
    ///
    /// Applications may also emit the signal with g_signal_emit_by_name()
    /// if they need to control activation of URIs programmatically.
    ///
    /// The default bindings for this signal are all forms of the <kbd>Enter</kbd> key.
    #[doc(alias = "activate-current-link")]
    pub fn connect_activate_current_link<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn activate_current_link_trampoline<F: Fn(&Label) + 'static>(
            this: *mut ffi::GtkLabel,
            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"activate-current-link\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    activate_current_link_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    pub fn emit_activate_current_link(&self) {
        self.emit_by_name::<()>("activate-current-link", &[]);
    }

    /// Gets emitted to activate a URI.
    ///
    /// Applications may connect to it to override the default behaviour,
    /// which is to call [`FileLauncher::launch()`][crate::FileLauncher::launch()].
    /// ## `uri`
    /// the URI that is activated
    ///
    /// # Returns
    ///
    /// true if the link has been activated
    #[doc(alias = "activate-link")]
    pub fn connect_activate_link<F: Fn(&Self, &str) -> glib::Propagation + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn activate_link_trampoline<
            F: Fn(&Label, &str) -> glib::Propagation + 'static,
        >(
            this: *mut ffi::GtkLabel,
            uri: *mut std::ffi::c_char,
            f: glib::ffi::gpointer,
        ) -> glib::ffi::gboolean {
            let f: &F = &*(f as *const F);
            f(
                &from_glib_borrow(this),
                &glib::GString::from_glib_borrow(uri),
            )
            .into_glib()
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"activate-link\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    activate_link_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    /// Gets emitted to copy the selection to the clipboard.
    ///
    /// The `::copy-clipboard` signal is a [keybinding signal](class.SignalAction.html).
    ///
    /// The default binding for this signal is <kbd>Ctrl</kbd>+<kbd>c</kbd>.
    #[doc(alias = "copy-clipboard")]
    pub fn connect_copy_clipboard<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn copy_clipboard_trampoline<F: Fn(&Label) + 'static>(
            this: *mut ffi::GtkLabel,
            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"copy-clipboard\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    copy_clipboard_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    pub fn emit_copy_clipboard(&self) {
        self.emit_by_name::<()>("copy-clipboard", &[]);
    }

    /// Gets emitted when the user initiates a cursor movement.
    ///
    /// The `::move-cursor` signal is a [keybinding signal](class.SignalAction.html).
    /// If the cursor is not visible in @entry, this signal causes the viewport to
    /// be moved instead.
    ///
    /// Applications should not connect to it, but may emit it with
    /// `signal_emit_by_name()` if they need to control
    /// the cursor programmatically.
    ///
    /// The default bindings for this signal come in two variants, the
    /// variant with the <kbd>Shift</kbd> modifier extends the selection,
    /// the variant without the <kbd>Shift</kbd> modifier does not.
    /// There are too many key combinations to list them all here.
    ///
    /// - <kbd>←</kbd>, <kbd>→</kbd>, <kbd>↑</kbd>, <kbd>↓</kbd>
    ///   move by individual characters/lines
    /// - <kbd>Ctrl</kbd>+<kbd>←</kbd>, etc. move by words/paragraphs
    /// - <kbd>Home</kbd> and <kbd>End</kbd> move to the ends of the buffer
    /// ## `step`
    /// the granularity of the move, as a [`MovementStep`][crate::MovementStep]
    /// ## `count`
    /// the number of @step units to move
    /// ## `extend_selection`
    /// true if the move should extend the selection
    #[doc(alias = "move-cursor")]
    pub fn connect_move_cursor<F: Fn(&Self, MovementStep, i32, bool) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn move_cursor_trampoline<
            F: Fn(&Label, MovementStep, i32, bool) + 'static,
        >(
            this: *mut ffi::GtkLabel,
            step: ffi::GtkMovementStep,
            count: std::ffi::c_int,
            extend_selection: glib::ffi::gboolean,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(
                &from_glib_borrow(this),
                from_glib(step),
                count,
                from_glib(extend_selection),
            )
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"move-cursor\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    move_cursor_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    pub fn emit_move_cursor(&self, step: MovementStep, count: i32, extend_selection: bool) {
        self.emit_by_name::<()>("move-cursor", &[&step, &count, &extend_selection]);
    }

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

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

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

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

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

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

    #[doc(alias = "max-width-chars")]
    pub fn connect_max_width_chars_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_max_width_chars_trampoline<F: Fn(&Label) + 'static>(
            this: *mut ffi::GtkLabel,
            _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::max-width-chars\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_max_width_chars_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

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

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

    #[cfg(feature = "v4_6")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v4_6")))]
    #[doc(alias = "natural-wrap-mode")]
    pub fn connect_natural_wrap_mode_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn notify_natural_wrap_mode_trampoline<F: Fn(&Label) + 'static>(
            this: *mut ffi::GtkLabel,
            _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::natural-wrap-mode\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_natural_wrap_mode_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

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

    #[doc(alias = "single-line-mode")]
    pub fn connect_single_line_mode_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_single_line_mode_trampoline<F: Fn(&Label) + 'static>(
            this: *mut ffi::GtkLabel,
            _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::single-line-mode\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_single_line_mode_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    #[cfg(feature = "v4_8")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v4_8")))]
    #[doc(alias = "tabs")]
    pub fn connect_tabs_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn notify_tabs_trampoline<F: Fn(&Label) + 'static>(
            this: *mut ffi::GtkLabel,
            _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::tabs\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    notify_tabs_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

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

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

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

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

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

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

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

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

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

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

    /// A list of style attributes to apply to the text of the label.
    pub fn attributes(self, attributes: &pango::AttrList) -> Self {
        Self {
            builder: self.builder.property("attributes", attributes.clone()),
        }
    }

    /// The preferred place to ellipsize the string, if the label does
    /// not have enough room to display the entire string.
    ///
    /// Note that setting this property to a value other than
    /// [enum.Pango.EllipsizeMode.none] has the side-effect that the label requests
    /// only enough space to display the ellipsis "...". In particular, this
    /// means that ellipsizing labels do not work well in notebook tabs, unless
    /// the [`tab-expand`][struct@crate::NotebookPage#tab-expand] child property is set to true.
    ///
    /// Other ways to set a label's width are [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()]
    /// and [`Label::set_width_chars()`][crate::Label::set_width_chars()].
    pub fn ellipsize(self, ellipsize: pango::EllipsizeMode) -> Self {
        Self {
            builder: self.builder.property("ellipsize", ellipsize),
        }
    }

    /// A menu model whose contents will be appended to the context menu.
    pub fn extra_menu(self, extra_menu: &impl IsA<gio::MenuModel>) -> Self {
        Self {
            builder: self
                .builder
                .property("extra-menu", extra_menu.clone().upcast()),
        }
    }

    /// The alignment of the lines in the text of the label, relative to each other.
    ///
    /// This does *not* affect the alignment of the label within its allocation.
    /// See [`xalign`][struct@crate::Label#xalign] for that.
    pub fn justify(self, justify: Justification) -> Self {
        Self {
            builder: self.builder.property("justify", justify),
        }
    }

    /// The contents of the label.
    ///
    /// If the string contains Pango markup (see `parse_markup()`),
    /// you will have to set the [`use-markup`][struct@crate::Label#use-markup] property to
    /// true in order for the label to display the markup attributes. See also
    /// [`Label::set_markup()`][crate::Label::set_markup()] for a convenience function that sets both
    /// this property and the [`use-markup`][struct@crate::Label#use-markup] property at the
    /// same time.
    ///
    /// If the string contains underlines acting as mnemonics, you will have to
    /// set the [`use-underline`][struct@crate::Label#use-underline] property to true in order
    /// for the label to display them.
    pub fn label(self, label: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("label", label.into()),
        }
    }

    /// The number of lines to which an ellipsized, wrapping label
    /// should be limited.
    ///
    /// This property has no effect if the label is not wrapping or ellipsized.
    ///
    /// Set this property to -1 if you don't want to limit the number of lines.
    pub fn lines(self, lines: i32) -> Self {
        Self {
            builder: self.builder.property("lines", lines),
        }
    }

    /// The desired maximum width of the label, in characters.
    ///
    /// If this property is set to -1, the width will be calculated automatically.
    ///
    /// See the section on [text layout](class.Label.html#text-layout) for details
    /// of how [`width-chars`][struct@crate::Label#width-chars] and [`max-width-chars`][struct@crate::Label#max-width-chars]
    /// determine the width of ellipsized and wrapped labels.
    pub fn max_width_chars(self, max_width_chars: i32) -> Self {
        Self {
            builder: self.builder.property("max-width-chars", max_width_chars),
        }
    }

    /// The widget to be activated when the labels mnemonic key is pressed.
    pub fn mnemonic_widget(self, mnemonic_widget: &impl IsA<Widget>) -> Self {
        Self {
            builder: self
                .builder
                .property("mnemonic-widget", mnemonic_widget.clone().upcast()),
        }
    }

    /// Select the line wrapping for the natural size request.
    ///
    /// This only affects the natural size requested. For the actual wrapping
    /// used, see the [`wrap-mode`][struct@crate::Label#wrap-mode] property.
    ///
    /// The default is [enum@Gtk.NaturalWrapMode.inherit], which inherits
    /// the behavior of the [`wrap-mode`][struct@crate::Label#wrap-mode] property.
    #[cfg(feature = "v4_6")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v4_6")))]
    pub fn natural_wrap_mode(self, natural_wrap_mode: NaturalWrapMode) -> Self {
        Self {
            builder: self
                .builder
                .property("natural-wrap-mode", natural_wrap_mode),
        }
    }

    /// Whether the label text can be selected with the mouse.
    pub fn selectable(self, selectable: bool) -> Self {
        Self {
            builder: self.builder.property("selectable", selectable),
        }
    }

    /// Whether the label is in single line mode.
    ///
    /// In single line mode, the height of the label does not depend on the
    /// actual text, it is always set to ascent + descent of the font. This
    /// can be an advantage in situations where resizing the label because
    /// of text changes would be distracting, e.g. in a statusbar.
    pub fn single_line_mode(self, single_line_mode: bool) -> Self {
        Self {
            builder: self.builder.property("single-line-mode", single_line_mode),
        }
    }

    /// Custom tabs for this label.
    #[cfg(feature = "v4_8")]
    #[cfg_attr(docsrs, doc(cfg(feature = "v4_8")))]
    pub fn tabs(self, tabs: &pango::TabArray) -> Self {
        Self {
            builder: self.builder.property("tabs", tabs),
        }
    }

    /// True if the text of the label includes Pango markup.
    ///
    /// See `parse_markup()`.
    pub fn use_markup(self, use_markup: bool) -> Self {
        Self {
            builder: self.builder.property("use-markup", use_markup),
        }
    }

    /// True if the text of the label indicates a mnemonic with an `_`
    /// before the mnemonic character.
    pub fn use_underline(self, use_underline: bool) -> Self {
        Self {
            builder: self.builder.property("use-underline", use_underline),
        }
    }

    /// The desired width of the label, in characters.
    ///
    /// If this property is set to -1, the width will be calculated automatically.
    ///
    /// See the section on [text layout](class.Label.html#text-layout) for details
    /// of how [`width-chars`][struct@crate::Label#width-chars] and [`max-width-chars`][struct@crate::Label#max-width-chars]
    /// determine the width of ellipsized and wrapped labels.
    pub fn width_chars(self, width_chars: i32) -> Self {
        Self {
            builder: self.builder.property("width-chars", width_chars),
        }
    }

    /// True if the label text will wrap if it gets too wide.
    pub fn wrap(self, wrap: bool) -> Self {
        Self {
            builder: self.builder.property("wrap", wrap),
        }
    }

    /// Controls how the line wrapping is done.
    ///
    /// This only affects the formatting if line wrapping is on (see the
    /// [`wrap`][struct@crate::Label#wrap] property). The default is [enum@Pango.WrapMode.word],
    /// which means wrap on word boundaries.
    ///
    /// For sizing behavior, also consider the [`natural-wrap-mode`][struct@crate::Label#natural-wrap-mode]
    /// property.
    pub fn wrap_mode(self, wrap_mode: pango::WrapMode) -> Self {
        Self {
            builder: self.builder.property("wrap-mode", wrap_mode),
        }
    }

    /// The horizontal alignment of the label text inside its size allocation.
    ///
    /// Compare this to [`halign`][struct@crate::Widget#halign], which determines how the
    /// labels size allocation is positioned in the space available for the label.
    pub fn xalign(self, xalign: f32) -> Self {
        Self {
            builder: self.builder.property("xalign", xalign),
        }
    }

    /// The vertical alignment of the label text inside its size allocation.
    ///
    /// Compare this to [`valign`][struct@crate::Widget#valign], which determines how the
    /// labels size allocation is positioned in the space available for the label.
    pub fn yalign(self, yalign: f32) -> Self {
        Self {
            builder: self.builder.property("yalign", yalign),
        }
    }

    /// Whether the widget or any of its descendents can accept
    /// the input focus.
    ///
    /// This property is meant to be set by widget implementations,
    /// typically in their instance init function.
    pub fn can_focus(self, can_focus: bool) -> Self {
        Self {
            builder: self.builder.property("can-focus", can_focus),
        }
    }

    /// Whether the widget can receive pointer events.
    pub fn can_target(self, can_target: bool) -> Self {
        Self {
            builder: self.builder.property("can-target", can_target),
        }
    }

    /// A list of css classes applied to this widget.
    pub fn css_classes(self, css_classes: impl Into<glib::StrV>) -> Self {
        Self {
            builder: self.builder.property("css-classes", css_classes.into()),
        }
    }

    /// The name of this widget in the CSS tree.
    ///
    /// This property is meant to be set by widget implementations,
    /// typically in their instance init function.
    pub fn css_name(self, css_name: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("css-name", css_name.into()),
        }
    }

    /// The cursor used by @widget.
    pub fn cursor(self, cursor: &gdk::Cursor) -> Self {
        Self {
            builder: self.builder.property("cursor", cursor.clone()),
        }
    }

    /// Whether the widget should grab focus when it is clicked with the mouse.
    ///
    /// This property is only relevant for widgets that can take focus.
    pub fn focus_on_click(self, focus_on_click: bool) -> Self {
        Self {
            builder: self.builder.property("focus-on-click", focus_on_click),
        }
    }

    /// Whether this widget itself will accept the input focus.
    pub fn focusable(self, focusable: bool) -> Self {
        Self {
            builder: self.builder.property("focusable", focusable),
        }
    }

    /// How to distribute horizontal space if widget gets extra space.
    pub fn halign(self, halign: Align) -> Self {
        Self {
            builder: self.builder.property("halign", halign),
        }
    }

    /// Enables or disables the emission of the [`query-tooltip`][struct@crate::Widget#query-tooltip]
    /// signal on @widget.
    ///
    /// A true value indicates that @widget can have a tooltip, in this case
    /// the widget will be queried using [`query-tooltip`][struct@crate::Widget#query-tooltip] to
    /// determine whether it will provide a tooltip or not.
    pub fn has_tooltip(self, has_tooltip: bool) -> Self {
        Self {
            builder: self.builder.property("has-tooltip", has_tooltip),
        }
    }

    /// Overrides for height request of the widget.
    ///
    /// If this is -1, the natural request will be used.
    pub fn height_request(self, height_request: i32) -> Self {
        Self {
            builder: self.builder.property("height-request", height_request),
        }
    }

    /// Whether to expand horizontally.
    pub fn hexpand(self, hexpand: bool) -> Self {
        Self {
            builder: self.builder.property("hexpand", hexpand),
        }
    }

    /// Whether to use the `hexpand` property.
    pub fn hexpand_set(self, hexpand_set: bool) -> Self {
        Self {
            builder: self.builder.property("hexpand-set", hexpand_set),
        }
    }

    /// The [`LayoutManager`][crate::LayoutManager] instance to use to compute
    /// the preferred size of the widget, and allocate its children.
    ///
    /// This property is meant to be set by widget implementations,
    /// typically in their instance init function.
    pub fn layout_manager(self, layout_manager: &impl IsA<LayoutManager>) -> Self {
        Self {
            builder: self
                .builder
                .property("layout-manager", layout_manager.clone().upcast()),
        }
    }

    /// Margin on bottom side of widget.
    ///
    /// This property adds margin outside of the widget's normal size
    /// request, the margin will be added in addition to the size from
    /// [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()] for example.
    pub fn margin_bottom(self, margin_bottom: i32) -> Self {
        Self {
            builder: self.builder.property("margin-bottom", margin_bottom),
        }
    }

    /// Margin on end of widget, horizontally.
    ///
    /// This property supports left-to-right and right-to-left text
    /// directions.
    ///
    /// This property adds margin outside of the widget's normal size
    /// request, the margin will be added in addition to the size from
    /// [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()] for example.
    pub fn margin_end(self, margin_end: i32) -> Self {
        Self {
            builder: self.builder.property("margin-end", margin_end),
        }
    }

    /// Margin on start of widget, horizontally.
    ///
    /// This property supports left-to-right and right-to-left text
    /// directions.
    ///
    /// This property adds margin outside of the widget's normal size
    /// request, the margin will be added in addition to the size from
    /// [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()] for example.
    pub fn margin_start(self, margin_start: i32) -> Self {
        Self {
            builder: self.builder.property("margin-start", margin_start),
        }
    }

    /// Margin on top side of widget.
    ///
    /// This property adds margin outside of the widget's normal size
    /// request, the margin will be added in addition to the size from
    /// [`WidgetExt::set_size_request()`][crate::prelude::WidgetExt::set_size_request()] for example.
    pub fn margin_top(self, margin_top: i32) -> Self {
        Self {
            builder: self.builder.property("margin-top", margin_top),
        }
    }

    /// The name of the widget.
    pub fn name(self, name: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("name", name.into()),
        }
    }

    /// The requested opacity of the widget.
    pub fn opacity(self, opacity: f64) -> Self {
        Self {
            builder: self.builder.property("opacity", opacity),
        }
    }

    /// How content outside the widget's content area is treated.
    ///
    /// This property is meant to be set by widget implementations,
    /// typically in their instance init function.
    pub fn overflow(self, overflow: Overflow) -> Self {
        Self {
            builder: self.builder.property("overflow", overflow),
        }
    }

    /// Whether the widget will receive the default action when it is focused.
    pub fn receives_default(self, receives_default: bool) -> Self {
        Self {
            builder: self.builder.property("receives-default", receives_default),
        }
    }

    /// Whether the widget responds to input.
    pub fn sensitive(self, sensitive: bool) -> Self {
        Self {
            builder: self.builder.property("sensitive", sensitive),
        }
    }

    /// Sets the text of tooltip to be the given string, which is marked up
    /// with Pango markup.
    ///
    /// Also see [`Tooltip::set_markup()`][crate::Tooltip::set_markup()].
    ///
    /// This is a convenience property which will take care of getting the
    /// tooltip shown if the given string is not `NULL`:
    /// [`has-tooltip`][struct@crate::Widget#has-tooltip] will automatically be set to true
    /// and there will be taken care of [`query-tooltip`][struct@crate::Widget#query-tooltip] in
    /// the default signal handler.
    ///
    /// Note that if both [`tooltip-text`][struct@crate::Widget#tooltip-text] and
    /// [`tooltip-markup`][struct@crate::Widget#tooltip-markup] are set, the last one wins.
    pub fn tooltip_markup(self, tooltip_markup: impl Into<glib::GString>) -> Self {
        Self {
            builder: self
                .builder
                .property("tooltip-markup", tooltip_markup.into()),
        }
    }

    /// Sets the text of tooltip to be the given string.
    ///
    /// Also see [`Tooltip::set_text()`][crate::Tooltip::set_text()].
    ///
    /// This is a convenience property which will take care of getting the
    /// tooltip shown if the given string is not `NULL`:
    /// [`has-tooltip`][struct@crate::Widget#has-tooltip] will automatically be set to true
    /// and there will be taken care of [`query-tooltip`][struct@crate::Widget#query-tooltip] in
    /// the default signal handler.
    ///
    /// Note that if both [`tooltip-text`][struct@crate::Widget#tooltip-text] and
    /// [`tooltip-markup`][struct@crate::Widget#tooltip-markup] are set, the last one wins.
    pub fn tooltip_text(self, tooltip_text: impl Into<glib::GString>) -> Self {
        Self {
            builder: self.builder.property("tooltip-text", tooltip_text.into()),
        }
    }

    /// How to distribute vertical space if widget gets extra space.
    pub fn valign(self, valign: Align) -> Self {
        Self {
            builder: self.builder.property("valign", valign),
        }
    }

    /// Whether to expand vertically.
    pub fn vexpand(self, vexpand: bool) -> Self {
        Self {
            builder: self.builder.property("vexpand", vexpand),
        }
    }

    /// Whether to use the `vexpand` property.
    pub fn vexpand_set(self, vexpand_set: bool) -> Self {
        Self {
            builder: self.builder.property("vexpand-set", vexpand_set),
        }
    }

    /// Whether the widget is visible.
    pub fn visible(self, visible: bool) -> Self {
        Self {
            builder: self.builder.property("visible", visible),
        }
    }

    /// Overrides for width request of the widget.
    ///
    /// If this is -1, the natural request will be used.
    pub fn width_request(self, width_request: i32) -> Self {
        Self {
            builder: self.builder.property("width-request", width_request),
        }
    }

    /// The accessible role of the given [`Accessible`][crate::Accessible] implementation.
    ///
    /// The accessible role cannot be changed once set.
    pub fn accessible_role(self, accessible_role: AccessibleRole) -> Self {
        Self {
            builder: self.builder.property("accessible-role", accessible_role),
        }
    }

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