Method
GtkTextBuffercreate_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().
This method is not directly available to language bindings.
Parameters
tag_name
-
Type:
const char*
Name of the new tag.
The argument can be NULL
.The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. first_property_name
-
Type:
const char*
Name of first property to set.
The argument can be NULL
.The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. ...
-
Type:
NULL
-terminated list of property names and values.
Return value
Type: GtkTextTag
A new tag.
The returned data is owned by the instance. |