recncell.h

/********************************************************************\
 * recncell.h -- reconcile checkbox cell                            *
 *                                                                  *
 * This program 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 of   *
 * the License, or (at your option) any later version.              *
 *                                                                  *
 * This program 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 this program; if not, contact:                        *
 *                                                                  *
 * Free Software Foundation           Voice:  +1-617-542-5942       *
 * 51 Franklin Street, Fifth Floor    Fax:    +1-617-542-2652       *
 * Boston, MA  02110-1301,  USA       gnu@gnu.org                   *
 *                                                                  *
\********************************************************************/

/*
 * FILE:
 * recncell.h
 *
 * FUNCTION:
 * The RecnCell object implements a cell handler
 * that will cycle through a series of single-character
 * values when clicked upon by the mouse.
 *
 * HISTORY:
 * Copyright (c) 1998 Linas Vepstas
 * Copyright (c) 2000 Dave Peticolas
 * Copyright (c) 2001 Derek Atkins
 */

#ifndef RECN_CELL_H
#define RECN_CELL_H

#include <glib.h>

#include "basiccell.h"

typedef const char * (*RecnCellStringGetter) (char flag);
typedef gboolean (*RecnCellConfirm) (char old_flag, gpointer data);

typedef struct
{
    BasicCell cell;

    char flag; /* The actual flag value */

    char * valid_flags;         /* The list of valid flags */
    char * flag_order;          /* Automatic flag selection order */
    char        default_flag;           /* Default flag for unknown user input */

    RecnCellStringGetter get_string;
    RecnCellConfirm confirm_cb;
    gpointer confirm_data;
} RecnCell;

BasicCell * gnc_recn_cell_new (void);

void        gnc_recn_cell_set_flag (RecnCell *cell, char flag);
char        gnc_recn_cell_get_flag (RecnCell *cell);

void        gnc_recn_cell_set_confirm_cb (RecnCell *cell,
        RecnCellConfirm confirm_cb,
        gpointer data);

void        gnc_recn_cell_set_string_getter (RecnCell *cell,
        RecnCellStringGetter getter);

/*
 * note that chars is copied into the RecnCell directly, but remains
 * the "property" of the caller.  The caller must maintain the chars
 * pointer, and the caller must setup a mechanism to 'free' the chars
 * pointer.  The rationale is that you may have many RecnCell objects
 * that use the same set of flags -- this saves you an alloc/free for
 * each cell.  - warlord  2001-11-28
 */
void        gnc_recn_cell_set_valid_flags (RecnCell *cell, const char *flags,
        char default_flag);
void        gnc_recn_cell_set_flag_order (RecnCell *cell, const char *flags);

#endif