gtk4/auto/
fixed_layout.rs

Help
1// This file was generated by gir (https://github.com/gtk-rs/gir)
2// from gir-files (https://github.com/gtk-rs/gir-files)
3// DO NOT EDIT
4
5use crate::{ffi, LayoutManager};
6use glib::{prelude::*, translate::*};
7
8glib::wrapper! {
9    /// Places child widgets at fixed positions.
10    ///
11    /// Most applications should never use this layout manager; fixed positioning
12    /// and sizing requires constant recalculations on where children need to be
13    /// positioned and sized. Other layout managers perform this kind of work
14    /// internally so that application developers don't need to do it. Specifically,
15    /// widgets positioned in a fixed layout manager will need to take into account:
16    ///
17    /// - Themes, which may change widget sizes.
18    ///
19    /// - Fonts other than the one you used to write the app will of course
20    ///   change the size of widgets containing text; keep in mind that
21    ///   users may use a larger font because of difficulty reading the
22    ///   default, or they may be using a different OS that provides different
23    ///   fonts.
24    ///
25    /// - Translation of text into other languages changes its size. Also,
26    ///   display of non-English text will use a different font in many
27    ///   cases.
28    ///
29    /// In addition, [`FixedLayout`][crate::FixedLayout] does not pay attention to text direction and
30    /// thus may produce unwanted results if your app is run under right-to-left
31    /// languages such as Hebrew or Arabic. That is: normally GTK will order
32    /// containers appropriately depending on the text direction, e.g. to put labels
33    /// to the right of the thing they label when using an RTL language;
34    /// [`FixedLayout`][crate::FixedLayout] won't be able to do that for you.
35    ///
36    /// Finally, fixed positioning makes it kind of annoying to add/remove UI
37    /// elements, since you have to reposition all the other  elements. This is a
38    /// long-term maintenance problem for your application.
39    ///
40    /// # Implements
41    ///
42    /// [`LayoutManagerExt`][trait@crate::prelude::LayoutManagerExt], [`trait@glib::ObjectExt`]
43    #[doc(alias = "GtkFixedLayout")]
44    pub struct FixedLayout(Object<ffi::GtkFixedLayout, ffi::GtkFixedLayoutClass>) @extends LayoutManager;
45
46    match fn {
47        type_ => || ffi::gtk_fixed_layout_get_type(),
48    }
49}
50
51impl FixedLayout {
52    /// Creates a new [`FixedLayout`][crate::FixedLayout].
53    ///
54    /// # Returns
55    ///
56    /// the newly created [`FixedLayout`][crate::FixedLayout]
57    #[doc(alias = "gtk_fixed_layout_new")]
58    pub fn new() -> FixedLayout {
59        assert_initialized_main_thread!();
60        unsafe { LayoutManager::from_glib_full(ffi::gtk_fixed_layout_new()).unsafe_cast() }
61    }
62}
63
64impl Default for FixedLayout {
65    fn default() -> Self {
66        Self::new()
67    }
68}
gtk4/auto/fixed_layout.rs

gtk4/auto/
fixed_layout.rs
