colourmenu

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