gdk-Properties-and-Atoms        package:RGtk2        R Documentation

_P_r_o_p_e_r_t_i_e_s _a_n_d _A_t_o_m_s

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

     Functions to manipulate properties on windows

_M_e_t_h_o_d_s _a_n_d _F_u_n_c_t_i_o_n_s:

     'gdkAtomIntern(atom.name, only.if.exists = FALSE)'
      'gdkAtomInternStaticString(atom.name)'
      'gdkAtomName(atom)'
      'gdkPropertyGet(object, property, type, offset, length, pdelete)'
      'gdkPropertyChange(object, property, type, format, mode, data)'
      'gdkPropertyDelete(object, property)'

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

     Each window under X can have any number of associated properties
     attached to it. Properties are arbitrary chunks of data identified
     by atoms. (An atom is a numeric index into a string table on the X
     server. They are used to transfer strings efficiently between
     clients without having to transfer the entire string.) A property
     has an associated type, which is also identified using an atom.

     A property has an associated format, an integer describing how
     many bits are in each unit of data inside the property. It must be
     8, 16, or 32. When data is transferred between the server and
     client, if they are of different endianesses it will be
     byteswapped as necessary according to the format of the property.
     Note that on the client side, properties of format 32 will be
     stored with one unit per _long_, even if a long integer has more
     than 32 bits on the platform. (This decision was apparently made
     for Xlib to maintain compatibility with programs that assumed
     longs were 32 bits, at the expense of programs that knew better.)

     The functions in this section are used to add, remove and change
     properties on windows, to convert atoms to and from strings and to
     manipulate some types of data commonly stored in X window
     properties.

_S_t_r_u_c_t_u_r_e_s:


     '_G_d_k_A_t_o_m' An opaque type representing a string as an index into a
          table of strings on the X server. *'GdkAtom' is a
          transparent-type.*


_E_n_u_m_s _a_n_d _F_l_a_g_s:


     '_G_d_k_P_r_o_p_M_o_d_e' Describes how existing data is combined with new
          data when using 'gdkPropertyChange'.

          '_r_e_p_l_a_c_e' the new data replaces the existing data.

          '_p_r_e_p_e_n_d' the new data is prepended to the existing data.

          '_a_p_p_e_n_d' the new data is appended to the existing data.


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

     Derived by RGtkGen from GTK+ documentation

_R_e_f_e_r_e_n_c_e_s:

     <URL:
     http://developer.gnome.org/doc/API/2.0/gdk/gdk-Properties-and-Atoms.html>

