gtkTextBufferDeserializeSetCanCreateTags: gtkTextBufferDeserializeSetCanCreateTags

Description Usage Arguments Details Author(s)

View source: R/gtkFuncs.R

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

1

Arguments

object

a GtkTextBuffer

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

Author(s)

Derived by RGtkGen from GTK+ documentation


RGtk2 documentation built on Oct. 14, 2021, 5:08 p.m.