LImageViewer::UpdateCellView

#include "ltwrappr.h"

L_INT LImageViewer::UpdateCellView(hWnd, nCellIndex, uFlags)

HWND hWnd;	/* handle to a window */
L_INT nCellIndex;	/* index of a cell */
L_UINT uFlags;	/* reserved for future use */

Recalculates the cell's internal values in order to update the view according to the new change made on the image.

Parameter	Description
hWnd	Handle of the window being updated. This handle can be obtained from LImageViewer::GetCellWindowHandle. If you set this parameter, nCellIndex will be ignored. If you set this parameter to NULL, you must set a valid value to nCellIndex or it will return ERROR_INV_PARAMTER.
nCellIndex	A zero-based index of the cell, which is being updated. Pass -1 to update the view of all cells managed by the container. Pass -2 to update the view of the selected cells managed by the container. If you set hWnd parameter to a value, this parameter will be ignored.
uFlags	Reserved for future use. Pass 0.

Returns

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

Comments

This function is useful when the user applies a certain effect on the cell image that causes the image dimensions to change.

This function will also repaint the cell. To repaint the cell only with recalculated internal data, use the LImageViewer::RepaintCell function.

To stop repainting while applying a series of effects without refreshing each time an effect is applied, use the function LImageViewer::BeginUpdate to stop the cell from repainting, and then use the function LImageViewer::BeginUpdate to repaint everything.

Required DLLs and Libraries

LTIVW

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:	LImageViewer::Create, LImageViewer::Destroy, LImageViewer::RepaintCell, LImageViewer::BeginUpdate, LImageViewer::EndUpdate
Topics:	Using the Image Viewer
	Window Control/Image Viewer Functions: Using the Image Viewer

Example

This example resizes the first frame of the first cell.

L_INT LImageViewer_UpdateCellViewExample(LImageViewer& ImageViewer)
{
   L_INT        nRet;
   BITMAPHANDLE Bitmap;
   LBitmap      BitmapHandle;
   nRet = ImageViewer.GetBitmapHandle( 0, 0, &Bitmap, 0);
   if (nRet != SUCCESS)
      return nRet;
   BitmapHandle.SetHandle(&Bitmap);
   BitmapHandle.Size(BitmapHandle.GetWidth() * 2, BitmapHandle.GetHeight(), SIZE_BICUBIC);
   pBITMAPHANDLE pBitmap = BitmapHandle.GetHandle();
   ImageViewer.SetBitmapHandle( 0, 0, pBitmap, TRUE, 0);
   BitmapHandle.SetHandle(0, 0);
   ImageViewer.UpdateCellView( 0, 0, 0);
   return SUCCESS;
}