gp_widget_grid.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_GRID_H
#define GP_WIDGET_GRID_H
 
#include <stdint.h>
 
enum gp_widget_grid_flags {
        GP_WIDGET_GRID_FRAME = 0x01,
        GP_WIDGET_GRID_UNIFORM = 0x02,
};
 
/* row/column cell sizes, offsets and fill coefs */
struct gp_widget_grid_cell {
        unsigned int size;
        unsigned int off;
        uint8_t fill;
};
 
/* row/column border padding and fill coefs */
struct gp_widget_grid_border {
        uint8_t padd;
        uint8_t fill;
};
 
struct gp_widget_grid {
        unsigned int cols, rows;
 
        unsigned int focused_col;
        unsigned int focused_row;
 
        /* if set a widget in a grid is focused */
        int focused:1;
        /* if set frame is rendered around the grid */
        int frame:1;
        /* if set the grid all columns and all rows have the same size */
        int uniform:1;
 
        /* cell column sizes offsets and fill coefs */
        struct gp_widget_grid_cell *col_s;
        /* cell row sizes offsets and fill coefs */
        struct gp_widget_grid_cell *row_s;
 
        /* column border padding and fill coefs */
        struct gp_widget_grid_border *col_b;
        /* row border padding and fill coefs */
        struct gp_widget_grid_border *row_b;
 
        gp_widget **widgets;
};
 
gp_widget *gp_widget_grid_new(unsigned int cols, unsigned int rows,
                              enum gp_widget_grid_flags flags);
 
gp_widget *gp_widget_grid_put(gp_widget *self, unsigned int col, unsigned int row,
                              gp_widget *child);
 
gp_widget *gp_widget_grid_rem(gp_widget *self, unsigned int col, unsigned int row);
 
gp_widget *gp_widget_grid_get(gp_widget *self, unsigned int col, unsigned int row);
 
static inline void gp_widget_grid_del(gp_widget *self, unsigned col, unsigned int row)
{
        gp_widget *ret = gp_widget_grid_rem(self, col, row);
 
        gp_widget_free(ret);
}
 
void gp_widget_grid_rows_ins(gp_widget *self, unsigned int row, unsigned int rows);
 
static inline void gp_widget_grid_row_ins(gp_widget *self, unsigned int row)
{
        gp_widget_grid_rows_ins(self, row, 1);
}
 
unsigned int gp_widget_grid_rows_append(gp_widget *self, unsigned int rows);
 
static inline unsigned int gp_widget_grid_row_append(gp_widget *self)
{
        return gp_widget_grid_rows_append(self, 1);
}
 
void gp_widget_grid_rows_prepend(gp_widget *self, unsigned int rows);
 
static inline void gp_widget_grid_row_prepend(gp_widget *self)
{
        return gp_widget_grid_rows_prepend(self, 1);
}
 
void gp_widget_grid_rows_del(gp_widget *self, unsigned int row, unsigned int rows);
 
static inline void gp_widget_grid_row_del(gp_widget *self, unsigned int row)
{
        gp_widget_grid_rows_del(self, row, 1);
}
 
void gp_widget_grid_cols_ins(gp_widget *self, unsigned int col, unsigned int cols);
 
static inline void gp_widget_grid_col_ins(gp_widget *self, unsigned int col)
{
        gp_widget_grid_cols_ins(self, col, 1);
}
 
unsigned int gp_widget_grid_cols_append(gp_widget *self, unsigned int cols);
 
static inline unsigned int gp_widget_grid_col_append(gp_widget *self)
{
        return gp_widget_grid_cols_append(self, 1);
}
 
void gp_widget_grid_cols_prepend(gp_widget *self, unsigned int cols);
 
static inline void gp_widget_grid_col_prepend(gp_widget *self)
{
        return gp_widget_grid_cols_prepend(self, 1);
}
 
void gp_widget_grid_cols_del(gp_widget *self, unsigned int col, unsigned int cols);
 
static inline void gp_widget_grid_col_del(gp_widget *self, unsigned int col)
{
        gp_widget_grid_cols_del(self, col, 1);
}
 
 
void gp_widget_grid_border_set(gp_widget *self, enum gp_widget_border border,
                               int padd, int fill);
 
static inline void gp_widget_grid_no_border(gp_widget *self)
{
        gp_widget_grid_border_set(self, GP_WIDGET_BORDER_ALL, 0, 0);
}
 
void gp_widget_grid_col_fill_set(gp_widget *self, unsigned int col, uint8_t fill);
 
void gp_widget_grid_row_fill_set(gp_widget *self, unsigned int row, uint8_t fill);
 
#endif /* GP_WIDGET_GRID_H */