qulogic/libgnt
Clone
Summary
Browse
Changes
Graph
Make the combobox a tiny bit friendlier.
v2.7.3
2010-07-05, Sadrul Habib Chowdhury
ac8d8a62c098
Make the combobox a tiny bit friendlier.
Pressing the first letter of an item will now jump to that item (and
popup the dropdown first if necessary). Add some API in libgnt in the
process.
/**
* @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 */