qulogic/libgnt

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 gntwidget.h Widget 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_WIDGET_H
#define GNT_WIDGET_H
#include <stdio.h>
#include <glib.h>
#include <ncurses.h>
#include "gntbindable.h"
#define GNT_TYPE_WIDGET (gnt_widget_get_gtype())
#define GNT_WIDGET(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), GNT_TYPE_WIDGET, GntWidget))
#define GNT_WIDGET_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass), GNT_TYPE_WIDGET, GntWidgetClass))
#define GNT_IS_WIDGET(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), GNT_TYPE_WIDGET))
#define GNT_IS_WIDGET_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), GNT_TYPE_WIDGET))
#define GNT_WIDGET_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj), GNT_TYPE_WIDGET, GntWidgetClass))
#define GNT_WIDGET_FLAGS(obj) (GNT_WIDGET(obj)->priv.flags)
#define GNT_WIDGET_SET_FLAGS(obj, flags) (GNT_WIDGET_FLAGS(obj) |= flags)
#define GNT_WIDGET_UNSET_FLAGS(obj, flags) (GNT_WIDGET_FLAGS(obj) &= ~(flags))
#define GNT_WIDGET_IS_FLAG_SET(obj, flags) (GNT_WIDGET_FLAGS(obj) & (flags))
typedef struct _GntWidget GntWidget;
typedef struct _GntWidgetPriv GntWidgetPriv;
typedef struct _GntWidgetClass GntWidgetClass;
typedef enum _GntWidgetFlags
{
GNT_WIDGET_DESTROYING = 1 << 0,
GNT_WIDGET_CAN_TAKE_FOCUS = 1 << 1,
GNT_WIDGET_MAPPED = 1 << 2,
/* XXX: Need to set the following two as properties, and setup a callback whenever these
* get chnaged. */
GNT_WIDGET_NO_BORDER = 1 << 3,
GNT_WIDGET_NO_SHADOW = 1 << 4,
GNT_WIDGET_HAS_FOCUS = 1 << 5,
GNT_WIDGET_DRAWING = 1 << 6,
GNT_WIDGET_URGENT = 1 << 7,
GNT_WIDGET_GROW_X = 1 << 8,
GNT_WIDGET_GROW_Y = 1 << 9,
GNT_WIDGET_INVISIBLE = 1 << 10,
GNT_WIDGET_TRANSIENT = 1 << 11,
GNT_WIDGET_DISABLE_ACTIONS = 1 << 12,
} GntWidgetFlags;
/* XXX: This will probably move elsewhere */
typedef enum _GntMouseEvent
{
GNT_LEFT_MOUSE_DOWN = 1,
GNT_RIGHT_MOUSE_DOWN,
GNT_MIDDLE_MOUSE_DOWN,
GNT_MOUSE_UP,
GNT_MOUSE_SCROLL_UP,
GNT_MOUSE_SCROLL_DOWN
} GntMouseEvent;
/* XXX: I'll have to ask grim what he's using this for in guifications. */
typedef enum _GntParamFlags
{
GNT_PARAM_SERIALIZABLE = 1 << G_PARAM_USER_SHIFT
} GntParamFlags;
struct _GntWidgetPriv
{
int x, y;
int width, height;
GntWidgetFlags flags;
char *name;
int minw, minh; /* Minimum size for the widget */
};
struct _GntWidget
{
GntBindable inherit;
GntWidget *parent;
GntWidgetPriv priv;
WINDOW *window;
void (*gnt_reserved1)(void);
void (*gnt_reserved2)(void);
void (*gnt_reserved3)(void);
void (*gnt_reserved4)(void);
};
struct _GntWidgetClass
{
GntBindableClass parent;
void (*map)(GntWidget *obj);
void (*show)(GntWidget *obj); /* This will call draw() and take focus (if it can take focus) */
void (*destroy)(GntWidget *obj);
void (*draw)(GntWidget *obj); /* This will draw the widget */
void (*hide)(GntWidget *obj);
void (*expose)(GntWidget *widget, int x, int y, int width, int height);
void (*gained_focus)(GntWidget *widget);
void (*lost_focus)(GntWidget *widget);
void (*size_request)(GntWidget *widget);
gboolean (*confirm_size)(GntWidget *widget, int x, int y);
void (*size_changed)(GntWidget *widget, int w, int h);
void (*set_position)(GntWidget *widget, int x, int y);
gboolean (*key_pressed)(GntWidget *widget, const char *key);
void (*activate)(GntWidget *widget);
gboolean (*clicked)(GntWidget *widget, GntMouseEvent event, int x, int y);
void (*gnt_reserved1)(void);
void (*gnt_reserved2)(void);
void (*gnt_reserved3)(void);
void (*gnt_reserved4)(void);
};
G_BEGIN_DECLS
/**
* @return GType for GntWidget.
*/
GType gnt_widget_get_gtype(void);
/**
* Destroy a widget.
* @param widget The widget to destroy.
*/
void gnt_widget_destroy(GntWidget *widget);
/**
* Show a widget. This should only be used for toplevel widgets. For the rest
* of the widgets, use #gnt_widget_draw instead.
*
* @param widget The widget to show.
*/
void gnt_widget_show(GntWidget *widget);
/**
* Draw a widget.
* @param widget The widget to draw.
*/
void gnt_widget_draw(GntWidget *widget);
/**
* @internal
* Expose part of a widget.
*/
void gnt_widget_expose(GntWidget *widget, int x, int y, int width, int height);
/**
* Hide a widget.
* @param widget The widget to hide.
*/
void gnt_widget_hide(GntWidget *widget);
/**
* Get the position of a widget.
*
* @param widget The widget.
* @param x Location to store the x-coordinate of the widget.
* @param y Location to store the y-coordinate of the widget.
*/
void gnt_widget_get_position(GntWidget *widget, int *x, int *y);
/**
* Set the position of a widget.
* @param widget The widget to reposition.
* @param x The x-coordinate of the widget.
* @param y The x-coordinate of the widget.
*/
void gnt_widget_set_position(GntWidget *widget, int x, int y);
/**
* Request a widget to calculate its desired size.
* @param widget The widget.
*/
void gnt_widget_size_request(GntWidget *widget);
/**
* Get the size of a widget.
* @param widget The widget.
* @param width Location to store the width of the widget.
* @param height Location to store the height of the widget.
*/
void gnt_widget_get_size(GntWidget *widget, int *width, int *height);
/**
* Set the size of a widget.
*
* @param widget The widget to resize.
* @param width The width of the widget.
* @param height The height of the widget.
*
* @return If the widget was resized to the new size.
*/
gboolean gnt_widget_set_size(GntWidget *widget, int width, int height);
/**
* Confirm a requested a size for a widget.
*
* @param widget The widget.
* @param width The requested width.
* @param height The requested height.
*
* @return @c TRUE if the new size was confirmed, @c FALSE otherwise.
*/
gboolean gnt_widget_confirm_size(GntWidget *widget, int width, int height);
/**
* Trigger the key-press callbacks for a widget.
*
* @param widget The widget.
* @param keys The keypress on the widget.
*
* @return @c TRUE if the key-press was handled, @c FALSE otherwise.
*/
gboolean gnt_widget_key_pressed(GntWidget *widget, const char *keys);
/**
* Trigger the 'click' callback of a widget.
*
* @param widget The widget.
* @param event The mouseevent.
* @param x The x-coordinate of the mouse.
* @param y The y-coordinate of the mouse.
*
* @return @c TRUE if the event was handled, @c FALSE otherwise.
*/
gboolean gnt_widget_clicked(GntWidget *widget, GntMouseEvent event, int x, int y);
/**
* Give or remove focus to a widget.
* @param widget The widget.
* @param set @c TRUE of focus should be given to the widget, @c FALSE if
* focus should be removed.
*
* @return @c TRUE if the focus has been changed, @c FALSE otherwise.
*/
gboolean gnt_widget_set_focus(GntWidget *widget, gboolean set);
/**
* Activate a widget. This only applies to widgets that can be activated (eg. GntButton)
* @param widget The widget to activate.
*/
void gnt_widget_activate(GntWidget *widget);
/**
* Set the name of a widget.
* @param widget The widget.
* @param name A new name for the widget.
*/
void gnt_widget_set_name(GntWidget *widget, const char *name);
/**
* Get the name of a widget.
* @param widget The widget.
* @return The name of the widget.
*/
const char *gnt_widget_get_name(GntWidget *widget);
/**
* @internal
* Use #gnt_widget_draw instead.
*/
void gnt_widget_queue_update(GntWidget *widget);
/**
* Set whether a widget can take focus or not.
*
* @param widget The widget.
* @param set @c TRUE if the widget can take focus.
*/
void gnt_widget_set_take_focus(GntWidget *widget, gboolean set);
/**
* Set the visibility of a widget.
*
* @param widget The widget.
* @param set Whether the widget is visible or not.
*/
void gnt_widget_set_visible(GntWidget *widget, gboolean set);
/**
* Check whether the widget has shadows.
*
* @param widget The widget.
*
* @return @c TRUE if the widget has shadows. This checks both the user-setting
* and whether the widget can have shadows at all.
*/
gboolean gnt_widget_has_shadow(GntWidget *widget);
G_END_DECLS
#endif /* GNT_WIDGET_H */