### Class

# Gtk TextTag

#### Description [src]

    class Gtk.TextTag : GObject.Object
    {
      GtkTextTagPrivate* priv
    }

Can be applied to text contained in a `GtkTextBuffer`.

You may wish to begin by reading the text widget conceptual overview, which gives an overview of all the objects and data types related to the text widget and how they work together.

Tags should be in the `GtkTextTagTable` for a given `GtkTextBuffer` before using them with that buffer.

`gtk_text_buffer_create_tag()` is the best way to create tags. See “gtk4-demo” for numerous examples.

For each property of `GtkTextTag`, there is a “set” property, e.g. “font-set” corresponds to “font”. These “set” properties reflect whether a property has been set or not.

They are maintained by GTK and you should not set them independently.

#### Ancestors

- GObject

#### Constructors

###### gtk_text_tag_new

Creates a `GtkTextTag`.

#### Instance methods

###### gtk_text_tag_changed

Emits the `GtkTextTagTable::tag-changed` signal on the `GtkTextTagTable` where the tag is included.

###### gtk_text_tag_get_priority

Get the tag priority.

###### gtk_text_tag_set_priority

Sets the priority of a `GtkTextTag`.

##### Methods inherited from GObject (43)

Please see GObject for a full list of methods.

#### Properties

###### Gtk.TextTag:accumulative-margin

Whether the margins accumulate or override each other.

###### Gtk.TextTag:allow-breaks

Whether breaks are allowed.

###### Gtk.TextTag:allow-breaks-set

Whether the `allow-breaks` property is set.

###### Gtk.TextTag:background

Background color as a string.

###### Gtk.TextTag:background-full-height

Whether the background color fills the entire line height or only the height of the tagged characters.

###### Gtk.TextTag:background-full-height-set

Whether the `background-full-height` property is set.

###### Gtk.TextTag:background-rgba

Background color as a `GdkRGBA`.

###### Gtk.TextTag:background-set

Whether the `background` property is set.

###### Gtk.TextTag:direction

Text direction, e.g. right-to-left or left-to-right.

###### Gtk.TextTag:editable

Whether the text can be modified by the user.

###### Gtk.TextTag:editable-set

Whether the `editable` property is set.

###### Gtk.TextTag:fallback

Whether font fallback is enabled.

###### Gtk.TextTag:fallback-set

Whether the `fallback` property is set.

###### Gtk.TextTag:family

Name of the font family, e.g. Sans, Helvetica, Times, Monospace.

###### Gtk.TextTag:family-set

Whether the `family` property is set.

###### Gtk.TextTag:font

Font description as string, e.g. "Sans Italic 12".

###### Gtk.TextTag:font-desc

Font description as a `PangoFontDescription`.

###### Gtk.TextTag:font-features

OpenType font features, as a string.

###### Gtk.TextTag:font-features-set

Whether the `font-features` property is set.

###### Gtk.TextTag:foreground

Foreground color as a string.

###### Gtk.TextTag:foreground-rgba

Foreground color as a `GdkRGBA`.

###### Gtk.TextTag:foreground-set

Whether the `foreground` property is set.

###### Gtk.TextTag:indent

Amount to indent the paragraph, in pixels.

###### Gtk.TextTag:indent-set

Whether the `indent` property is set.

###### Gtk.TextTag:insert-hyphens

Whether to insert hyphens at breaks.

###### Gtk.TextTag:insert-hyphens-set

Whether the `insert-hyphens` property is set.

###### Gtk.TextTag:invisible

Whether this text is hidden.

###### Gtk.TextTag:invisible-set

Whether the `invisible` property is set.

###### Gtk.TextTag:justification

Left, right, or center justification.

###### Gtk.TextTag:justification-set

Whether the `justification` property is set.

###### Gtk.TextTag:language

The language this text is in, as an ISO code.

###### Gtk.TextTag:language-set

Whether the `language` property is set.

###### Gtk.TextTag:left-margin

Width of the left margin in pixels.

###### Gtk.TextTag:left-margin-set

Whether the `left-margin` property is set.

###### Gtk.TextTag:letter-spacing

Extra spacing between graphemes, in Pango units.

###### Gtk.TextTag:letter-spacing-set

Whether the `letter-spacing` property is set.

###### Gtk.TextTag:line-height

Factor to scale line height by.

since: 4.6

###### Gtk.TextTag:line-height-set

Whether the `line-height` property is set.

###### Gtk.TextTag:name

The name used to refer to the tag.

###### Gtk.TextTag:overline

Style of overline for this text.

