/* Copyright 1996 Acorn Computers Ltd
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
/****************************************************************************
 * This source file was written by Acorn Computers Limited. It is part of   *
 * the RISCOS library for writing applications in C for RISC OS. It may be  *
 * used freely in the creation of programs for Archimedes. It should be     *
 * used with Acorn's C Compiler Release 3 or later.                         *
 *                                                                          *
 ***************************************************************************/

/*
 * 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.
 *
 */

void fileicon(wimp_w, wimp_i, int filetype);

#endif

/* end fileicon.h */