L_AnnDefine2

#include "l_bitmap.h"

L_INT EXT_FUNCTION L_AnnDefine2(hObject, apt, uState)

Specifies the shape when creating or transforming an annotation object. This function specifies one point in the current window each time it is called. This function is available in the Document/Medical Toolkits.

Returns

Comments

This function is used only with the following states:

ANNDEFINE_SETANCHORPOINT

ANNDEFINE_BEGINMOVEPOINT

If you try to use a uState value other than ANNDEFINE_SETANCHORPOINT or ANNDEFINE_BEGINMOVEPOINT, the function returns ERROR_INV_PARAMETER.

This function is similar to L_AnnDefine, except that L_AnnDefine2 takes a point in container coordinates, whereas L_AnnDefine takes a point in client coordinates.

Use this function when additional accuracy is required when setting an anchor point, or doing a simultaneous rotate and resize. This function should be used in conjunction with L_AnnDefine.

As an example, suppose you want to rotate and resize the rectangle around the anchor point aptAnchor by moving the point aptMove, as shown in the following figure:

This can be done by using only L_AnnDefine, but because L_AnnDefine takes integral arguments and aptAnchor and aptMove are not integral, the rotate and resize will not be exact.

To solve this and accurately perform simultaneous rotation and resizing, use L_AnnDefine2 and L_AnnDefine as follows:

ANNPOINT aptAnchor; 
ANNPOINT aptMove;
aptMove.x = 10.2;
aptMove.y = 10.5
aptAnchor.x = 10.2;
aptAnchor.y = 50.5
ptLocation.x = 10;
ptLocation.y = 20;
L_AnnDefine2(hObject,  &aptAnchor, ANNDEFINE_SETANCHORPOINT);
L_AnnDefine2(hObject,  &aptMove, ANNDEFINE_BEGINROTATE);
// One or more ANNDEFINE_APPEND
L_AnnDefine(pData->hObjectChange, &pMousePos->pt, ANNDEFINE_APPEND); 
L_AnnDefine(pData->hObjectChange, &pMousePos->pt, ANNDEFINE_END); 

Required DLLs and Libraries

Platforms

Windows 95 / 98 / Me, Windows 2000 / XP.

See Also

Example

// This example uses static variables to simulate user input to 
// rotate/resize a rectangle around a point on the bottom center line of the rectangle 
// Intially the rectangle must not be rotated.
void ExampleAnnDefine2(HANNOBJECT hRect)
{
   // Counter for simulating user input
   static int nCallCount = 0;  
   L_UINT uType;
   ANNRECT arcRect;
   ANNPOINT aptAnchor;  // Anchor point in container coordinates
   ANNPOINT aptMove;    // Move point in container coordinates
   POINT    ptMove;     // Move point in client coordinates
   L_DOUBLE dAngle;
   HANNOBJECT hContainer;

   L_AnnGetType(hRect, &uType);
   if (uType != ANNOBJECT_RECT)
   {
      MessageBox(NULL, TEXT("Object must be a rectangle."), TEXT("Error"), MB_OK);
      return;
   }

   L_AnnGetRotateAngle(hRect, &dAngle);
   if (dAngle != 0)
   {
      MessageBox(NULL, TEXT("Object must not be rotated."), TEXT("Error"), MB_OK);
      return;
   }
   ++nCallCount;
   switch (nCallCount)
   {
   case 1:
      L_AnnGetRect(hRect, &arcRect, NULL);
      aptAnchor.x = (arcRect.left + arcRect.right) / 2;
      aptAnchor.y = arcRect.bottom;

      aptMove.x = (arcRect.left + arcRect.right) / 2;
      aptMove.y = arcRect.top;

      L_AnnDefine2(hRect, &aptAnchor, ANNDEFINE_SETANCHORPOINT);
      L_AnnDefine2(hRect, &aptMove, ANNDEFINE_BEGINMOVEPOINT);
      MessageBox(NULL, TEXT("Call ExampleAnnDefine2 to complete the rotate/resize."), TEXT(""), MB_OK);
      break;

   case 2:
      L_AnnGetRect(hRect, &arcRect, NULL);
      aptMove.x = arcRect.right;
      aptMove.y = arcRect.top;

      L_AnnGetTopContainer(hRect, &hContainer);
      L_AnnConvert(hContainer, &ptMove, &aptMove, 1, ANNCONVERT_TO_CLIENT);

      L_AnnDefine(hRect, &ptMove, ANNDEFINE_END);
      nCallCount = 0;
      MessageBox(NULL, TEXT("Rotate/resize finished!"), TEXT(""), MB_OK);
      break;
   }
   return;
}