LContainer::SetObjectCursor

#include "Ltwrappr.h"

L_INT LContainer::SetObjectCursor (nObjectType, hCursor)

CONTAINEROBJECTTYPE nObjectType;

container object type

HCURSOR hCursor;

handle to a windows cursor

Sets the container object cursor.

Parameter Description
nObjectType 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
hCursor The new object cursor.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

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

LTCON

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:

LContainer::GetObjectCursor.

Topics:

Using Container Objects

Example

This example shows how to set some container object cursor.

L_INT LContainer_SetObjectCursorExample( HWND hWnd, LContainer & lcont) 
{ 
   L_INT nRet; 
   CONTAINERMETRICS Metrics ; 
   /* Initiate the container handle */ 
   nRet = lcont.Initialize () ; 
   if(nRet != SUCCESS) 
      return nRet; 
   /* Create the container and attach it to its owner window */ 
   nRet = lcont.Create (hWnd ) ; 
   if(nRet != SUCCESS) 
      return nRet; 
   nRet = lcont.IsValid ( ); 
   if ( nRet == SUCCESS ) /* check the validity of the container handle */ 
   { 
      HCURSOR hRectCursor ; 
      /* Load some cursor */ 
      hRectCursor = LoadCursor ( NULL, IDC_CROSS ) ; 
      /* Set the rectangle object cursor */ 
      nRet = lcont.SetObjectCursor (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 = lcont.SetObjectType (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 = lcont.SetMetrics (&Metrics ) ; 
      if(nRet != SUCCESS) 
         return nRet; 
   } 
   else 
   { 
      return nRet ; 
   } 
   return SUCCESS ; 
} 

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Container and Automation C++ Class Library Help