SYNOPSIS

#include <agar/core.h>
#include <agar/gui.h>

DESCRIPTION

The AG_Icon widget is a simple icon suitable for drag-and-drop. It is commonly used with AG_Socket(3).

INHERITANCE HIERARCHY

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

INITIALIZATION

AG_Icon * AG_IconNew (void *parent, Uint flags)

AG_Icon * AG_IconFromSurface (AG_Surface *s)

AG_Icon * AG_IconFromBMP (const char *filename)

void AG_IconSetPadding (AG_Icon *icon, int left, int right, int top, int bottom)

void AG_IconSetSurface (AG_Icon *icon, AG_Surface *s)

void AG_IconSetSurfaceNODUP (AG_Icon *icon, AG_Surface *s)

void AG_IconSetText (AG_Icon *icon, const char *format, ...)

void AG_IconSetTextS (AG_Icon *icon, const char *label)

void AG_IconSetBackgroundFill (AG_Icon *icon, int enable, const AG_Color *c)

The AG_IconNew() function allocates, initializes, and attaches a new AG_Icon widget without any associated surface. There are currently no flags options defined.

The AG_IconFromSurface() variant also assigns a surface s, and AG_IconFromBMP() loads the surface from a bitmap file.

AG_IconSetPadding() sets the padding around the surface in pixels.

AG_IconSetSurface() changes the surface associated with an icon. The AG_IconSetSurfaceNODUP() variant does not create a copy of the surface.

AG_IconSetText() arranges for the specified text string to be displayed under the icon.

AG_IconSetBackgroundFill() enables or disables background color fill.

EVENTS

The AG_Icon widget does not generate any event.

EXAMPLES

See tests/sockets.c in the Agar source distribution.

HISTORY

The AG_Icon widget first appeared in Agar 1.3.4.