LVectorLine::UnlockObject

Summary

Sets the object information of the class object.

This function is available in the LEADTOOLS Vector Imaging Toolkit.

Syntax

virtual L_INT LVectorLine::UnlockObject(pLine)

Parameters

pVECTORLINE pLine

Pointer to a VECTORLINE structure that contains the vector object information to set.

Returns

Comments

This function is used to update the object information of the class object.

To use this method, declare a variable of type VECTORLINE and pass the address to the LVectorLine::LockObject () function. After modifying the vector object settings, call LVectorLine::UnlockObject (). LVectorLine::LockObject LVectorLine::LockObject () and [LVectorLine:UnlockObject () should always be called in pairs.

Before an object has been added to the LVectorBase object, using LVectorBase::AddObject or LVectorLayer::AddObject, LVectorLine::UnlockObject () can be used to change ALL properties of an object. However, once the object has been added to the LVectorBase object, some properties cannot be changed using LVectorLine::UnlockObject (). Specifically, nPointCount, *Point, pszText, and pbyType cannot be changed. However, as long as the number of points does not change, the coordinates of the individual points can always be modified using LVectorLine::UnlockObject ().

To get the current object information for a class object, call LVectorLine::LockObject.

LVectorLine::LockObject and LVectorLine::UnlockObject must be called in pairs.

Required DLLs and Libraries

• LTVKRN
• 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

• LVectorLine::LockObject

Topics

• Working with Vector Objects

Example

For an example, refer to LVectorLayer::AddObject.