NAME

AG_FontSelector —

agar font selection widget

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

AG_Object(3) -> AG_Widget(3) -> AG_FontSelector.

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 does not generate 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);

HISTORY

The AG_FontSelector widget first appeared in Agar 1.3.4.