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.