LAnnRuler::GetDistance

#include "ltwrappr.h"

virtual L_INT LAnnRuler::GetDistance(pdDistance)

L_DOUBLE *pdDistance;

/* address of the variable that will be updated with the distance of a ruler object */

Gets the distance of the annotation object in the object's unit of measurement, set by LAnnRuler::SetUnit.

Parameter

Description

pdDistance

Address of the variable to be updated with the distance of the ruler object. For objects having only one ruler, this variable will be updated with the length. For cross products, which have two rulers, this variable will be updated with the length of the primary ruler.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

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, LAnnAutomation::GetTicMarkLength, LAnnAutomation::SetTicMarkLength

Topics:

Annotation Functions: Working with the Toolbar

 

Implementing Annotations

 

Automated User Interface for Annotations

 

Using Rulers in Annotation Objects

Example

L_INT LAnnRuler_GetDistanceExample(HWND hWnd)
{
   LBitmap MyBitmap;
   RECT rect;
   LSettings::UnlockSupport(L_SUPPORT_DOCUMENT, L_KEY_DOCUMENT);
   LAnnRuler MyAnnRuler;
   ANNPOINT MyPts[2] = { 40,40,
                         140,40,
                       };
   pANNPOINT pMyPts = MyPts;
   MyAnnRuler.SetPoints(pMyPts, 2);
   L_UINT uShowFlags;
   MyAnnRuler.GetShowFlags(&uShowFlags);
   MyAnnRuler.SetShowFlags(ANNSHOW_LENGTH,0);
   //Set Ruler properties
   MyAnnRuler.SetVisible(TRUE);
   MyAnnRuler.GetBoundingRect(&rect);
   L_DOUBLE dDist=0;
   MyAnnRuler.GetDistance(&dDist);
   //Draw the annotation
   HDC hDC = ::GetDC(hWnd);
   MyAnnRuler.Draw(hDC,&rect);
   ::ReleaseDC(hWnd, hDC); 
   return SUCCESS;
}