###### Gtk.TextTag:overline-rgba

This property modifies the color of overlines.

###### Gtk.TextTag:overline-rgba-set

Whether the `overline-rgba` property is set.

###### Gtk.TextTag:overline-set

Whether the `overline` property is set.

###### Gtk.TextTag:paragraph-background

The paragraph background color as a string.

###### Gtk.TextTag:paragraph-background-rgba

The paragraph background color as a `GdkRGBA`.

###### Gtk.TextTag:paragraph-background-set

Whether the `paragraph-background` property is set.

###### Gtk.TextTag:pixels-above-lines

Pixels of blank space above paragraphs.

###### Gtk.TextTag:pixels-above-lines-set

Whether the `pixels-above-lines` property is set.

###### Gtk.TextTag:pixels-below-lines

Pixels of blank space below paragraphs.

###### Gtk.TextTag:pixels-below-lines-set

Whether the `pixels-below-lines` property is set.

###### Gtk.TextTag:pixels-inside-wrap

Pixels of blank space between wrapped lines in a paragraph.

###### Gtk.TextTag:pixels-inside-wrap-set

Whether the `pixels-inside-wrap` property is set.

###### Gtk.TextTag:right-margin

Width of the right margin, in pixels.

###### Gtk.TextTag:right-margin-set

Whether the `right-margin` property is set.

###### Gtk.TextTag:rise

Offset of text above the baseline, in Pango units.

###### Gtk.TextTag:rise-set

Whether the `rise` property is set.

###### Gtk.TextTag:scale

Font size as a scale factor relative to the default font size.

###### Gtk.TextTag:scale-set

Whether the `scale` property is set.

###### Gtk.TextTag:sentence

Whether this tag represents a single sentence.

since: 4.6

###### Gtk.TextTag:sentence-set

Whether the `sentence` property is set.

###### Gtk.TextTag:show-spaces

How to render invisible characters.

###### Gtk.TextTag:show-spaces-set

Whether the `show-spaces` property is set.

###### Gtk.TextTag:size

Font size in Pango units.

###### Gtk.TextTag:size-points

Font size in points.

###### Gtk.TextTag:size-set

Whether the `size` property is set.

###### Gtk.TextTag:stretch

Font stretch as a `PangoStretch`, e.g. `PANGO_STRETCH_CONDENSED`.

###### Gtk.TextTag:stretch-set

Whether the `stretch` property is set.

###### Gtk.TextTag:strikethrough

Whether to strike through the text.

###### Gtk.TextTag:strikethrough-rgba

This property modifies the color of strikeouts.

###### Gtk.TextTag:strikethrough-rgba-set

If the `strikethrough-rgba` property has been set.

###### Gtk.TextTag:strikethrough-set

Whether the `strikethrough` property is set.

###### Gtk.TextTag:style

Font style as a `PangoStyle`, e.g. `PANGO_STYLE_ITALIC`.

###### Gtk.TextTag:style-set

Whether the `style` property is set.

###### Gtk.TextTag:tabs

Custom tabs for this text.

###### Gtk.TextTag:tabs-set

Whether the `tabs` property is set.

###### Gtk.TextTag:text-transform

How to transform the text for display.

since: 4.6

###### Gtk.TextTag:text-transform-set

Whether the `text-transform` property is set.

###### Gtk.TextTag:underline

Style of underline for this text.

###### Gtk.TextTag:underline-rgba

This property modifies the color of underlines.

###### Gtk.TextTag:underline-rgba-set

If the `underline-rgba` property has been set.

###### Gtk.TextTag:underline-set

Whether the `underline` property is set.

###### Gtk.TextTag:variant

Font variant as a `PangoVariant`, e.g. `PANGO_VARIANT_SMALL_CAPS`.

###### Gtk.TextTag:variant-set

Whether the `variant` property is set.

###### Gtk.TextTag:weight

Font weight as an integer.

###### Gtk.TextTag:weight-set

Whether the `weight` property is set.

###### Gtk.TextTag:word

Whether this tag represents a single word.

since: 4.6

###### Gtk.TextTag:word-set

Whether the `word` property is set.

###### Gtk.TextTag:wrap-mode

Whether to wrap lines never, at word boundaries, or at character boundaries.

###### Gtk.TextTag:wrap-mode-set

Whether the `wrap-mode` property is set.

#### Signals

##### Signals inherited from GObject (1)

###### GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

#### Class structure

    struct GtkTextTagClass {
      GObjectClass parent_class;

    }

No description available.

###### Class members

`parent_class: GObjectClass`

  No description available.