Nilorea Library
C utilities for networking, threading, graphics
Loading...
Searching...
No Matches
ex_gui_checkbox_label.c

n_gui checkbox relabelling

n_gui checkbox relabelling

Author
Castagnier Mickael
Version
1.0
Date
24/09/2026

A pool of checkboxes that shows the settings of whichever entry a list has selected needs to change what each box says without destroying it. n_gui_checkbox_set_label() does that and n_gui_checkbox_get_label() reads it back; neither touches a widget that is not a checkbox, and a label longer than the widget holds is cut, not overrun.

Headless: the builtin font needs no display.

#define ALLEGRO_UNSTABLE 1
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include "nilorea/n_log.h"
#include "nilorea/n_gui.h"
static int log_level = LOG_ERR;
static int failures = 0;
static void expect_true(const char* what, int ok) {
if (!ok) {
n_log(LOG_ERR, "FAIL: %s", what);
} else {
n_log(LOG_INFO, "ok: %s", what);
}
}
static int process_args(int argc, char** argv) {
int opt = 0;
while ((opt = getopt(argc, argv, "V:")) != -1) {
if (opt == 'V') {
log_level = atoi(optarg);
} else {
return -1;
}
}
return 0;
}
int main(int argc, char** argv) {
char longer[1024];
if (process_args(argc, argv) != 0) {
fprintf(stderr, "Usage: %s [-V LOG_LEVEL]\n", argv[0]);
return 2;
}
if (!al_init() || !al_init_font_addon()) {
n_log(LOG_ERR, "allegro init failed");
return 1;
}
ALLEGRO_FONT* font = al_create_builtin_font();
if (!font) return 1;
if (!gui) {
al_destroy_font(font);
return 1;
}
n_gui_set_display_size(gui, 800.0f, 600.0f);
int win = n_gui_add_window(gui, "Checkboxes", 10, 10, 300, 200);
int box = n_gui_add_checkbox(gui, win, "Amount", 10, 10, 200, 24, 1, NULL, NULL);
int button = n_gui_add_button(gui, win, "Copy", 10, 40, 80, 24, N_GUI_SHAPE_RECT, NULL, NULL);
expect_true("the checkbox says what it was made with",
n_gui_checkbox_get_label(gui, box) && strcmp(n_gui_checkbox_get_label(gui, box), "Amount") == 0);
n_gui_checkbox_set_label(gui, box, "Radius");
expect_true("relabelled, it says the new text",
strcmp(n_gui_checkbox_get_label(gui, box), "Radius") == 0);
expect_true("and keeps its state", n_gui_checkbox_is_checked(gui, box) == 1);
expect_true("a NULL label is ignored", strcmp(n_gui_checkbox_get_label(gui, box), "Radius") == 0);
memset(longer, 'x', sizeof(longer) - 1);
longer[sizeof(longer) - 1] = '\0';
expect_true("a label too long is cut, not overrun",
strlen(n_gui_checkbox_get_label(gui, box)) < sizeof(longer) - 1);
n_gui_checkbox_set_label(gui, button, "Paste");
expect_true("a button is not a checkbox: its label is left alone",
strcmp(n_gui_button_get_label(gui, button), "Copy") == 0);
expect_true("and has no checkbox label", n_gui_checkbox_get_label(gui, button) == NULL);
expect_true("an unknown widget has none", n_gui_checkbox_get_label(gui, 99999) == NULL);
/* A plain label reads back what it was given, and only a label does. */
{
int label = n_gui_add_label(gui, win, "Before", 10, 70, 200, 24, N_GUI_ALIGN_LEFT);
expect_true("a label says what it was made with",
n_gui_label_get_text(gui, label) && strcmp(n_gui_label_get_text(gui, label), "Before") == 0);
n_gui_label_set_text(gui, label, "After");
expect_true("set again, it says the new text", strcmp(n_gui_label_get_text(gui, label), "After") == 0);
expect_true("a checkbox is not a label", n_gui_label_get_text(gui, box) == NULL);
expect_true("an unknown widget has no label text", n_gui_label_get_text(gui, 99999) == NULL);
}
al_destroy_font(font);
n_log(LOG_NOTICE, "ex_gui_checkbox_label: %s", failures ? "FAILED" : "ok");
return failures ? 1 : 0;
}
void process_args(int argc, char **argv)
static int failures
Definition ex_atlas.c:51
int main(void)
Definition ex_atlas.c:117
static void expect_true(const char *label, int cond)
Definition ex_atlas.c:53
static int log_level
static N_GUI_CTX * gui
FONT * font
the default 8x8 font, valid after allegro_init()
void n_gui_set_display_size(N_GUI_CTX *ctx, float w, float h)
set the display (viewport) size so global scrollbars can be computed.
Definition n_gui.c:12348
#define N_GUI_ALIGN_LEFT
left aligned text
Definition n_gui.h:212
void n_gui_label_set_text(N_GUI_CTX *ctx, int widget_id, const char *text)
set label text content
Definition n_gui.c:6184
int n_gui_add_label(N_GUI_CTX *ctx, int window_id, const char *text, float x, float y, float w, float h, int align)
Add a static text label.
Definition n_gui.c:3639
int n_gui_add_window(N_GUI_CTX *ctx, const char *title, float x, float y, float w, float h)
Add a new pseudo-window to the context.
Definition n_gui.c:1277
N_GUI_CTX * n_gui_new_ctx(ALLEGRO_FONT *default_font)
Create a new GUI context.
Definition n_gui.c:1103
void n_gui_destroy_ctx(N_GUI_CTX **ctx)
Destroy a GUI context and all its windows/widgets.
Definition n_gui.c:1209
void n_gui_checkbox_set_label(N_GUI_CTX *ctx, int widget_id, const char *label)
Replace the text drawn beside a checkbox.
Definition n_gui.c:4261
const char * n_gui_checkbox_get_label(N_GUI_CTX *ctx, int widget_id)
What a checkbox says.
Definition n_gui.c:4276
int n_gui_checkbox_is_checked(N_GUI_CTX *ctx, int widget_id)
check if a checkbox widget is checked
Definition n_gui.c:4237
const char * n_gui_button_get_label(N_GUI_CTX *ctx, int widget_id)
What a button says.
Definition n_gui.c:2124
int n_gui_add_checkbox(N_GUI_CTX *ctx, int window_id, const char *label, float x, float y, float w, float h, int initial_checked, void(*on_toggle)(int, int, void *), void *user_data)
Add a checkbox widget.
Definition n_gui.c:3207
#define N_GUI_SHAPE_RECT
rectangle shape (default)
Definition n_gui.h:170
int n_gui_add_button(N_GUI_CTX *ctx, int window_id, const char *label, float x, float y, float w, float h, int shape, void(*on_click)(int, void *), void *user_data)
Add a button widget to a window.
Definition n_gui.c:2720
const char * n_gui_label_get_text(N_GUI_CTX *ctx, int widget_id)
What a label says now.
Definition n_gui.c:6175
The top-level GUI context that holds all windows.
Definition n_gui.h:1669
#define n_log(__LEVEL__,...)
Logging function wrapper to get line and func.
Definition n_log.h:113
#define LOG_ERR
error conditions
Definition n_log.h:100
void set_log_level(const int log_level)
Set the global log level value ( static int LOG_LEVEL ).
Definition n_log.c:123
#define LOG_NOTICE
normal but significant condition
Definition n_log.h:104
#define LOG_INFO
informational
Definition n_log.h:106
Common headers and low-level functions & define.
GUI system: buttons, sliders, text areas, checkboxes, scrollbars, dropdown menus, windows.
Generic log system.