gandi_panel(3) - Linux man page

Name

These routines work with ncurses' panels.

Synopsis

#include <gandi_core.h>

void GANDI_appwidget_panel(void *w, int(* app)(PANEL *a));

void GANDI_appwidgets_panel(void *w, int(* app)(PANEL *a));

void GANDI_del_panel(PANEL *p);

PANEL *GANDI_make_stndrpan (int nlines, int ncols, int by, int bx, attr_t attr, short pair);

Description

You can find the introduction to panels on panel(3CURSES).

void GANDI_appwidget_panel (void w, int( app)(PANEL *a));

Applies app to each panel of w.

E.g. specify hide_panel(3CURSES) as the second argument and the w will be hidden. This is a low-level function, do not use it.

void GANDI_appwidgets_panel (void w, int( app)(PANEL *a));

The same as GANDI_appwidget_panel but applies app to all panels of each child and further.

void GANDI_del_panel (PANEL *p);

Removes panel with del_panel(3CURSES) and its associated window with delwin(3NCURSES).

PANEL *GANDI_make_stndrpan (int nlines, int ncols, int by, int bx, attr_t attr, short pair);

Creates a panel of the specified size, position and attributes.

Firstly, it creates a ncurses' window with newwin(3NCURSES). Then it standartize this window with GANDI_stndrwin (see gandi_stndr(3gandi)) and applies the specified attributes to it. Finally, the panel is created and associated with the window. If all this was OK, the resulting panel is returned, and NULL otherwise.

Notes

You have to have deal with panels only when you create widgets, because GANDI works with widgets and not with panels or windows. The work with these ncurses' objects is neatly hidden from programer.