/*
 * Tcol
 *   A true-colour dialogue box thingy
 *
 * v. 1.00 24 July 1991
 *
 * © 1991-1998 Straylight
 */

/*----- Licensing note ----------------------------------------------------*
 *
 * This file is part of Straylight's Steel library.
 *
 * Steel is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2, or (at your option)
 * any later version.
 *
 * Steel is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with Steel.  If not, write to the Free Software Foundation,
 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 */

#ifndef __tcol_h
#define __tcol_h

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

typedef enum
{
  tcol_OK,               /* User clicked OK, and dbox closed */
  tcol_OK_REOPEN,        /* User clicked OK, and dbox stays open */
  tcol_CANCEL            /* Dbox closed without changes (since last OK) */
}
tcol_reason;

/*
 * A function to be called when all is said and done.
 */
typedef void (*tcol_finishhandler)(tcol_reason r,
                                   wimp_paletteword c,
                                   void *handle);

/*
 * void tcol
 * (
 *   char *editing,
 *   wimp_paletteword c,
 *   BOOL isStatic,
 *   tcol_finishhandler proc,
 *   void *handle
 *  )
 *
 * Use
 *  Creates and handles a dbox, which allows the user to input a true
 *  colour.  You must have a template called 'tcol' for this routine.
 *
 * Parameters
 *  char *editing == what we're editing (put in the little box at the top)
 *  wimp_paletteword c == the initial colour
 *  BOOL isStatic == whether the dbox is static
 *  tcol_finishhandler proc == procedure called when the user clicks OK
 *  void *handle == the jolly old handle
 */

void tcol
(
  char *editing,
  wimp_paletteword c,
  BOOL isStatic,
  tcol_finishhandler proc,
  void *handle
);

#endif