L_DispContainerGetRotateBitmapPerspectiveAngle

#include "l_bitmap.h"

L_LTIVW_API L_INT EXT_FUNCTION L_DispContainerGetRotateBitmapPerspectiveAngle(hCon, nCellIndex, nSubCellIndex, pnAngle, uFlags)

HDISPCONTAINER hCon;	/* handle to the container */
L_INT nCellIndex;	/* index of a cell */
L_INT nSubCellIndex;	/* index into the image list attached to the cell */
L_INT * pnAngle;	/* pointer to a variable to be updated */
L_UINT uFlags;	/* reserved for future use */

Gets the perspective rotation angle of the specified cell or sub-cell.

Parameter	Description
hCon	Handle to the container.
nCellIndex	A zero-based index of the cell that contains the sub-cell, which is having its rotation angle retrieved.
nSubCellIndex	A zero-based index into the image list attached to the cell specified in nCellIndex. The perspective rotation angle of this image will be retrieved. Pass -2 to retrieve the perspective rotation angle of the image in the selected sub-cell.
pnAngle	Address of the variable to be updated with the perspective rotation angle value.
uFlags	Reserved for future use. Pass 0.

Returns

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

Comments

To set the rotation angle of a specific cell or sub-cell, it is highly recommended to use L_DispContainerRotateBitmapPerspective instead of the standard L_RotateBitmapViewPerspective.

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.

Platforms

Windows 2000 /XP/Vista.

See Also

Functions:	L_DispContainerCreate, L_DispContainerDestroy, L_DispContainerRotateBitmapPerspective, L_DispContainerInvertBitmap, L_DispContainerIsBitmapInverted
Topics:	Image Viewer Cells
	Image Viewer Functions: Image Viewer Cells

Example