AspectFrame

class AspectFrame(**properties: Any)

Superclasses: Widget, InitiallyUnowned, Object

Implemented Interfaces: Accessible, Buildable, ConstraintTarget

Constructors:

AspectFrame(**properties)
new(xalign:float, yalign:float, ratio:float, obey_child:bool) -> Gtk.Widget

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 child widget.

props.obey_child: bool

Whether the GtkAspectFrame should use the aspect ratio of its child.

props.ratio: float

The aspect ratio to be used by the GtkAspectFrame.

This property is only used if obey_child is set to False.

props.xalign: float

The horizontal alignment of the child.

props.yalign: float

The vertical alignment of the child.