L_DispContainerRotateBitmapPerspective

#include "l_bitmap.h"

L_LTIVW_API L_INT EXT_FUNCTION L_DispContainerRotateBitmapPerspective(hCon, nCellIndex, nSubCellIndex, nAngle, 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 nAngle;

/* angle */

L_UINT uFlags;

/* reserved for future use */

Rotates the bitmap view perspective from the specified cell or sub-cell.

Parameter

Description

hCon

Handle to the container.

nCellIndex

A zero-based index of the cell, which is having its viewer perspective rotated. Pass -1 to rotate the view perspective of the image with the specific sub-cell of all cells managed by the container. Pass -2 to rotate the view perspective of the image with the specific sub-cell of the selected cells managed by the container.

nSubCellIndex

A zero-based index into the image list attached to the cell specified in nCellIndex. This image will be rotated by the specified angle. Pass -1 to rotate the view perspective of all sub-cells. Pass -2 to rotate the view perspective of the image in the selected sub-cell.

nAngle

Value that represents the rotation angle.

uFlags

Reserved for future use. Pass 0.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

To get the current rotation angle, call L_DispContainerGetRotateBitmapPerspectiveAngle.

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_DispContainerGetRotateBitmapPerspectiveAngle, L_DispContainerInvertBitmap, L_DispContainerIsBitmapInverted

Topics:

Image Viewer Cells

 

Image Viewer Functions: Image Viewer Cells

Example

For an example, refer to L_DispContainerFlipAnnotationContainer.