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.