n_gui_grid.h

Go to the documentation of this file.

/*
 * Nilorea Library
 * Copyright (C) 2005-2026 Castagnier Mickael
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
 * implied. See the License for the specific language governing
 * permissions and limitations under the License.
 *
 * SPDX-License-Identifier: Apache-2.0
 */

 
#ifndef __NILOREA_GUI_GRID__
#define __NILOREA_GUI_GRID__
 
/* Allegro only: the grid is N_GUI widgets. */
#ifdef HAVE_ALLEGRO
 
#ifdef __cplusplus
extern "C" {
#endif

 
#include <stddef.h>
 
#include "nilorea/n_gui.h"

typedef struct N_GUI_GRID_CALLBACKS {
    void (*draw_cell)(int widget_id, size_t index, float x, float y, float w, float h, void* user_data);
    void (*draw_background)(int widget_id, float x, float y, float w, float h, void* user_data);
    void (*visible)(int widget_id, size_t first, size_t last, void* user_data);
    void (*press)(int widget_id, size_t index, int button, float x, float y, void* user_data);
    int (*wheel)(int widget_id, int dz, int modifiers, void* user_data);
} N_GUI_GRID_CALLBACKS;

int n_gui_grid_new(N_GUI_CTX* ctx, int window_id, const N_GUI_GRID_CALLBACKS* callbacks, void* user_data);

void n_gui_grid_set_rect(N_GUI_CTX* ctx, int widget_id, float x, float y, float w, float h, float bar_w);

void n_gui_grid_set_cell_size(N_GUI_CTX* ctx, int widget_id, float cell_w, float cell_h, float gap);

void n_gui_grid_set_count(N_GUI_CTX* ctx, int widget_id, size_t count);

void n_gui_grid_set_visible(N_GUI_CTX* ctx, int widget_id, int visible);

int n_gui_grid_columns(N_GUI_CTX* ctx, int widget_id);

float n_gui_grid_get_scroll(N_GUI_CTX* ctx, int widget_id);

void n_gui_grid_set_scroll(N_GUI_CTX* ctx, int widget_id, float scroll);

void n_gui_grid_scroll_to(N_GUI_CTX* ctx, int widget_id, size_t index);

int n_gui_grid_index_at(N_GUI_CTX* ctx, int widget_id, float x, float y, size_t* index);

int n_gui_grid_cell_rect(N_GUI_CTX* ctx, int widget_id, size_t index, float* x, float* y, float* w, float* h);

int n_gui_grid_scrollbar(N_GUI_CTX* ctx, int widget_id);

int n_gui_grid_scrollbar_showing(N_GUI_CTX* ctx, int widget_id);

 
#ifdef __cplusplus
}
#endif
#endif /* HAVE_ALLEGRO */
#endif /* __NILOREA_GUI_GRID__ */