Learn R Programming

RGtk2 (version 2.20.31)

gtkTextBufferDeserializeSetCanCreateTags: gtkTextBufferDeserializeSetCanCreateTags

Description

Use this function to allow a rich text deserialization function to create new tags in the receiving buffer. Note that using this function is almost always a bad idea, because the rich text functions you register should know how to map the rich text format they handler to your text buffers set of tags.

Usage

gtkTextBufferDeserializeSetCanCreateTags(object, format, can.create.tags)

Arguments

format
a GdkAtom representing a registered rich text format
can.create.tags
whether deserializing this format may create tags

Details

The ability of creating new (arbitrary!) tags in the receiving buffer is meant for special rich text formats like the internal one that is registered using gtkTextBufferRegisterDeserializeTagset, because that format is essentially a dump of the internal structure of the source buffer, including its tag names. You should allow creation of tags only if you know what you are doing, e.g. if you defined a tagset name for your application suite's text buffers and you know that it's fine to receive new tags from these buffers, because you know that your application can handle the newly created tags. Since 2.10