ApDeleteWidget()

Remove widgets from a widget database

Synopsis:

#include <Ap.h>

int ApDeleteWidget( ApDBase_t *db,
                    char const *wgt_name );

Description:

ApDeleteWidget() is used to remove widgets from a widget database. wgt_name is the instance name of the widget to be deleted. Only a single widget is deleted with this function; if a container widget is deleted, its child widgets will remain in the database.

Returns:

0

Successful completion

-1

Failure

Examples:

ApDBase_t *my_dbase;

my_dbase = ApOpenDBaseFile( "/home/me/mydbase.wgtp" );

ApDeleteWidget( my_dbase, "my_icon" );

ApSaveDBaseFile( my_dbase, "/home/me/mydbase.wgtp" );

Classification:

Photon