ConstraintGuide#

class ConstraintGuide(**properties: Any)#

Superclasses: Object

Implemented Interfaces: ConstraintTarget

A GtkConstraintGuide is an invisible layout element in a GtkConstraintLayout.

The GtkConstraintLayout treats guides like widgets. They can be used as the source or target of a GtkConstraint.

Guides have a minimum, maximum and natural size. Depending on the constraints that are applied, they can act like a guideline that widgets can be aligned to, or like flexible space.

Unlike a GtkWidget, a GtkConstraintGuide will not be drawn.

Constructors#

class ConstraintGuide
classmethod new() → ConstraintGuide#

Creates a new GtkConstraintGuide object.

Methods#

class ConstraintGuide
get_max_size() → tuple[int, int]#

Gets the maximum size of guide.

get_min_size() → tuple[int, int]#

Gets the minimum size of guide.

get_name() → str | None#

Retrieves the name set using set_name().

get_nat_size() → tuple[int, int]#

Gets the natural size of guide.

get_strength() → ConstraintStrength#

Retrieves the strength set using set_strength().

set_max_size(width: int, height: int) → None#

Sets the maximum size of guide.

If guide is attached to a GtkConstraintLayout, the constraints will be updated to reflect the new size.

Parameters:

  • width – the new maximum width, or -1 to not change it

  • height – the new maximum height, or -1 to not change it

set_min_size(width: int, height: int) → None#

Sets the minimum size of guide.

If guide is attached to a GtkConstraintLayout, the constraints will be updated to reflect the new size.

Parameters:

  • width – the new minimum width, or -1 to not change it

  • height – the new minimum height, or -1 to not change it

set_name(name: str | None = None) → None#

Sets a name for the given GtkConstraintGuide.

The name is useful for debugging purposes.

Parameters:

name – a name for the guide

set_nat_size(width: int, height: int) → None#

Sets the natural size of guide.

If guide is attached to a GtkConstraintLayout, the constraints will be updated to reflect the new size.

Parameters:

  • width – the new natural width, or -1 to not change it

  • height – the new natural height, or -1 to not change it

set_strength(strength: ConstraintStrength) → None#

Sets the strength of the constraint on the natural size of the given GtkConstraintGuide.

Parameters:

strength – the strength of the constraint

Properties#

class ConstraintGuide
props.max_height: int#

The type of the None singleton.

props.max_width: int#

The type of the None singleton.

props.min_height: int#

The type of the None singleton.

props.min_width: int#

The type of the None singleton.

props.name: str#

The type of the None singleton.

props.nat_height: int#

The type of the None singleton.

props.nat_width: int#

The type of the None singleton.

props.strength: ConstraintStrength#

The type of the None singleton.