2.2.4.32.36 OriginObject::Lock

Lock

1 Description
2 Syntax
3 Parameters
4 Return
5 Examples
6 Remark
7 See Also
8 Header to Include

Description

Locks a particular object from read/write data access (Implemented only for WorksheetLayer, WorksheetPage, and Project Objects)

Syntax

BOOL Lock( LPCSTR lpcszPassword, DWORD dwCtrl )

Parameters

lpcszPassword: Desired password to unlock later
dwCtrl: can be one or more of the following bits: PLC_WRITE, PLC_READ, PLC_RENAME

Return

returns non zero if successfull else 0;

Examples

EX1

void wkslock(string strPass = "CP", bool bHideData = false)
{
    Worksheet wks = Project.ActiveLayer();
    DWORD dwBits = PLC_WRITE;
    if(wks)
    {
        if(bHideData)
            dwBits |= PLC_READ;
        wks.Lock(strPass, dwBits);
        printf("Worksheet %s is locked\n", wks.GetName());
    }
}

EX2

void wkslock_rename(bool bLock=true)
{
	Worksheet wks = Project.ActiveLayer();
	if(wks)
	{
		int nn = 0;
		if( bLock )
			wks.Lock(NULL, PLC_RENAME);
		else
			wks.Unlock(NULL, 0);
	}
}