Gtk.Inscription – gtk4 – Vala Binding Reference

Description:

[ CCode ( type_id = "gtk_inscription_get_type ()" ) ]
[ Version ( since = "4.8" ) ]
public class Inscription : Widget, Accessible, AccessibleText, Buildable, ConstraintTarget

Shows 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.

Namespace: Gtk

Package: gtk4

Content:

Properties:

public AttrList attributes { get; set; }

A list of style attributes to apply to the text of the inscription.

public string markup { set; }

Utility property that sets both the [property@Gtk.

public uint min_chars { get; set; }

The number of characters that should fit into the inscription at minimum.

public uint min_lines { get; set; }

The number of lines that should fit into the inscription at minimum.

public uint nat_chars { get; set; }

The number of characters that should ideally fit into the inscription.

public uint nat_lines { get; set; }

The number of lines that should ideally fit into the inscription.

public string text { get; set; }

The displayed text.

public InscriptionOverflow text_overflow { get; set; }

The overflow method to use for the text.

public WrapMode wrap_mode { get; set; }

Controls how the line wrapping is done.

public float xalign { get; set; }

The horizontal alignment of the text inside the allocated size.

public float yalign { get; set; }

The vertical alignment of the text inside the allocated size.

Creation methods:

public Inscription (string? text)

Creates a new `GtkInscription` with the given text.

Methods:

public unowned AttrList? get_attributes ()

Gets the inscription's attribute list.

public uint get_min_chars ()

Gets the `min-chars` of the inscription.

public uint get_min_lines ()

Gets the `min-lines` of the inscription.

public uint get_nat_chars ()

Gets the `nat-chars` of the inscription.

public uint get_nat_lines ()

Gets the `nat-lines` of the inscription.

public unowned string? get_text ()

Gets the text that is displayed.

public InscriptionOverflow get_text_overflow ()

Gets the inscription's overflow method.

public WrapMode get_wrap_mode ()

Returns line wrap mode used by the inscription.

public float get_xalign ()

Gets the `xalign` of the inscription.

public float get_yalign ()

Gets the `yalign` of the inscription.

public void set_attributes (AttrList? attrs)

Apply attributes to the inscription text.

public void set_markup (string? markup)

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

public void set_min_chars (uint min_chars)

Sets the `min-chars` of the inscription.

public void set_min_lines (uint min_lines)

Sets the `min-lines` of the inscription.

public void set_nat_chars (uint nat_chars)

Sets the `nat-chars` of the inscription.

public void set_nat_lines (uint nat_lines)

Sets the `nat-lines` of the inscription.

public void set_text (string? text)

Sets the text to be displayed.

public void set_text_overflow (InscriptionOverflow overflow)

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

public void set_wrap_mode (WrapMode wrap_mode)

Controls how line wrapping is done.

public void set_xalign (float xalign)

Sets the `xalign` of the inscription.

public void set_yalign (float yalign)

Sets the `yalign` of the inscription.

Inherited Members:

Inscription