LVectorBase::IsLocked

#include "ltwrappr.h"

virtual L_INT LVectorBase::IsLocked(pbLocked)

L_BOOL * pbLocked;

/* pointer to a variable to be updated */

Determines whether or not the class object's associated vector is locked.

Parameter

Description

pbLocked

Pointer to a variable to be updated with a value that indicates whether the class object's associated vector is locked. Possible values are:

 

Value

Meaning

 

TRUE

The class object's associated vector is locked.

 

FALSE

The class object's associated vector is not locked.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Locking a vector handle has precedence over locking layers within the vector handle. Therefore, if a vector handle is locked, the layers within that vector handle cannot be edited, even if the layers are not locked.

Required DLLs and Libraries

LVKRN

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:

LVectorBase::SetLocked

Topics:

Working with Vector Handles

Example

This example toggles the locked state of the vector.

L_INT LVectorBase__IsLockedExample(HWND hWnd, LVectorBase *pVector)
{
   UNREFERENCED_PARAMETER(hWnd);
   UNREFERENCED_PARAMETER(pVector);
   L_INT    nRet;
   L_BOOL   bLocked;
   nRet = pVector->IsLocked(&bLocked);
   if(nRet != SUCCESS)
      return nRet;
   nRet = pVector-> SetLocked(!bLocked);
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}