Branch: Tag:

2005-07-28

2005-07-28 15:26:09 by Martin Nilsson <mani@lysator.liu.se>

GTK2

Rev: src/post_modules/GTK2/AUTHORS:1.1
Rev: src/post_modules/GTK2/build_pgtk.pike:1.1
Rev: src/post_modules/GTK2/gdkeventstrings.h:1.1
Rev: src/post_modules/GTK2/module.pmod.in:1.1
Rev: src/post_modules/GTK2/pgtk.h:1.1
Rev: src/post_modules/GTK2/source/common_draw.inc:1.1
Rev: src/post_modules/GTK2/source/constants.pre:1.1
Rev: src/post_modules/GTK2/source/encode_truecolor.c:1.1
Rev: src/post_modules/GTK2/source/gdkatom.pre:1.1
Rev: src/post_modules/GTK2/source/gdkbitmap.pre:1.1
Rev: src/post_modules/GTK2/source/gdkcolor.pre:1.1
Rev: src/post_modules/GTK2/source/gdkdisplay.pre:1.1
Rev: src/post_modules/GTK2/source/gdkdragcontext.pre:1.1
Rev: src/post_modules/GTK2/source/gdkdrawable.pre:1.1
Rev: src/post_modules/GTK2/source/gdkevent.pre:1.1
Rev: src/post_modules/GTK2/source/gdkgc.pre:1.1
Rev: src/post_modules/GTK2/source/gdkimage.pre:1.1
Rev: src/post_modules/GTK2/source/gdkpixbuf.pre:1.1
Rev: src/post_modules/GTK2/source/gdkpixbufanimation.pre:1.1
Rev: src/post_modules/GTK2/source/gdkpixbufanimationiter.pre:1.1
Rev: src/post_modules/GTK2/source/gdkpixmap.pre:1.1
Rev: src/post_modules/GTK2/source/gdkrectangle.pre:1.1
Rev: src/post_modules/GTK2/source/gdkregion.pre:1.1
Rev: src/post_modules/GTK2/source/gdkwindow.pre:1.1
Rev: src/post_modules/GTK2/source/gladexml.pre:1.1
Rev: src/post_modules/GTK2/source/global.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomeabout.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomeapp.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomeappbar.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomeapplet.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomecalculator.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomecanvas.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomecanvasgroup.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomecanvasitem.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomecanvasline.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomecolorpicker.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomedateedit.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomedialog.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomedock.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomedockband.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomedockitem.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomedocklayout.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomedruid.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomedruidpage.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomedruidpagefinish.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomedruidpagestandard.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomedruidpagestart.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomehref.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomeiconentry.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomeiconselection.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomeless.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomemessagebox.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomenumberentry.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomepaperselector.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomepropertybox.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomescores.pre:1.1
Rev: src/post_modules/GTK2/source/gnome/gnomestatusdocklet.pre:1.1
Rev: src/post_modules/GTK2/source/gnomeapp.pre:1.1
Rev: src/post_modules/GTK2/source/gnomeappbar.pre:1.1
Rev: src/post_modules/GTK2/source/gnomecanvas.pre:1.1
Rev: src/post_modules/GTK2/source/gnomecanvasbpath.pre:1.1
Rev: src/post_modules/GTK2/source/gnomecanvasclipgroup.pre:1.1
Rev: src/post_modules/GTK2/source/gnomecanvasellipse.pre:1.1
Rev: src/post_modules/GTK2/source/gnomecanvasgroup.pre:1.1
Rev: src/post_modules/GTK2/source/gnomecanvasitem.pre:1.1
Rev: src/post_modules/GTK2/source/gnomecanvasline.pre:1.1
Rev: src/post_modules/GTK2/source/gnomecanvaspixbuf.pre:1.1
Rev: src/post_modules/GTK2/source/gnomecanvasre.pre:1.1
Rev: src/post_modules/GTK2/source/gnomecanvasrect.pre:1.1
Rev: src/post_modules/GTK2/source/gnomecanvasrichtext.pre:1.1
Rev: src/post_modules/GTK2/source/gnomecanvasshape.pre:1.1
Rev: src/post_modules/GTK2/source/gnomecanvastext.pre:1.1
Rev: src/post_modules/GTK2/source/gnomecanvaswidget.pre:1.1
Rev: src/post_modules/GTK2/source/gnomeclient.pre:1.1
Rev: src/post_modules/GTK2/source/gnomedateedit.pre:1.1
Rev: src/post_modules/GTK2/source/gnomedruid.pre:1.1
Rev: src/post_modules/GTK2/source/gnomedruidpage.pre:1.1
Rev: src/post_modules/GTK2/source/gnomedruidpageedge.pre:1.1
Rev: src/post_modules/GTK2/source/gnomedruidpagestandard.pre:1.1
Rev: src/post_modules/GTK2/source/gnomehref.pre:1.1
Rev: src/post_modules/GTK2/source/gnomeiconentry.pre:1.1
Rev: src/post_modules/GTK2/source/gnomeiconselection.pre:1.1
Rev: src/post_modules/GTK2/source/gobject.pre:1.1
Rev: src/post_modules/GTK2/source/gtkaboutdialog.pre:1.1
Rev: src/post_modules/GTK2/source/gtkaccelgroup.pre:1.1
Rev: src/post_modules/GTK2/source/gtkaccellabel.pre:1.1
Rev: src/post_modules/GTK2/source/gtkaction.pre:1.1
Rev: src/post_modules/GTK2/source/gtkactiongroup.pre:1.1
Rev: src/post_modules/GTK2/source/gtkadjustment.pre:1.1
Rev: src/post_modules/GTK2/source/gtkalignment.pre:1.1
Rev: src/post_modules/GTK2/source/gtkarrow.pre:1.1
Rev: src/post_modules/GTK2/source/gtkaspectframe.pre:1.1
Rev: src/post_modules/GTK2/source/gtkbin.pre:1.1
Rev: src/post_modules/GTK2/source/gtkbox.pre:1.1
Rev: src/post_modules/GTK2/source/gtkbutton.pre:1.1
Rev: src/post_modules/GTK2/source/gtkbuttonbox.pre:1.1
Rev: src/post_modules/GTK2/source/gtkcalendar.pre:1.1
Rev: src/post_modules/GTK2/source/gtkcelleditable.inc:1.1
Rev: src/post_modules/GTK2/source/gtkcelllayout.inc:1.1
Rev: src/post_modules/GTK2/source/gtkcellrenderer.pre:1.1
Rev: src/post_modules/GTK2/source/gtkcellrenderercombo.pre:1.1
Rev: src/post_modules/GTK2/source/gtkcellrendererpixbuf.pre:1.1
Rev: src/post_modules/GTK2/source/gtkcellrendererprogress.pre:1.1
Rev: src/post_modules/GTK2/source/gtkcellrenderertext.pre:1.1
Rev: src/post_modules/GTK2/source/gtkcellrenderertoggle.pre:1.1
Rev: src/post_modules/GTK2/source/gtkcellview.pre:1.1
Rev: src/post_modules/GTK2/source/gtkcheckbutton.pre:1.1
Rev: src/post_modules/GTK2/source/gtkcheckmenuitem.pre:1.1
Rev: src/post_modules/GTK2/source/gtkclipboard.pre:1.1
Rev: src/post_modules/GTK2/source/gtkcolorbutton.pre:1.1
Rev: src/post_modules/GTK2/source/gtkcolorselection.pre:1.1
Rev: src/post_modules/GTK2/source/gtkcolorselectiondialog.pre:1.1
Rev: src/post_modules/GTK2/source/gtkcombo.pre:1.1
Rev: src/post_modules/GTK2/source/gtkcombobox.pre:1.1
Rev: src/post_modules/GTK2/source/gtkcomboboxentry.pre:1.1
Rev: src/post_modules/GTK2/source/gtkcontainer.pre:1.1
Rev: src/post_modules/GTK2/source/gtkdata.pre:1.1
Rev: src/post_modules/GTK2/source/gtkdialog.pre:1.1
Rev: src/post_modules/GTK2/source/gtkdrawingarea.pre:1.1
Rev: src/post_modules/GTK2/source/gtkeditable.inc:1.1
Rev: src/post_modules/GTK2/source/gtkentry.pre:1.1
Rev: src/post_modules/GTK2/source/gtkentrycompletion.pre:1.1
Rev: src/post_modules/GTK2/source/gtkeventbox.pre:1.1
Rev: src/post_modules/GTK2/source/gtkexpander.pre:1.1
Rev: src/post_modules/GTK2/source/gtkfilechooser.inc:1.1
Rev: src/post_modules/GTK2/source/gtkfilechooserbutton.pre:1.1
Rev: src/post_modules/GTK2/source/gtkfilechooserdialog.pre:1.1
Rev: src/post_modules/GTK2/source/gtkfilechooserwidget.pre:1.1
Rev: src/post_modules/GTK2/source/gtkfilefilter.pre:1.1
Rev: src/post_modules/GTK2/source/gtkfileselection.pre:1.1
Rev: src/post_modules/GTK2/source/gtkfixed.pre:1.1
Rev: src/post_modules/GTK2/source/gtkfontbutton.pre:1.1
Rev: src/post_modules/GTK2/source/gtkfontselection.pre:1.1
Rev: src/post_modules/GTK2/source/gtkfontselectiondialog.pre:1.1
Rev: src/post_modules/GTK2/source/gtkframe.pre:1.1
Rev: src/post_modules/GTK2/source/gtkhandlebox.pre:1.1
Rev: src/post_modules/GTK2/source/gtkhbox.pre:1.1
Rev: src/post_modules/GTK2/source/gtkhbuttonbox.pre:1.1
Rev: src/post_modules/GTK2/source/gtkhpaned.pre:1.1
Rev: src/post_modules/GTK2/source/gtkhscale.pre:1.1
Rev: src/post_modules/GTK2/source/gtkhscrollbar.pre:1.1
Rev: src/post_modules/GTK2/source/gtkhseparator.pre:1.1
Rev: src/post_modules/GTK2/source/gtkiconfactory.pre:1.1
Rev: src/post_modules/GTK2/source/gtkiconinfo.pre:1.1
Rev: src/post_modules/GTK2/source/gtkiconset.pre:1.1
Rev: src/post_modules/GTK2/source/gtkiconsize.pre:1.1
Rev: src/post_modules/GTK2/source/gtkiconsource.pre:1.1
Rev: src/post_modules/GTK2/source/gtkicontheme.pre:1.1
Rev: src/post_modules/GTK2/source/gtkiconview.pre:1.1
Rev: src/post_modules/GTK2/source/gtkimage.pre:1.1
Rev: src/post_modules/GTK2/source/gtkimagemenuitem.pre:1.1
Rev: src/post_modules/GTK2/source/gtkinvisible.pre:1.1
Rev: src/post_modules/GTK2/source/gtkitem.pre:1.1
Rev: src/post_modules/GTK2/source/gtklabel.pre:1.1
Rev: src/post_modules/GTK2/source/gtklayout.pre:1.1
Rev: src/post_modules/GTK2/source/gtkliststore.pre:1.1
Rev: src/post_modules/GTK2/source/gtkmenu.pre:1.1
Rev: src/post_modules/GTK2/source/gtkmenubar.pre:1.1
Rev: src/post_modules/GTK2/source/gtkmenuitem.pre:1.1
Rev: src/post_modules/GTK2/source/gtkmenushell.pre:1.1
Rev: src/post_modules/GTK2/source/gtkmenutoolbutton.pre:1.1
Rev: src/post_modules/GTK2/source/gtkmisc.pre:1.1
Rev: src/post_modules/GTK2/source/gtknotebook.pre:1.1
Rev: src/post_modules/GTK2/source/gtkobject.pre:1.1
Rev: src/post_modules/GTK2/source/gtkpaned.pre:1.1
Rev: src/post_modules/GTK2/source/gtkplug.pre:1.1
Rev: src/post_modules/GTK2/source/gtkprogress.pre:1.1
Rev: src/post_modules/GTK2/source/gtkprogressbar.pre:1.1
Rev: src/post_modules/GTK2/source/gtkradioaction.pre:1.1
Rev: src/post_modules/GTK2/source/gtkradiobutton.pre:1.1
Rev: src/post_modules/GTK2/source/gtkradiomenuitem.pre:1.1
Rev: src/post_modules/GTK2/source/gtkradiotoolbutton.pre:1.1
Rev: src/post_modules/GTK2/source/gtkrange.pre:1.1
Rev: src/post_modules/GTK2/source/gtkrcstyle.pre:1.1
Rev: src/post_modules/GTK2/source/gtkscale.pre:1.1
Rev: src/post_modules/GTK2/source/gtkscrollbar.pre:1.1
Rev: src/post_modules/GTK2/source/gtkscrolledwindow.pre:1.1
Rev: src/post_modules/GTK2/source/gtkselectiondata.pre:1.1
Rev: src/post_modules/GTK2/source/gtkseparator.pre:1.1
Rev: src/post_modules/GTK2/source/gtkseparatormenuitem.pre:1.1
Rev: src/post_modules/GTK2/source/gtkseparatortoolitem.pre:1.1
Rev: src/post_modules/GTK2/source/gtksettings.pre:1.1
Rev: src/post_modules/GTK2/source/gtksizegroup.pre:1.1
Rev: src/post_modules/GTK2/source/gtksocket.pre:1.1
Rev: src/post_modules/GTK2/source/gtkspinbutton.pre:1.1
Rev: src/post_modules/GTK2/source/gtkstatusbar.pre:1.1
Rev: src/post_modules/GTK2/source/gtkstyle.pre:1.1
Rev: src/post_modules/GTK2/source/gtktable.pre:1.1
Rev: src/post_modules/GTK2/source/gtktearoffmenuitem.pre:1.1
Rev: src/post_modules/GTK2/source/gtktextattributes.pre:1.1
Rev: src/post_modules/GTK2/source/gtktextbuffer.pre:1.1
Rev: src/post_modules/GTK2/source/gtktextchildanchor.pre:1.1
Rev: src/post_modules/GTK2/source/gtktextiter.pre:1.1
Rev: src/post_modules/GTK2/source/gtktextmark.pre:1.1
Rev: src/post_modules/GTK2/source/gtktexttag.pre:1.1
Rev: src/post_modules/GTK2/source/gtktexttagtable.pre:1.1
Rev: src/post_modules/GTK2/source/gtktextview.pre:1.1
Rev: src/post_modules/GTK2/source/gtktoggleaction.pre:1.1
Rev: src/post_modules/GTK2/source/gtktogglebutton.pre:1.1
Rev: src/post_modules/GTK2/source/gtktoggletoolbutton.pre:1.1
Rev: src/post_modules/GTK2/source/gtktoolbar.pre:1.1
Rev: src/post_modules/GTK2/source/gtktoolbutton.pre:1.1
Rev: src/post_modules/GTK2/source/gtktoolitem.pre:1.1
Rev: src/post_modules/GTK2/source/gtktooltips.pre:1.1
Rev: src/post_modules/GTK2/source/gtktreedragdest.inc:1.1
Rev: src/post_modules/GTK2/source/gtktreedragsource.inc:1.1
Rev: src/post_modules/GTK2/source/gtktreeiter.pre:1.1
Rev: src/post_modules/GTK2/source/gtktreemodel.inc:1.1
Rev: src/post_modules/GTK2/source/gtktreemodel.pre:1.1
Rev: src/post_modules/GTK2/source/gtktreepath.pre:1.1
Rev: src/post_modules/GTK2/source/gtktreerowreference.pre:1.1
Rev: src/post_modules/GTK2/source/gtktreeselection.pre:1.1
Rev: src/post_modules/GTK2/source/gtktreesortable.inc:1.1
Rev: src/post_modules/GTK2/source/gtktreestore.pre:1.1
Rev: src/post_modules/GTK2/source/gtktreeview.pre:1.1
Rev: src/post_modules/GTK2/source/gtktreeviewcolumn.pre:1.1
Rev: src/post_modules/GTK2/source/gtkuimanager.pre:1.1
Rev: src/post_modules/GTK2/source/gtkvbox.pre:1.1
Rev: src/post_modules/GTK2/source/gtkvbuttonbox.pre:1.1
Rev: src/post_modules/GTK2/source/gtkviewport.pre:1.1
Rev: src/post_modules/GTK2/source/gtkvpaned.pre:1.1
Rev: src/post_modules/GTK2/source/gtkvscale.pre:1.1
Rev: src/post_modules/GTK2/source/gtkvscrollbar.pre:1.1
Rev: src/post_modules/GTK2/source/gtkvseparator.pre:1.1
Rev: src/post_modules/GTK2/source/gtkwidget.pre:1.1
Rev: src/post_modules/GTK2/source/gtkwindow.pre:1.1
Rev: src/post_modules/GTK2/source/gtkwindowgroup.pre:1.1
Rev: src/post_modules/GTK2/source/pangoattrlist.pre:1.1
Rev: src/post_modules/GTK2/source/pangocontext.pre:1.1
Rev: src/post_modules/GTK2/source/pangofontdescription.pre:1.1
Rev: src/post_modules/GTK2/source/pangolayout.pre:1.1
Rev: src/post_modules/GTK2/source/pangolayoutiter.pre:1.1
Rev: src/post_modules/GTK2/source/pangolayoutline.pre:1.1
Rev: src/post_modules/GTK2/source/pangotabarray.pre:1.1
Rev: src/post_modules/GTK2/source/support.c:1.1

