Inscription

Added in version 4.8.

class Inscription(**properties: Any)

Superclasses: Widget, InitiallyUnowned, Object

Implemented Interfaces: Accessible, AccessibleText, Buildable, ConstraintTarget

GtkInscription is a widget to show text in a predefined area.

You likely want to use GtkLabel instead as this widget is intended only for a small subset of use cases. The main scenario envisaged is inside lists such as GtkColumnView.

While a GtkLabel sizes itself depending on the text that is displayed, GtkInscription is given a size and inscribes the given text into that space as well as it can.

Users of this widget should take care to plan behaviour for the common case where the text doesn’t fit exactly in the allocated space.

CSS nodes

GtkInscription has a single CSS node with the name label.

Constructors

class Inscription

classmethod new(text: str | None = None) → Widget

Creates a new GtkInscription with the given text.

Added in version 4.8.

Parameters:

text – The text to display.

Methods

class Inscription

get_attributes() → AttrList | None

Gets the inscription’s attribute list.

Added in version 4.8.

get_min_chars() → int

Gets the min-chars of the inscription.

See the min_chars property.

Added in version 4.8.

get_min_lines() → int

Gets the min-lines of the inscription.

See the min_lines property.

Added in version 4.8.

get_nat_chars() → int

Gets the nat-chars of the inscription.

See the nat_chars property.

Added in version 4.8.

get_nat_lines() → int

Gets the nat-lines of the inscription.

See the nat_lines property.

Added in version 4.8.

get_text() → str | None

Gets the text that is displayed.

Added in version 4.8.

get_text_overflow() → InscriptionOverflow

Gets the inscription’s overflow method.

Added in version 4.8.

get_wrap_mode() → WrapMode

Returns line wrap mode used by the inscription.

See set_wrap_mode.

Added in version 4.8.

get_xalign() → float

Gets the xalign of the inscription.

See the xalign property.

Added in version 4.8.

get_yalign() → float

Gets the yalign of the inscription.

See the yalign property.

Added in version 4.8.

set_attributes(attrs: AttrList | None = None) → None

Apply attributes to the inscription text.

These attributes will not be evaluated for sizing the inscription.

Added in version 4.8.

Parameters:

attrs – a AttrList

set_markup(markup: str | None = None) → None

Utility function to set the text and attributes to be displayed.

See the markup property.

Added in version 4.8.

Parameters:

markup – The markup to display

set_min_chars(min_chars: int) → None

Sets the min-chars of the inscription.

See the min_chars property.

Added in version 4.8.

Parameters:

min_chars – the minimum number of characters that should fit, approximately

set_min_lines(min_lines: int) → None

Sets the min-lines of the inscription.

See the min_lines property.

Added in version 4.8.

Parameters:

min_lines – the minimum number of lines that should fit, approximately

set_nat_chars(nat_chars: int) → None

Sets the nat-chars of the inscription.

See the nat_chars property.

Added in version 4.8.

Parameters:

nat_chars – the number of characters that should ideally fit, approximately

set_nat_lines(nat_lines: int) → None

Sets the nat-lines of the inscription.

See the nat_lines property.

Added in version 4.8.

Parameters:

nat_lines – the number of lines that should ideally fit

set_text(text: str | None = None) → None

Sets the text to be displayed.

Added in version 4.8.

Parameters:

text – The text to display

set_text_overflow(overflow: InscriptionOverflow) → None

Sets what to do when the text doesn’t fit.

Added in version 4.8.

Parameters:

overflow – the overflow method to use

set_wrap_mode(wrap_mode: WrapMode) → None

Controls how line wrapping is done.

Added in version 4.8.

Parameters:

wrap_mode – the line wrapping mode

set_xalign(xalign: float) → None

Sets the xalign of the inscription.

See the xalign property.

Added in version 4.8.

Parameters:

xalign – the new xalign value, between 0 and 1

set_yalign(yalign: float) → None

Sets the yalign of the inscription.

See the yalign property.

Added in version 4.8.

Parameters:

yalign – the new yalign value, between 0 and 1

Properties

class Inscription

props.attributes: AttrList

The type of the None singleton.

Added in version 4.8.

props.markup: str

The type of the None singleton.

Added in version 4.8.

props.min_chars: int

The type of the None singleton.

Added in version 4.8.

props.min_lines: int

The type of the None singleton.

Added in version 4.8.

props.nat_chars: int

The type of the None singleton.

Added in version 4.8.

props.nat_lines: int

The type of the None singleton.

Added in version 4.8.

props.text: str

The type of the None singleton.

Added in version 4.8.

props.text_overflow: InscriptionOverflow

The type of the None singleton.

Added in version 4.8.

props.wrap_mode: WrapMode

The type of the None singleton.

Added in version 4.8.

props.xalign: float

The type of the None singleton.

Added in version 4.8.

props.yalign: float

The type of the None singleton.

Added in version 4.8.