register_serialize_tagset


Description:

[ Version ( since = "2.10" ) ]
public Atom register_serialize_tagset (string? tagset_name)

This function registers GTK+’s internal rich text serialization format with the passed this.

The internal format does not comply to any standard rich text format and only works between TextBuffer instances. It is capable of serializing all of a text buffer’s tags and embedded pixbufs.

This function is just a wrapper around register_serialize_format. The mime type used for registering is “application/x-gtk-text-buffer-rich-text”, or “application/x-gtk-text-buffer-rich-text;format=tagset_name” if a tagset_name was passed.

The tagset_name can be used to restrict the transfer of rich text to buffers with compatible sets of tags, in order to avoid unknown tags from being pasted. It is probably the common case to pass an identifier != null here, since the null tagset requires the receiving buffer to deal with with pasting of arbitrary tags.

Parameters:

this

a TextBuffer

tagset_name

an optional tagset name, on null

Returns:

the Atom that corresponds to the newly registered format’s mime-type.