Top | ![]() |
![]() |
![]() |
![]() |
GtkTextTag * | gtk_text_tag_new () |
gint | gtk_text_tag_get_priority () |
void | gtk_text_tag_set_priority () |
void | gtk_text_tag_changed () |
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.
GtkTextTag *
gtk_text_tag_new (const gchar *name
);
Creates a GtkTextTag. Configure the tag using object arguments,
i.e. using g_object_set()
.
gint
gtk_text_tag_get_priority (GtkTextTag *tag
);
Get the tag priority.
void gtk_text_tag_set_priority (GtkTextTag *tag
,gint priority
);
Sets the priority of a GtkTextTag. Valid priorities
start at 0 and go to one less than gtk_text_tag_table_get_size()
.
Each tag in a table has a unique priority; setting the priority
of one tag shifts the priorities of all the other tags in the
table to maintain a unique priority for each tag. Higher priority
tags “win” if two tags both set the same text attribute. When adding
a tag to a tag table, it will be assigned the highest priority in
the table by default; so normally the precedence of a set of tags
is the order in which they were added to the table, or created with
gtk_text_buffer_create_tag()
, which adds the tag to the buffer’s table
automatically.
void gtk_text_tag_changed (GtkTextTag *tag
,gboolean size_changed
);
Emits the “tag-changed” signal on the GtkTextTagTable where the tag is included.
The signal is already emitted when setting a GtkTextTag property. This function is useful for a GtkTextTag subclass.
“accumulative-margin”
property“accumulative-margin” gboolean
Whether the margins accumulate or override each other.
When set to TRUE
the margins of this tag are added to the margins
of any other non-accumulative margins present. When set to FALSE
the margins override one another (the default).
Flags: Read / Write
Default value: FALSE
“background”
property“background” gchar *
Background color as a string.
Flags: Write
Default value: NULL
“background-full-height”
property“background-full-height” gboolean
Whether the background color fills the entire line height or only the height of the tagged characters.
Flags: Read / Write
Default value: FALSE
“background-full-height-set”
property“background-full-height-set” gboolean
Whether this tag affects background height.
Flags: Read / Write
Default value: FALSE
“background-rgba”
property“background-rgba” GdkRGBA *
Background color as a GdkRGBA.
Flags: Read / Write
“background-set”
property“background-set” gboolean
Whether this tag affects the background color.
Flags: Read / Write
Default value: FALSE
“direction”
property“direction” GtkTextDirection
Text direction, e.g. right-to-left or left-to-right.
Flags: Read / Write
Default value: GTK_TEXT_DIR_NONE
“editable”
property“editable” gboolean
Whether the text can be modified by the user.
Flags: Read / Write
Default value: TRUE
“editable-set”
property“editable-set” gboolean
Whether this tag affects text editability.
Flags: Read / Write
Default value: FALSE
“fallback”
property“fallback” gboolean
Whether font fallback is enabled.
When set to TRUE
, other fonts will be substituted
where the current font is missing glyphs.
Flags: Read / Write
Default value: TRUE
“fallback-set”
property“fallback-set” gboolean
Whether this tag affects font fallback.
Flags: Read / Write
Default value: FALSE
“family”
property“family” gchar *
Name of the font family, e.g. Sans, Helvetica, Times, Monospace.
Flags: Read / Write
Default value: NULL
“family-set”
property“family-set” gboolean
Whether this tag affects the font family.
Flags: Read / Write
Default value: FALSE
“font”
property“font” gchar *
Font description as string, e.g. \"Sans Italic 12\".
Note that the initial value of this property depends on the internals of PangoFontDescription.
Flags: Read / Write
Default value: NULL
“font-desc”
property“font-desc” PangoFontDescription *
Font description as a PangoFontDescription struct.
Flags: Read / Write
“font-features”
property“font-features” gchar *
OpenType font features, as a string.
Flags: Read / Write
Default value: NULL
“font-features-set”
property“font-features-set” gboolean
Whether this tag affects font features.
Flags: Read / Write
Default value: FALSE
“foreground”
property“foreground” gchar *
Foreground color as a string.
Flags: Write
Default value: NULL
“foreground-rgba”
property“foreground-rgba” GdkRGBA *
Foreground color as a GdkRGBA.
Flags: Read / Write
“foreground-set”
property“foreground-set” gboolean
Whether this tag affects the foreground color.
Flags: Read / Write
Default value: FALSE
“indent”
property“indent” gint
Amount to indent the paragraph, in pixels.
Flags: Read / Write
Default value: 0
“indent-set”
property“indent-set” gboolean
Whether this tag affects indentation.
Flags: Read / Write
Default value: FALSE
“invisible”
property“invisible” gboolean
Whether this text is hidden.
Note that there may still be problems with the support for invisible text, in particular when navigating programmatically inside a buffer containing invisible segments.
Flags: Read / Write
Default value: FALSE
“invisible-set”
property“invisible-set” gboolean
Whether this tag affects text visibility.
Flags: Read / Write
Default value: FALSE
“justification”
property“justification” GtkJustification
Left, right, or center justification.
Flags: Read / Write
Default value: GTK_JUSTIFY_LEFT
“justification-set”
property“justification-set” gboolean
Whether this tag affects paragraph justification.
Flags: Read / Write
Default value: FALSE
“language”
property“language” gchar *
The language this text is in, as an ISO code. Pango can use this as a hint when rendering the text. If not set, an appropriate default will be used.
Note that the initial value of this property depends on the current
locale, see also gtk_get_default_language()
.
Flags: Read / Write
Default value: NULL
“language-set”
property“language-set” gboolean
Whether this tag affects the language the text is rendered as.
Flags: Read / Write
Default value: FALSE
“left-margin”
property“left-margin” gint
Width of the left margin in pixels.
Flags: Read / Write
Allowed values: >= 0
Default value: 0
“left-margin-set”
property“left-margin-set” gboolean
Whether this tag affects the left margin.
Flags: Read / Write
Default value: FALSE
“letter-spacing”
property“letter-spacing” gint
Extra spacing between graphemes, in Pango units.
Flags: Read / Write
Allowed values: >= 0
Default value: 0
“letter-spacing-set”
property“letter-spacing-set” gboolean
Whether this tag affects letter spacing.
Flags: Read / Write
Default value: FALSE
“name”
property“name” gchar *
Name used to refer to the text tag. NULL for anonymous tags.
Flags: Read / Write / Construct Only
Default value: NULL
“paragraph-background”
property“paragraph-background” gchar *
The paragraph background color as a string.
Flags: Write
Default value: NULL
“paragraph-background-rgba”
property“paragraph-background-rgba” GdkRGBA *
The paragraph background color as a GdkRGBA.
Flags: Read / Write
“paragraph-background-set”
property“paragraph-background-set” gboolean
Whether this tag affects the paragraph background color.
Flags: Read / Write
Default value: FALSE
“pixels-above-lines”
property“pixels-above-lines” gint
Pixels of blank space above paragraphs.
Flags: Read / Write
Allowed values: >= 0
Default value: 0
“pixels-above-lines-set”
property“pixels-above-lines-set” gboolean
Whether this tag affects the number of pixels above lines.
Flags: Read / Write
Default value: FALSE
“pixels-below-lines”
property“pixels-below-lines” gint
Pixels of blank space below paragraphs.
Flags: Read / Write
Allowed values: >= 0
Default value: 0
“pixels-below-lines-set”
property“pixels-below-lines-set” gboolean
Whether this tag affects the number of pixels above lines.
Flags: Read / Write
Default value: FALSE
“pixels-inside-wrap”
property“pixels-inside-wrap” gint
Pixels of blank space between wrapped lines in a paragraph.
Flags: Read / Write
Allowed values: >= 0
Default value: 0
“pixels-inside-wrap-set”
property“pixels-inside-wrap-set” gboolean
Whether this tag affects the number of pixels between wrapped lines.
Flags: Read / Write
Default value: FALSE
“right-margin”
property“right-margin” gint
Width of the right margin in pixels.
Flags: Read / Write
Allowed values: >= 0
Default value: 0
“right-margin-set”
property“right-margin-set” gboolean
Whether this tag affects the right margin.
Flags: Read / Write
Default value: FALSE
“rise”
property“rise” gint
Offset of text above the baseline (below the baseline if rise is negative) in Pango units.
Flags: Read / Write
Default value: 0
“rise-set”
property“rise-set” gboolean
Whether this tag affects the rise.
Flags: Read / Write
Default value: FALSE
“scale”
property“scale” gdouble
Font size as a scale factor relative to the default font size. This properly adapts to theme changes etc. so is recommended. Pango predefines some scales such as PANGO_SCALE_X_LARGE.
Flags: Read / Write
Allowed values: >= 0
Default value: 1
“scale-set”
property“scale-set” gboolean
Whether this tag scales the font size by a factor.
Flags: Read / Write
Default value: FALSE
“size”
property“size” gint
Font size in Pango units.
Flags: Read / Write
Allowed values: >= 0
Default value: 0
“size-points”
property“size-points” gdouble
Font size in points.
Flags: Read / Write
Allowed values: >= 0
Default value: 0
“size-set”
property“size-set” gboolean
Whether this tag affects the font size.
Flags: Read / Write
Default value: FALSE
“stretch”
property“stretch” PangoStretch
Font stretch as a PangoStretch, e.g. PANGO_STRETCH_CONDENSED.
Flags: Read / Write
Default value: PANGO_STRETCH_NORMAL
“stretch-set”
property“stretch-set” gboolean
Whether this tag affects the font stretch.
Flags: Read / Write
Default value: FALSE
“strikethrough”
property“strikethrough” gboolean
Whether to strike through the text.
Flags: Read / Write
Default value: FALSE
“strikethrough-rgba”
property“strikethrough-rgba” GdkRGBA *
This property modifies the color of strikeouts. If not set, strikeouts will use the forground color.
Flags: Read / Write
“strikethrough-rgba-set”
property“strikethrough-rgba-set” gboolean
If the “strikethrough-rgba” property has been set.
Flags: Read / Write
Default value: FALSE
“strikethrough-set”
property“strikethrough-set” gboolean
Whether this tag affects strikethrough.
Flags: Read / Write
Default value: FALSE
“style”
property“style” PangoStyle
Font style as a PangoStyle, e.g. PANGO_STYLE_ITALIC.
Flags: Read / Write
Default value: PANGO_STYLE_NORMAL
“style-set”
property“style-set” gboolean
Whether this tag affects the font style.
Flags: Read / Write
Default value: FALSE
“tabs-set”
property“tabs-set” gboolean
Whether this tag affects tabs.
Flags: Read / Write
Default value: FALSE
“underline”
property“underline” PangoUnderline
Style of underline for this text.
Flags: Read / Write
Default value: PANGO_UNDERLINE_NONE
“underline-rgba”
property“underline-rgba” GdkRGBA *
This property modifies the color of underlines. If not set, underlines will use the forground color.
If “underline” is set to PANGO_UNDERLINE_ERROR
, an alternate
color may be applied instead of the foreground. Setting this property
will always override those defaults.
Flags: Read / Write
“underline-rgba-set”
property“underline-rgba-set” gboolean
If the “underline-rgba” property has been set.
Flags: Read / Write
Default value: FALSE
“underline-set”
property“underline-set” gboolean
Whether this tag affects underlining.
Flags: Read / Write
Default value: FALSE
“variant”
property“variant” PangoVariant
Font variant as a PangoVariant, e.g. PANGO_VARIANT_SMALL_CAPS.
Flags: Read / Write
Default value: PANGO_VARIANT_NORMAL
“variant-set”
property“variant-set” gboolean
Whether this tag affects the font variant.
Flags: Read / Write
Default value: FALSE
“weight”
property“weight” gint
Font weight as an integer, see predefined values in PangoWeight; for example, PANGO_WEIGHT_BOLD.
Flags: Read / Write
Allowed values: >= 0
Default value: 400
“weight-set”
property“weight-set” gboolean
Whether this tag affects the font weight.
Flags: Read / Write
Default value: FALSE
“wrap-mode”
property“wrap-mode” GtkWrapMode
Whether to wrap lines never, at word boundaries, or at character boundaries.
Flags: Read / Write
Default value: GTK_WRAP_NONE
“wrap-mode-set”
property“wrap-mode-set” gboolean
Whether this tag affects line wrap mode.
Flags: Read / Write
Default value: FALSE