/usr/include/gnt/gntbox.h is in finch-dev 1:2.10.9-0ubuntu3.4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 | /**
* @file gntbox.h Box API
* @ingroup gnt
*/
/*
* GNT - The GLib Ncurses Toolkit
*
* GNT is the legal property of its developers, whose names are too numerous
* to list here. Please refer to the COPYRIGHT file distributed with this
* source distribution.
*
* This library is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA
*/
#ifndef GNT_BOX_H
#define GNT_BOX_H
#include "gnt.h"
#include "gntwidget.h"
#define GNT_TYPE_BOX (gnt_box_get_gtype())
#define GNT_BOX(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), GNT_TYPE_BOX, GntBox))
#define GNT_BOX_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass), GNT_TYPE_BOX, GntBoxClass))
#define GNT_IS_BOX(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), GNT_TYPE_BOX))
#define GNT_IS_BOX_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), GNT_TYPE_BOX))
#define GNT_BOX_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj), GNT_TYPE_BOX, GntBoxClass))
typedef struct _GntBox GntBox;
typedef struct _GntBoxClass GntBoxClass;
typedef enum
{
/* These for vertical boxes */
GNT_ALIGN_LEFT,
GNT_ALIGN_RIGHT,
GNT_ALIGN_MID,
/* These for horizontal boxes */
GNT_ALIGN_TOP,
GNT_ALIGN_BOTTOM
} GntAlignment;
struct _GntBox
{
GntWidget parent;
gboolean vertical;
gboolean homogeneous;
gboolean fill;
GList *list; /* List of widgets */
GntWidget *active;
int pad; /* Number of spaces to use between widgets */
GntAlignment alignment; /* How are the widgets going to be aligned? */
char *title;
GList *focus; /* List of widgets to cycle focus (only valid for parent boxes) */
void (*gnt_reserved1)(void);
void (*gnt_reserved2)(void);
void (*gnt_reserved3)(void);
void (*gnt_reserved4)(void);
};
struct _GntBoxClass
{
GntWidgetClass parent;
void (*gnt_reserved1)(void);
void (*gnt_reserved2)(void);
void (*gnt_reserved3)(void);
void (*gnt_reserved4)(void);
};
G_BEGIN_DECLS
/**
* The GType for GntBox.
* @return The GType.
*/
GType gnt_box_get_gtype(void);
#define gnt_vbox_new(homo) gnt_box_new(homo, TRUE)
#define gnt_hbox_new(homo) gnt_box_new(homo, FALSE)
/**
* Create a new GntBox.
*
* @param homo If @c TRUE, all the widgets in it will have the same width (or height)
* @param vert Whether the widgets in it should be stacked vertically (if @c TRUE)
* or horizontally (if @c FALSE).
*
* @return The new GntBox.
*/
GntWidget * gnt_box_new(gboolean homo, gboolean vert);
/**
* Add a widget in the box.
*
* @param box The box
* @param widget The widget to add
*/
void gnt_box_add_widget(GntBox *box, GntWidget *widget);
/**
* Set a title for the box.
*
* @param box The box
* @param title The title to set
*/
void gnt_box_set_title(GntBox *box, const char *title);
/**
* Set the padding to use between the widgets in the box.
*
* @param box The box
* @param pad The padding to use
*/
void gnt_box_set_pad(GntBox *box, int pad);
/**
* Set whether it's a toplevel box (ie, a window) or not. If a box is toplevel,
* then it will show borders, the title (if set) and shadow (if enabled in
* @e .gntrc)
*
* @param box The box
* @param set @c TRUE if it's a toplevel box, @c FALSE otherwise.
*/
void gnt_box_set_toplevel(GntBox *box, gboolean set);
/**
* Reposition and refresh the widgets in the box.
*
* @param box The box
*/
void gnt_box_sync_children(GntBox *box);
/**
* Set the alignment for the widgets in the box.
*
* @param box The box
* @param alignment The alignment to use
*/
void gnt_box_set_alignment(GntBox *box, GntAlignment alignment);
/**
* Remove a widget from the box. Calling this does NOT destroy the removed widget.
*
* @param box The box
* @param widget The widget to remove
*/
void gnt_box_remove(GntBox *box, GntWidget *widget);
/**
* Remove all widgets from the box. This DOES destroy all widgets in the box.
*
* @param box The box
*/
void gnt_box_remove_all(GntBox *box);
/**
* Readjust the size of each child widget, reposition the child widgets and
* recalculate the size of the box.
*
* @param box The box
*/
void gnt_box_readjust(GntBox *box);
/**
* Set whether the widgets in the box should fill the empty spaces.
*
* @param box The box
* @param fill Whether the child widgets should fill the empty space
*/
void gnt_box_set_fill(GntBox *box, gboolean fill);
/**
* Move the focus from one widget to the other.
*
* @param box The box
* @param dir The direction. If it's 1, then the focus is moved forwards, if it's
* -1, the focus is moved backwards.
*/
void gnt_box_move_focus(GntBox *box, int dir);
/**
* Give focus to a specific child widget.
*
* @param box The box
* @param widget The child widget to give focus
*/
void gnt_box_give_focus_to_child(GntBox *box, GntWidget *widget);
G_END_DECLS
#endif /* GNT_BOX_H */
|