Agar

<-- Back to AG_Intro.3

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, 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.

SEE ALSO

AG_Intro(3), AG_Socket(3), AG_Surface(3), AG_Widget(3), AG_Window(3)

HISTORY

The AG_Icon widget first appeared in Agar 1.3.

Csoft.net ElectronTubeStore.com