Method

Gtk.TextBuffer.create_tag

Declaration [src]

GtkTextTag*
gtk_text_buffer_create_tag (
  GtkTextBuffer* buffer,
  const char* tag_name,
  const char* 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().

Parameters

tag_name const char*
 

name of the new tag, or NULL

 Can be NULL
 Ownership is not transferred to the callee
 The string is a NUL terminated UTF-8 string
first_property_name const char*
 

name of first property to set, or NULL

 Can be NULL
 Ownership is not transferred to the callee
 The string is a NUL terminated UTF-8 string
...
 

NULL-terminated list of property names and values

Return value

Returns: GtkTextTag

a new tag

Ownership is not transferred to the caller