Struct gtk4::GridLayout

#[repr(transparent)]
pub struct GridLayout { /* private fields */ }

GridLayout is a layout manager which arranges child widgets in rows and columns.

Children have an “attach point” defined by the horizontal and vertical index of the cell they occupy; children can span multiple rows or columns. The layout properties for setting the attach points and spans are set using the GridLayoutChild associated to each child widget.

The behaviour of GridLayout when several children occupy the same grid cell is undefined.

GridLayout can be used like a BoxLayout if all children are attached to the same row or column; however, if you only ever need a single row or column, you should consider using BoxLayout.

Properties

baseline-row

The row to align to the baseline, when GtkWidget:valign is set to Align::Baseline.

Readable | Writeable

column-homogeneous

Whether all the columns in the grid have the same width.

Readable | Writeable

column-spacing

The amount of space between to consecutive columns.

Readable | Writeable

row-homogeneous

Whether all the rows in the grid have the same height.

Readable | Writeable

row-spacing

The amount of space between to consecutive rows.

Readable | Writeable

Implements

LayoutManagerExt, glib::ObjectExt

Implementations

impl GridLayout

pub fn new() -> GridLayout

Creates a new GridLayout.

Returns

the newly created GridLayout

pub fn builder() -> GridLayoutBuilder

Creates a new builder-pattern struct instance to construct GridLayout objects.

This method returns an instance of GridLayoutBuilder which can be used to create GridLayout objects.

pub fn baseline_row(&self) -> i32

Retrieves the row set with gtk_grid_layout_set_baseline_row().

Returns

the global baseline row

pub fn is_column_homogeneous(&self) -> bool

Checks whether all columns of @self should have the same width.

Returns

true if the columns are homogeneous, and false otherwise

pub fn column_spacing(&self) -> u32

Retrieves the spacing set with gtk_grid_layout_set_column_spacing().

Returns

the spacing between consecutive columns

pub fn row_baseline_position(&self, row: i32) -> BaselinePosition

Returns the baseline position of @row.

If no value has been set with set_row_baseline_position(), the default value of BaselinePosition::Center is returned.

row

a row index

Returns

the baseline position of @row

pub fn is_row_homogeneous(&self) -> bool

Checks whether all rows of @self should have the same height.

Returns

true if the rows are homogeneous, and false otherwise

pub fn row_spacing(&self) -> u32

Retrieves the spacing set with gtk_grid_layout_set_row_spacing().

Returns

the spacing between consecutive rows

pub fn set_baseline_row(&self, row: i32)

Sets which row defines the global baseline for the entire grid.

Each row in the grid can have its own local baseline, but only one of those is global, meaning it will be the baseline in the parent of the @self.

row

the row index

pub fn set_column_homogeneous(&self, homogeneous: bool)

Sets whether all columns of @self should have the same width.

homogeneous

true to make columns homogeneous

pub fn set_column_spacing(&self, spacing: u32)

Sets the amount of space to insert between consecutive columns.

spacing

the amount of space between columns, in pixels

pub fn set_row_baseline_position(&self, row: i32, pos: BaselinePosition)

Sets how the baseline should be positioned on @row of the grid, in case that row is assigned more space than is requested.

row

a row index

pos

a BaselinePosition

pub fn set_row_homogeneous(&self, homogeneous: bool)

Sets whether all rows of @self should have the same height.

homogeneous

true to make rows homogeneous

pub fn set_row_spacing(&self, spacing: u32)

Sets the amount of space to insert between consecutive rows.

spacing

the amount of space between rows, in pixels

pub fn connect_baseline_row_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn connect_column_homogeneous_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn connect_column_spacing_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn connect_row_homogeneous_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

pub fn connect_row_spacing_notify<F: Fn(&Self) + 'static>( &self, f: F ) -> SignalHandlerId

Trait Implementations

impl Clone for GridLayout

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GridLayout

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for GridLayout

fn default() -> Self

Returns the “default value” for a type.

impl Display for GridLayout

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl HasParamSpec for GridLayout

type ParamSpec = ParamSpecObject

type SetValue = GridLayout

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecObjectBuilder<'_, GridLayout>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for GridLayout

fn hash<H>(&self, state: &mut H)where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for GridLayout

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl ParentClassIs for GridLayout

type Parent = LayoutManager

impl<OT: ObjectType> PartialEq<OT> for GridLayout

fn eq(&self, other: &OT) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for GridLayout

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for GridLayout

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for GridLayout

impl IsA<LayoutManager> for GridLayout