AspectFrame

class AspectFrame(**properties: Any)

Superclasses: Widget, InitiallyUnowned, Object

Implemented Interfaces: Accessible, Buildable, ConstraintTarget

GtkAspectFrame preserves the aspect ratio of its child.

The frame can respect the aspect ratio of the child widget, or use its own aspect ratio.

CSS nodes

GtkAspectFrame uses a CSS node with name aspectframe.

Accessibility

Until GTK 4.10, GtkAspectFrame used the GTK_ACCESSIBLE_ROLE_GROUP role.

Starting from GTK 4.12, GtkAspectFrame uses the GTK_ACCESSIBLE_ROLE_GENERIC role.

Constructors

class AspectFrame

classmethod new(xalign: float, yalign: float, ratio: float, obey_child: bool) → Widget

Create a new GtkAspectFrame.

Parameters:

• xalign – Horizontal alignment of the child within the parent. Ranges from 0.0 (left aligned) to 1.0 (right aligned)

• yalign – Vertical alignment of the child within the parent. Ranges from 0.0 (top aligned) to 1.0 (bottom aligned)

• ratio – The desired aspect ratio.

• obey_child – If True, ratio is ignored, and the aspect ratio is taken from the requistion of the child.

Methods

class AspectFrame

get_child() → Widget | None

Gets the child widget of self.

get_obey_child() → bool

Returns whether the child’s size request should override the set aspect ratio of the GtkAspectFrame.

get_ratio() → float

Returns the desired aspect ratio of the child.

get_xalign() → float

Returns the horizontal alignment of the child within the allocation of the GtkAspectFrame.

get_yalign() → float

Returns the vertical alignment of the child within the allocation of the GtkAspectFrame.

set_child(child: Widget | None = None) → None

Sets the child widget of self.

Parameters:

child – the child widget

set_obey_child(obey_child: bool) → None

Sets whether the aspect ratio of the child’s size request should override the set aspect ratio of the GtkAspectFrame.

Parameters:

obey_child – If True, ratio is ignored, and the aspect ratio is taken from the requisition of the child.

set_ratio(ratio: float) → None

Sets the desired aspect ratio of the child.

Parameters:

ratio – aspect ratio of the child

set_xalign(xalign: float) → None

Sets the horizontal alignment of the child within the allocation of the GtkAspectFrame.

Parameters:

xalign – horizontal alignment, from 0.0 (left aligned) to 1.0 (right aligned)

set_yalign(yalign: float) → None

Sets the vertical alignment of the child within the allocation of the GtkAspectFrame.

Parameters:

yalign – horizontal alignment, from 0.0 (top aligned) to 1.0 (bottom aligned)

Properties

class AspectFrame

props.child: Widget

The type of the None singleton.

props.obey_child: bool

The type of the None singleton.

props.ratio: float

The type of the None singleton.

props.xalign: float

The type of the None singleton.

props.yalign: float

The type of the None singleton.