References ▼
#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;}