gtkTextBufferDeserializeSetCanCreateTagspackage:RGtk2R Documentation

_g_t_k_T_e_x_t_B_u_f_f_e_r_D_e_s_e_r_i_a_l_i_z_e_S_e_t_C_a_n_C_r_e_a_t_e_T_a_g_s

_D_e_s_c_r_i_p_t_i_o_n:

     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.

_U_s_a_g_e:

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

_A_r_g_u_m_e_n_t_s:

'object': ['GtkTextBuffer']  a 'GtkTextBuffer'

'format': ['GdkAtom']  a 'GdkAtom' representing a registered rich text
          format

'can.create.tags': [logical]  whether deserializing this format may
          create tags

_D_e_t_a_i_l_s:

     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

_A_u_t_h_o_r(_s):

     Derived by RGtkGen from GTK+ documentation

