Initializing and Freeing Toolbars

LEADTOOLS accesses toolbars through the TOOLBARHANDLE structure. This structure provides a working area for the toolbar functions. The toolbar handle must be initialized before calling any of the toolbar functions. This is done using the L_TBInit function. The following example shows how to initialize the toolbar handle.

pTOOLBARHANDLE pLeadToolbar ;

/* Initiate the toolbar handle */
L_TBInit ( &pLeadToolbar ) ;
…

A toolbar handle is valid only after L_TBInit and L_TBCreate have been called. The validity of the toolbar should be checked before calling any other toolbar functions. This is done using L_TBIsValid.

When the TOOLBARHANDLE structure is no longer needed, it should be freed using the L_TBFree function. The following example shows how to free a toolbar handle:

if (SUCCESS == L_TBIsValid ( pLeadToolbar ) )
{
    L_TBFree ( pLeadToolbar ) ;

    return SUCCESS ;
}
else
{
    return FAILURE ;
}

Once L_TBFree has been called, the toolbar handle is no longer valid.