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: |
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; }