item_sel_list.h

Go to the documentation of this file.

// ==================================================================== //
//                                                                      //
//   File      : item_sel_list.h                                        //
//   Purpose   : selection lists for items (ItemSelector)               //
//                                                                      //
//                                                                      //
// Coded by Ralf Westram (coder@reallysoft.de) in May 2005              //
// Copyright Department of Microbiology (Technical University Munich)   //
//                                                                      //
// Visit our web site at: http://www.arb-home.de/                       //
//                                                                      //
// ==================================================================== //

#ifndef ITEM_SEL_LIST_H
#define ITEM_SEL_LIST_H

#ifndef AW_SELECT_HXX
#include <aw_select.hxx>
#endif
#ifndef ITEMS_H
#include "items.h"
#endif
#ifndef _GLIBCXX_STRING
#include <string>
#endif

#define PSEUDO_FIELD_ANY_FIELD      "[any field]"
#define PSEUDO_FIELD_ALL_FIELDS     "[all fields]"
#define PSEUDO_FIELD_ANY_FIELD_REC  "[any recursive]"
#define PSEUDO_FIELD_ALL_FIELDS_REC "[all recursive]"

enum SelectableFields {
    SF_STANDARD  = 0,  // normal fields
    SF_PSEUDO    = 1,  // pseudo-fields (see defines above)
    SF_HIDDEN    = 2,  // fields hidden by user
    SF_ALLOW_NEW = 4,  // allow on-the-fly creation of new fields
    SF_SHOW_TYPE = 8,  // show fieldtype prefix
};


CONSTEXPR long FIELD_FILTER_STRING           = (1<<GB_STRING);
CONSTEXPR long FIELD_FILTER_STRING_WRITEABLE = (1<<GB_STRING);
CONSTEXPR long FIELD_FILTER_INT_WRITEABLE    = (1<<GB_STRING) | (1<<GB_INT);
CONSTEXPR long FIELD_FILTER_BYTE_WRITEABLE   = (1<<GB_STRING) | (1<<GB_INT) | (1<<GB_BYTE) | (1<<GB_FLOAT);
CONSTEXPR long FIELD_FILTER_FLOAT_WRITEABLE  = (1<<GB_STRING) | (1<<GB_FLOAT);

CONSTEXPR long FIELD_FILTER_STRING_READABLE = (1<<GB_BYTE)|(1<<GB_INT)|(1<<GB_FLOAT)|(1<<GB_STRING)|(1<<GB_BITS); // as supported by GB_read_as_string()

CONSTEXPR long FIELD_UNFILTERED       = -1L;                             // any field or container
CONSTEXPR long FIELD_FILTER_ANY_FIELD = (FIELD_UNFILTERED ^ (1<<GB_DB)); // no containers

CONSTEXPR long FIELD_FILTER_NDS = FIELD_FILTER_STRING_READABLE;


class Itemfield_Selection : public AW_DB_selection { // derived from a Noncopyable
    long             type_filter;
    SelectableFields field_filter;
    ItemSelector&    selector;

    bool shall_display_type(GB_TYPES key_type) const { return type_filter & (1 << key_type); }

public:
    Itemfield_Selection(AW_selection_list *sellist_,
                        GBDATA            *gb_key_data,
                        long               type_filter_,
                        SelectableFields   field_filter_,
                        ItemSelector&      selector_);

    void fill() OVERRIDE;

    ItemSelector& get_selector() const { return selector; }
    long get_type_filter() const { return type_filter; }
};

class FieldSelDef {
    std::string          awar_name;
    std::string          purpose;
    RefPtr<GBDATA>       gb_main;
    RefPtr<ItemSelector> selector; // @@@ gb_main + selector = BoundItemSel (replace?)
    long                 type_filter;
    SelectableFields     field_filter;

public:
    FieldSelDef(const char *awar_name_, GBDATA *gb_main_, ItemSelector& selector_, long type_filter_, const char *purpose_ = "field", SelectableFields field_filter_ = SF_STANDARD)
        : awar_name(awar_name_),
          purpose(purpose_),
          gb_main(gb_main_),
          selector(&selector_),
          type_filter(type_filter_),
          field_filter(field_filter_)
    {}

    const std::string& get_awarname() const { return awar_name; }
    const std::string& get_described_field() const { return purpose; }
    long get_type_filter() const { return type_filter; }
    SelectableFields get_field_filter() const { return field_filter; }
    GBDATA *get_gb_main() const { return gb_main; }
    ItemSelector& get_itemtype() const { return *selector; }

    // for internal use only:
    bool new_fields_allowed() const { return field_filter & SF_ALLOW_NEW; }
    Itemfield_Selection *build_sel(AW_selection_list *from_sellist) const;
    bool matches4reuse(const FieldSelDef& other) const;
};

enum FailIfField {
    FIF_NAME_SELECTED     = 1, // fail if 'name' field selected
    FIF_NO_FIELD_SELECTED = 2, // fail if NO_FIELD_SELECTED

    // use-cases:
    FIF_STANDARD        = FIF_NAME_SELECTED|FIF_NO_FIELD_SELECTED,
    FIF_ALLOW_NONE      = FIF_STANDARD^FIF_NO_FIELD_SELECTED,
    FIF_ALLOW_ID_CHANGE = FIF_STANDARD^FIF_NAME_SELECTED,
};

Itemfield_Selection *create_itemfield_selection_list(  AW_window *aws, const FieldSelDef& selDef, const char *at);
void                 create_itemfield_selection_button(AW_window *aws, const FieldSelDef& selDef, const char *at);
const char          *prepare_and_get_selected_itemfield(AW_root *awr, const char *awar_name, GBDATA *gb_main, const ItemSelector& itemtype, FailIfField failIf = FIF_STANDARD);
const char          *get_itemfield_type_awarname(const char *itemfield_awarname);

enum RescanMode {
    RESCAN_REFRESH  = 1, // scan database for unregistered/unused fields and update the field list
    RESCAN_SHOW_ALL = 2, // unhide all hidden fields
};

// @@@ generalize (use BoundItemSel)

void species_field_selection_list_rescan(GBDATA *gb_main, RescanMode mode);
void gene_field_selection_list_rescan   (GBDATA *gb_main, RescanMode mode);

void species_field_selection_list_unhide_all_cb(AW_window*, GBDATA *gb_main);
void species_field_selection_list_update_cb    (AW_window*, GBDATA *gb_main);

void gene_field_selection_list_unhide_all_cb(AW_window*, GBDATA *gb_main);
void gene_field_selection_list_update_cb    (AW_window*, GBDATA *gb_main);

void experiment_field_selection_list_unhide_all_cb(AW_window*, GBDATA *gb_main);
void experiment_field_selection_list_update_cb    (AW_window*, GBDATA *gb_main);

#else
#error item_sel_list.h included twice
#endif // ITEM_SEL_LIST_H