Note: The Agar manual pages follow certain conventions, notably
concerning function return values. Please read
AG_Intro(3)
first.
SYNOPSIS
#include <agar/core.h>
#include <agar/gui.h>
|
DESCRIPTION
|
The
AG_FontSelector widget allows the user to select a font given face, size and style parameters.
Available fonts do not need to reside in memory.
AG_FontSelector binds to an
AG_Font pointer, and will load the necessary fonts on demand.
|
INHERITANCE HIERARCHY
INITIALIZATION
AG_FontSelector * AG_FontSelectorNew (AG_Widget *parent, Uint flags)
|
The
AG_FontSelectorNew() function allocates, initializes, and attaches a new
AG_FontSelector widget.
Acceptable
flags include:
| AG_FONTSELECTOR_HFILL | Expand horizontally in parent (equivalent to invoking
AG_ExpandHoriz(3)). | | AG_FONTSELECTOR_VFILL | Expand vertically in parent (equivalent to invoking
AG_ExpandVert(3)). | | AG_FONTSELECTOR_EXPAND | Shorthand for
AG_FONTSELECTOR_HFILL|AG_FONTSELECTOR_VFILL. |
|
BINDINGS
The
AG_FontSelector widget provides the following bindings:
| AG_Font **font | Pointer to an
AG_Font(3) pointer which will be modified according to the user's selection.
|
|
EVENTS
|
The
AG_FontSelector widget neither reacts to nor generates any event.
|
EXAMPLES
The following code fragment creates a new window containing a
AG_FontSelector widget:
AG_Window *win;
AG_FontSelector *fs;
AG_Font *myFont;
win = AG_WindowNew(0);
fs = AG_FontSelectorNew(win, AG_FONTSELECTOR_EXPAND);
myFont = AG_TextFontPct(150);
AG_BindPointer(fs, "font", (void **)&myFont);
AG_WindowShow(win);
|
SEE ALSO
HISTORY
|
The
AG_FontSelector widget first appeared in
Agar 1.3.4.
|