virtual L_INT LAnnAutomation::GetDistance(pdDistance, pdDistance2=0)
Gets the distance of the Ruler object(s) in the object's unit of measurement, set by LAnnAutomation::SetUnit.
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.
Address of the variable to be updated with the distance of the ruler object. For cross products and protractors, which have two rulers, this variable will be updated with the length of the secondary ruler.
Either pdDistance or pdDistance2 can be NULL, but not both. If either of these pointers is NULL, the distance for that ruler will not be retrieved.
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
Win32, x64.
get the current measurement unit settings and display them
if unit is not inches, make it so
L_INT LAnnAutomation_LAnnAutomation_GetDistanceExample(LAnnAutomation * pAnnObject)
{
L_INT nRet;
L_SIZE_T uLen;
L_SIZE_T uUnit;
HGLOBAL hUnitAbbrev;
L_TCHAR * pUnitAbbrev=NULL;
L_SIZE_T uPrecision;
L_TCHAR buf[180];
L_TCHAR dis[180];
L_TCHAR format[180];
L_DOUBLE dDistance;
/* first, get unit abbreviation string len */
uLen = pAnnObject->GetUnitLen();
/* allocate enough memory for the abbreviation string */
hUnitAbbrev = GlobalAlloc(GMEM_MOVEABLE, uLen*sizeof(L_TCHAR));
pUnitAbbrev = (L_TCHAR *)GlobalLock(hUnitAbbrev);
/* get the settings */
uUnit = pAnnObject->GetUnit(pUnitAbbrev, &uPrecision,NULL);
/* and, get the distance */
nRet = pAnnObject->GetDistance(&dDistance);
if(nRet != SUCCESS)
return nRet;
/* display current settings & distance in current unit of measurement */
wsprintf(buf, TEXT("Unit: %d\nAbbrev: %s\nPrecision: %d\n"),
uUnit, pUnitAbbrev, uPrecision);
wsprintf(format, TEXT("Distance: %%.%df\n"),uPrecision);
wsprintf(dis, format, dDistance);
lstrcat(buf, dis);
MessageBox(NULL, buf,TEXT( "Units"), MB_OK);
/* if unit is not inches, make it so */
if(uUnit != ANNUNIT_INCHES)
pAnnObject->SetUnit(ANNUNIT_INCHES, TEXT("in"), 2, 0);
GlobalUnlock(hUnitAbbrev);
GlobalFree(hUnitAbbrev);
return SUCCESS;
}
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document