`GtkSourceMarkAttributes` is an object specifying attributes used by a [class@View] to visually show lines marked with [class@Mark]s of a
specific category. It allows you to define a background color of a line, an icon shown in gutter and tooltips.
The background color is used as a background of a line where a mark is placed and it can be set with [
[email protected]_background]. To check if any custom background color was defined and what color it is, use [
[email protected]_background].
An icon is a graphic element which is shown in the gutter of a view. An example use is showing a red filled circle in a debugger to show
that a breakpoint was set in certain line. To get an icon that will be placed in a gutter, first a base for it must be specified and then
[[email protected]_icon] must be called. There are several ways to specify a base for an icon:
Using any of the above functions overrides the one used earlier. But note that a getter counterpart of earlier used function can still
return some value, but it is just not used when rendering the proper icon.
To provide meaningful tooltips for a given mark of a category, you should connect to [signal@MarkAttributes:
GtkSourceMarkAttributes:query-tooltip-text] or [signal@MarkAttributes:GtkSourceMarkAttributes:query-tooltip-markup]
where the latter takes precedence.