LAnnRuler::GetPoints

#include "ltwrappr.h"

virtual L_INT LAnnRuler::GetPoints(pPoints)

pANNPOINT pPoints;

/* pointer to an array */

Fills the specified array of ANNPOINT structures with the endpoints of the ruler object.

Parameter

Description

pPoints

Pointer to the array to be filled with the endpoints of the ruler object.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

The ANNPOINT structure is like a Windows POINT structure, except that it uses double-precision floating point values.

Coordinates of an object's points are relative to its container object. The coordinates are interpreted using the container's scaling factors and offsets, which are described in Low-Level Coordinate System for Annotations.

Required DLLs and Libraries

LTANN

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:

Class Members

Topics:

Annotation Functions: Getting and Setting Geometric Properties

 

Annotation Functions: Using Window Coordinates to Define an Object

 

Key Annotation Features

 

Calibrating Annotation Ruler Objects

Example

L_INT LAnnRuler_GetPointsExample()
{
   LBitmap MyBitmap;
   LSettings::UnlockSupport(L_SUPPORT_DOCUMENT, L_KEY_DOCUMENT);
   LAnnRuler MyAnnRuler;
   ANNPOINT MyPts[2] = { 40,40,
                         140,40,
                       };
   ANNPOINT AnnPoints[2];
   pANNPOINT pMyPts = MyPts;
   MyAnnRuler.SetPoints(pMyPts, 2);
   MyAnnRuler.GetPoints(AnnPoints);
   for (int i=0; i<2; i++)
   {
      L_TCHAR szTemp[100];
      wsprintf(szTemp, TEXT("[%d]Point(%d, %d)"), i, (int)AnnPoints[i].x, (int)AnnPoints[i].y);
      AfxMessageBox(szTemp);
   }
   return SUCCESS;
}