1: + require gtk24;    -  + class GTK2.IconTheme; + inherit G.Object; +  + signal changed; +  + void create(); + //! Creates a new icon theme object. Icon theme objects are used to lookup + //! an icon by name in a particular icon theme. Usually you'll want to use + //! get_default() rather than creating a new icon theme object from scratch. +  + void set_search_path(array(string) path) + //! Sets the search path for the icon theme object. When looking for an icon + //! theme, GTK2+ will search for a subdirectory of one or more of the + //! directories in path with the same name as the icon theme. (Themes from + //! multiple of the path elemets are combined to allow themes to be extended + //! by adding icons in the user's home directory.) + //! <p> + //! In addition if an icon found isn't found either in the current icon theme + //! or the default icon theme, and an image file with the right name is found + //! directly in one of the elements of path, then that image will be used for + //! the icon name. (This is a legacy feature, and new icons should be put into + //! the default icon theme, which is called DEFAULT_THEME_NAME, rather than + //! directly on the icon path.) + { +  pgtk_verify_inited(); +  { +  struct array *a; +  const gchar **path; +  int i,num; +  get_all_args("set_search_path",args,"%A",&a); +  if (a==NULL || a->size<1) +  Pike_error("Invalid array.\n"); +  path=(const gchar **)g_malloc(sizeof(const gchar *)*a->size); +  if (path==NULL) +  SIMPLE_OUT_OF_MEMORY_ERROR("set_search_path",sizeof(const gchar *)*a->size); +  for (i=num=0; i<a->size; i++) { +  if ((ITEM(a)+i)->type!=PIKE_T_STRING) +  continue; +  path[num++]=(const gchar *)STR0((ITEM(a)+i)->u.string); +  } +  gtk_icon_theme_set_search_path(GTK_ICON_THEME(THIS->obj), +  path,num); +  } +  RETURN_THIS(); + } +  + array(string) get_search_path() + //! Gets the current search path. + { +  pgtk_verify_inited(); +  my_pop_n_elems(args); +  { +  gchar **path; +  int n,i; +  gtk_icon_theme_get_search_path(GTK_ICON_THEME(THIS->obj),&path,&n); +  for (i=0; i<n; i++) +  PGTK_PUSH_GCHAR(path[i]); +  f_aggregate(n); +  g_strfreev(path); +  } + } +  + void append_search_path(string path); + //! Appends a directory to the search path. +  + void prepend_search_path(string path); + //! Prepends a directory to the search path. +  + void set_custom_theme(string theme_name); + //! Sets the name of the icon theme that the GTK2.IconTheme object uses + //! overriding system configuration. This function cannot be called on the + //! icon theme objects return from get_default(). +  + int has_icon(string icon_name); + //! Checks whether this icon theme includes an icon for a particular name. +  + GTK2.IconInfo lookup_icon(string name, int size, int flags) + //! Looks up a named icon and returns an object containing information such as + //! the filename of the icon. The icon can then be rendered into a pixbuf + //! using GTK2.IconInfo->load_icon(). + { +  pgtk_verify_inited(); +  { +  char *name; +  int size,flags; +  GtkIconInfo *gi; +  get_all_args("lookup_icon",args,"%s%i%i",&name,&size,&flags); +  gi=gtk_icon_theme_lookup_icon(GTK_ICON_THEME(THIS->obj),name,size,flags); +  my_pop_n_elems(args); +  if (gi) +  push_gobjectclass(gi,pgtk_icon_info_program); +  else +  push_int(0); +  } + } +  + GDK2.Pixbuf load_icon(string name, int size, int flags) + //! Looks up an icon in an icon theme, scales it to the given size and renders + //! it into a pixbuf. + { +  pgtk_verify_inited(); +  { +  GdkPixbuf *pixbuf; +  char *name; +  int size,flags; +  get_all_args("load_icon",args,"%s%i%i",&name,&size,&flags); +  pixbuf=gtk_icon_theme_load_icon(GTK_ICON_THEME(THIS->obj),name,size,flags,NULL); +  my_pop_n_elems(args); +  push_gobject(pixbuf); +  } + } +  + array(string) list_icons(?string context) + //! Lists the icons in the current icon theme. Only a subset of the icons can + //! be listed by providing a context string. The set of values for the + //! context string is system dependent, but will typically include such values + //! as 'apps' and 'mimetypes'. + { +  pgtk_verify_inited(); +  { +  char *context=NULL; +  GList *gl,*g2; +  int i; +  if (args) +  get_all_args("list_icons",args,"%s",&context); +  gl=g2=gtk_icon_theme_list_icons(GTK_ICON_THEME(THIS->obj),context); +  while (g2) { +  PGTK_PUSH_GCHAR(g2->data); +  g_free(g2->data); +  i++; +  g2=g_list_next(g2); +  } +  f_aggregate(i); +  g_list_free(gl); +  } + } +  + require gtk26; + array(int) get_icon_sizes(string name) + //! Returns an array of integers describing the sizes at which the icon is + //! available without scaling. A size of -1 means that the icon is available + //! in a scalable format. + { +  pgtk_verify_inited(); +  { +  char *name; +  gint *gt,*g2; +  int i=0; +  get_all_args("get_icon_sizes",args,"%s",&name); +  gt=g2=gtk_icon_theme_get_icon_sizes(GTK_ICON_THEME(THIS->obj),name); +  my_pop_n_elems(args); +  while (g2) { +  PGTK_PUSH_INT(*g2); +  g2++; +  i++; +  } +  f_aggregate(i); +  g_free(gt); +  } + } +  + endrequire; +  + string get_example_icon_name(); + //! Gets the name of an icon that is representative of the current theme (for + //! instance, to use when presenting a list of themes to the user.) +  + int rescan_if_needed(); + //! Checks to see if the icon theme has changed; if it has, any currently + //! cached information is discarded and will be reloaded next time this theme + //! is accessed. +  + endrequire;   Newline at end of file added.