gtkIconThemeLoadIcon          package:RGtk2          R Documentation

_g_t_k_I_c_o_n_T_h_e_m_e_L_o_a_d_I_c_o_n

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

     Looks up an icon in an icon theme, scales it to the given size and
     renders it into a pixbuf. This is a convenience function; if more
     details about the icon are needed, use 'gtkIconThemeLookupIcon'
     followed by 'gtkIconInfoLoadIcon'.

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

     gtkIconThemeLoadIcon(object, icon.name, size, flags, .errwarn = TRUE)

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

'object': ['GtkIconTheme']  a 'GtkIconTheme'

'icon.name': [character]  the name of the icon to lookup

  'size': [integer]  the desired icon size. The resulting icon may not
          be exactly this size; see 'gtkIconInfoLoadIcon'.

 'flags': ['GtkIconLookupFlags']  flags modifying the behavior of the
          icon lookup

.errwarn: Whether to issue a warning on error or fail silently

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

     Note that you probably want to listen for icon theme changes and
     update the icon. This is usually done by connecting to the 
     GtkWidget::style-set signal. If for some reason you do not want to
     update the icon when the icon theme changes, you should consider
     using 'gdkPixbufCopy' to make a private copy of the pixbuf
     returned by this function. Otherwise GTK+ may need to keep the old
      icon theme loaded, which would be a waste of memory.  

     Since  2.4

_V_a_l_u_e:

     A list containing the following elements: 

  retval: ['GdkPixbuf']  the rendered icon; this may be a newly created
          icon or a new reference to an internal icon, so you must not
          modify the icon. 'NULL' if the icon isn't found.

 'error': ['GError']  Location to store error information on failure,
          or 'NULL'.

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

     Derived by RGtkGen from GTK+ documentation

