#include "LtCon.h"
L_LTCON_API L_INT L_ContainerSetObjectCursor (pContainer, nObjectType, hCursor)
Sets the cursor for the container object.
Pointer to a container handle.
An integer that represents the object type for which to set the cursor. Possible values are:
Value | Meaning |
---|---|
CONTAINER_OBJECT_TYPE_POINT | Point object |
CONTAINER_OBJECT_TYPE_LINE | Line object |
CONTAINER_OBJECT_TYPE_SQUARE. | Square object |
CONTAINER_OBJECT_TYPE_RECT | Rectangular object |
CONTAINER_OBJECT_TYPE_ELLIPSE | Elliptical object |
CONTAINER_OBJECT_TYPE_CIRCLE | Circular object |
CONTAINER_OBJECT_TYPE_POLYLINE | Polyline object |
CONTAINER_OBJECT_TYPE_BEZIER | Bezier curve object |
CONTAINER_OBJECT_TYPE_ARC | Arc object |
CONTAINER_OBJECT_TYPE_TEXT | Text object |
The new object cursor.
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
The cursor set by this function will be shown every time that specific object type is drawn in the container. For example, if a rectangle is being drawn in the container, the cursor set for object type CONTAINER_OBJECT_TYPE_RECT will be displayed. The container makes a copy of the cursor. Therefore, the user can delete a specific cursor.
Required DLLs and Libraries
This example shows how to set some container object cursor.
L_INT ContainerSetObjectCursorExample(HWND hWnd, pCONTAINERHANDLE * ppContainer)
{
L_INT nRet;
CONTAINERMETRICS Metrics ;
/* Initiate the container handle */
nRet = L_ContainerInit ( ppContainer ) ;
if(nRet != SUCCESS)
return nRet;
/* Create the container and attach it to its owner window */
nRet = L_ContainerCreate ( *ppContainer, hWnd ) ;
if(nRet != SUCCESS)
return nRet;
nRet = L_ContainerIsValid ( *ppContainer );
if (SUCCESS == nRet ) /* check the validity of the container handle */
{
HCURSOR hRectCursor ;
/* Load some cursor */
hRectCursor = LoadCursor ( NULL, IDC_CROSS ) ;
/* Set the rectangle object cursor */
nRet = L_ContainerSetObjectCursor ( *ppContainer, CONTAINER_OBJECT_TYPE_RECT, hRectCursor ) ;
if(nRet != SUCCESS)
return nRet;
/* Destroy the cursor, because its not needed any more */
DestroyCursor ( hRectCursor ) ;
/* Set the container object type to rectangle */
nRet = L_ContainerSetObjectType ( *ppContainer, CONTAINER_OBJECT_TYPE_RECT ) ;
if(nRet != SUCCESS)
return nRet;
/* Initiate the container metrics */
Metrics.nSize = sizeof ( CONTAINERMETRICS ) ;
Metrics.dwMask = CMF_LIMITS ;
/* Set the container limits to some value */
SetRect ( &Metrics.rcLimits, 0, 0, 500, 500 ) ;
/* Set the container metrics */
nRet = L_ContainerSetMetrics ( *ppContainer, &Metrics ) ;
}
return nRet;
}