In This Topic ▼

L_DispContainerSetBitmapHandle

Summary

Updates and overwrites the bitmap handle of a specific cell(s) or sub-cell(s).

Syntax

#include "ltivw.h"

L_LTIVW_API L_INT L_DispContainerSetBitmapHandle(hCellWnd, nSubCellIndex, pBitmap, bRepaint, uFlags)

Parameters

L_HWND hCellWnd

A handle to the window that represents the cell on which the function's effect will be applied.

L_INT nSubCellIndex

A zero-based index into the image list attached to the cell specified in nCellIndex. This sub-cell contains the image that will be updated using this function. Pass -2 to apply this effect on the selected sub-cell.

pBITMAPHANDLE pBitmap

Pointer to a bitmap handle that will be set in the specific cell or sub-cell.

L_BOOL bRepaint

Flag that indicates whether to repaint the specific sub-cell after updating the bitmap. Possible values are:

Value	Meaning
TRUE	Repaint the sub-cell after updating the bitmap.
FALSE	Do not repaint the sub-cell after updating the bitmap.

L_UINT uFlags

Reserved for future use. Pass 0.

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

If the bRepaint is passed as FALSE, the user should call the L_DispContainerRepaintCell function after calling this function to repaint the cell.

If the user has set bRepaint parameter value to TRUE, the DISPCONTAINERPAINTCALLBACK callback function will be called if it was previously set by calling the L_DispContainerSetPaintCallBack function.