gp_widget.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_H
#define GP_WIDGET_H
 
#include <stdlib.h>
#include <stdint.h>
#include <inttypes.h>
#include <stdbool.h>
#include <core/gp_debug.h>
#include <core/gp_compiler.h>
#include <utils/gp_types.h>
#include <widgets/gp_common.h>
#include <widgets/gp_widget_types.h>
#include <widgets/gp_widget_disable.h>
 
struct gp_widget {
        unsigned int type;
        unsigned int widget_class;
        gp_widget *parent;
        int (*on_event)(gp_widget_event *);
 
        void *priv;
 
        unsigned int x, y;
 
        unsigned int w, h;
 
        unsigned int min_w, min_h;
 
        unsigned int align:16;
 
        unsigned int no_shrink:1;
        unsigned int no_resize:1;
 
        unsigned int redraw:1;
        /*
         * If set there is a child widget to be repainted, the widget_ops_render()
         * function is called but the widget itself shouldn't be repainted.
         */
        unsigned int redraw_child:1;
        /*
         * Redraw whole subtree, i.e. all children and their children, etc.
         */
        unsigned int redraw_children:1;
 
        unsigned int focused:1;
 
        unsigned int resized:1;
 
        unsigned int no_events:1;
 
        unsigned int disabled:1;
 
        uint32_t event_mask;
 
        char payload_data[] GP_ALIGNED;
};
 
#define GP_WIDGET_PAYLOAD(self) (void*)((self)->payload_data)
 
enum gp_widget_type {
        GP_WIDGET_GRID,
        GP_WIDGET_TABS,
        GP_WIDGET_BUTTON,
        GP_WIDGET_CHECKBOX,
        GP_WIDGET_LABEL,
        GP_WIDGET_PROGRESSBAR,
        GP_WIDGET_SPINNER,
        GP_WIDGET_SLIDER,
        GP_WIDGET_TBOX,
        GP_WIDGET_RADIOBUTTON,
        GP_WIDGET_SPINBUTTON,
        GP_WIDGET_TABLE,
        GP_WIDGET_PIXMAP,
        GP_WIDGET_STOCK,
        GP_WIDGET_SCROLL_AREA,
        GP_WIDGET_FRAME,
        GP_WIDGET_MARKUP,
        GP_WIDGET_LAYOUT_SWITCH,
        GP_WIDGET_OVERLAY,
        GP_WIDGET_LOG,
        GP_WIDGET_GRAPH,
        GP_WIDGET_SWITCH,
        GP_WIDGET_STOCK_SWITCH,
        GP_WIDGET_ACTIVITY,
        GP_WIDGET_MAX,
};
 
enum gp_widget_class {
        GP_WIDGET_CLASS_NONE = 0,
        GP_WIDGET_CLASS_BOOL,
        GP_WIDGET_CLASS_INT,
        GP_WIDGET_CLASS_CHOICE,
        GP_WIDGET_CLASS_MAX,
};
 
const char *gp_widget_class_name(enum gp_widget_class widget_class);
 
enum gp_widget_alignment {
        GP_HCENTER = 0x01,
        GP_LEFT    = 0x02,
        GP_RIGHT   = 0x03,
        GP_HFILL   = 0x08,
 
        GP_VCENTER = 0x10,
        GP_TOP     = 0x20,
        GP_BOTTOM  = 0x30,
        GP_VFILL   = 0x80,
 
        GP_HALIGN_MASK = 0x0f,
        GP_VALIGN_MASK = 0xf0,
        GP_FILL = GP_VFILL | GP_HFILL,
 
        GP_HCENTER_WEAK = 0x00,
        GP_VCENTER_WEAK = 0x00,
};
 
gp_widget *gp_widget_new(enum gp_widget_type type,
                         enum gp_widget_class widget_class,
                         size_t payload_size);
 
#define GP_WIDGET_ASSERT(self, ret) do { \
                if (!self) {\
                        GP_BUG("NULL widget!"); \
                        return ret; \
                } \
        } while (0)
 
#define GP_WIDGET_CLASS_ASSERT(self, wclass, ret) do { \
                GP_WIDGET_ASSERT(self, ret); \
                if (self->widget_class != wclass) { \
                        GP_BUG("Invalid widget (%p) class %u != %u", \
                               self, self->widget_class, wclass); \
                        return ret; \
                } \
        } while (0)
 
#define GP_WIDGET_TYPE_ASSERT(self, wtype, ret) do { \
                GP_WIDGET_ASSERT(self, ret); \
                if (self->type != wtype) {\
                        GP_BUG("Invalid widget type %s != %s", \
                                gp_widget_type_id(self), gp_widget_type_name(wtype)); \
                        return ret; \
                } \
        } while (0)
 
void gp_widget_free(gp_widget *self);
 
void gp_widget_set_parent(gp_widget *self, gp_widget *parent);
 
int gp_widget_focus_set(gp_widget *self);
 
#include <widgets/gp_widget_event.h>
 
#endif /* GP_WIDGET_H */