L_TBSetButtonInfo

#include "ltTLB.h"

L_LTTLB_API L_INT L_TBSetButtonInfo( pToolbar, uButtonId, pButtonInfo )

pTOOLBARHANDLE pToolbar;

/* pointer to a handle */

L_UINT uButtonId;

/* button Id */

const pLBUTTONINFO pButtonInfo;

/* pointer to a structure */

Sets the information for the specified toolbar button.

Parameter

Description

pToolbar

Pointer to a toolbar handle.

uButtonId

Identifier that indicates the button for which to set the specified information.

pButtonInfo

Pointer to LBUTTONINFO structure that contains the button information to set.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes

Comments

To get the current information for a toolbar button calls L_TBGetButtonInfo.

Required DLLs and Libraries

LTTLB

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

L_TBAddButton, L_TBRemoveButton, L_TBGetButtonInfo, L_TBGetToolbarInfo, L_TBSetToolbarInfo.

Topics:

Getting and Setting Toolbar Button Information

Example

This example will change the bitmap image of the given toolbar button.

 L_INT TBSetButtonInfoExample( pTOOLBARHANDLE pToolbar,
                                             L_UINT uButtonId,
                                             HBITMAP hBitmap )
{
   L_INT nRet;
   LBUTTONINFO ButtonInfo;
   
   /* get button info */
   ZeroMemory(&ButtonInfo, sizeof(LBUTTONINFO) );
   nRet = L_TBGetButtonInfo ( pToolbar, uButtonId, &ButtonInfo, sizeof(LBUTTONINFO) );
   if(nRet != SUCCESS)
      return nRet;

   /* set new bitmap image */
   ButtonInfo.hBitmap = hBitmap;

   /* set new button info */
   nRet = L_TBSetButtonInfo( pToolbar, uButtonId, &ButtonInfo );
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}