(*
 * Title:   fileicon.h
 * Purpose: general display of a file icon in a window.
 *
 *)

# ifndef __fileicon_h
# define __fileicon_h

# ifndef __wimp_h 
# include "wimp.h"
# endif

(* ------------------------------ fileicon ---------------------------------
 * Description:   Display an icon representing a file, in a given window
 *
 * Parameters:    wimp_w -- the given window's handle
 *                wimp_i -- an existing icon
 *                int filetype -- RISC OS file type (eg. 0x0ffe)
 * Returns:       void.
 * Other Info:    If you want a file icon in a dialogue box then pass that
 *                dialogue box's window handle through first parameter,
 *                    eg fileicon((wimp_w)dbox_syshandle(d),........)
 *                The second parameter is the icon number of the required
 *                icon, within the template set up using FormEd
 *                For an example see the fileInfo template for !Edit.
 *
 *) 
procedure fileicon(w : wimp_w; i : wimp_i; filetype : integer); extern;

#endif

(* end fileicon.h *)
