gp_widget_class_choice.h

Go to the documentation of this file.

//SPDX-License-Identifier: LGPL-2.0-or-later
 
/*
 
   Copyright (c) 2014-2024 Cyril Hrubis <metan@ucw.cz>
 
 */
 
#ifndef GP_WIDGET_CLASS_CHOICE_H
#define GP_WIDGET_CLASS_CHOICE_H
 
enum gp_widget_choice_op {
        GP_WIDGET_CHOICE_OP_SEL,
        GP_WIDGET_CHOICE_OP_CNT,
};
 
typedef struct gp_widget_choice_ops {
        const char *(*get_choice)(gp_widget *self, size_t idx);
        size_t (*get)(gp_widget *self, enum gp_widget_choice_op op);
        void (*set)(gp_widget *self, size_t sel);
} gp_widget_choice_ops;
 
typedef struct gp_widget_choice_arr {
        const void *ptr;
        size_t memb_cnt;
        uint16_t memb_size;
        uint16_t memb_off;
} gp_widget_choice_arr;
 
extern const gp_widget_choice_ops gp_widget_choice_arr_ops;
 
typedef struct gp_widget_choice_desc {
        const gp_widget_choice_ops *ops;
        union {
                void *ops_priv;
                const char *const *choices;
                gp_widget_choice_arr *arr;
        };
} gp_widget_choice_desc;
 
enum gp_widget_choice_flags {
        GP_WIDGET_CHOICE_COPY = 1,
};
 
struct gp_widget_choice {
        /* The actual widget data getters/setters */
        const struct gp_widget_choice_ops *ops;
 
        /*
         * Optional storage for cnt and sel, can be utilized by the
         * setters/getters from ops.
         */
        size_t cnt;
        size_t sel;
 
        /* Previously selected choice can be queried in the widget callback */
        size_t prev_sel;
 
        /* Pointer to a widget data */
        union {
                void *ops_priv;
                char **choices;
                struct gp_widget_choice_arr *arr;
        };
 
        char payload[];
};
 
gp_widget *gp_widget_choice_new(enum gp_widget_type widget_type,
                                const char *choices[],
                                size_t cnt, size_t sel);
 
gp_widget *gp_widget_choice_ops_new(enum gp_widget_type widget_type,
                                    const struct gp_widget_choice_ops *ops);
 
 
gp_widget *gp_widget_choice_arr_new(enum gp_widget_type widget_type,
                                    const void *array,
                                    size_t memb_cnt, uint16_t memb_size,
                                    uint16_t memb_off, size_t sel,
                                    enum gp_widget_choice_flags flags);
 
 
void gp_widget_choice_refresh(gp_widget *self);
 
size_t gp_widget_choice_cnt_get(gp_widget *self);
 
void gp_widget_choice_sel_set(gp_widget *self, size_t sel);
 
size_t gp_widget_choice_sel_get(gp_widget *self);
 
size_t gp_widget_choice_prev_sel_get(gp_widget *self);
 
const char *gp_widget_choice_name_get(gp_widget *self, size_t idx);
 
static inline const char *gp_widget_choice_sel_name_get(gp_widget *self)
{
        return gp_widget_choice_name_get(self, gp_widget_choice_sel_get(self));
}
 
gp_widget *gp_widget_choice_from_json(enum gp_widget_type widget_type,
                                      gp_json_reader *json, gp_json_val *val,
                                      gp_widget_json_ctx *ctx);
 
#endif /* GP_WIDGET_CLASS_CHOICE_H */