Method

GtkSourceBuffercreate_source_tag

Declaration [src]

GtkTextTag*
gtk_source_buffer_create_source_tag (
  GtkSourceBuffer* buffer,
  const gchar* tag_name,
  const gchar* first_property_name,
  ...
)

Description [src]

In short, this is the same function as gtk_text_buffer_create_tag() but instead of creating a GtkTextTag, this function creates a GtkSourceTag.

This function creates a GtkSourceTag and adds it to the tag table for buffer. Equivalent to calling gtk_text_tag_new() and then adding the tag to the buffer’s tag table. The returned tag is owned by the buffer’s tag table, so the ref count will be equal to one.

If tag_name is NULL, the tag is anonymous.

If tag_name is non-NULL, a tag called tag_name must not already exist in the tag table for this buffer.

The first_property_name argument and subsequent arguments are a list of properties to set on the tag, as with g_object_set().

This method is not directly available to language bindings.

Parameters

tag_name

Type: const gchar*

Name of the new tag, or NULL.

The argument can be NULL.
The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
first_property_name

Type: const gchar*

Name of first property to set, or NULL.

The argument can be NULL.
The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
...

Type: 

NULL-terminated list of property names and values.

Return value

Type: GtkTextTag

A new GtkSourceTag.

The data is owned by the instance.