/****************************************************************************
 * 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: colourmenu.h
 * Purpose: create a wimp colour setting menu
 *
 */

# ifndef __colourmenu_h
# define __colourmenu_h
# ifndef __menu_h
# include "menu.h"
# endif

# ifndef BOOL
# define BOOL int
# define TRUE 1
# define FALSE 0
# endif


/* --------------------------- colourmenu_make ----------------------------
 * Description:   Creates a menu containing the 16 Wimp colours, with
 *                an optional "None" entry. Text in colour is written in
 *                black or white, depending on background.
 *
 * Parameters:    char *title      -- null-terminated string for menu title
 *                BOOL includeNone -- whether to include "None" entry
 * Returns:       On successful completion, pointer to created menu structure
 *                otherwise null.
 * Other Info:    Hits on this menu start from 1 as for other menus
 *                see menu module for details.
 */

menu colourmenu_make(char *title, BOOL includeNone);

#endif

/* end colourmenu.h */
