Method

GtkTextBuffercreate_tag

Declaration [src]

GtkTextTag*
gtk_text_buffer_create_tag (
  GtkTextBuffer* buffer,
  const gchar* tag_name,
  const gchar* first_property_name,
  ...
)

Description [src]

Creates a tag 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 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 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.
...
 

NULL-terminated list of property names and values.

Return value

Returns: GtkTextTag
 

A new tag.

 The data is owned by the instance.