.Lockcount R/O Property

Top  Previous  Next

Function:

Indicates the current nesting level of the display lock.

Type:

Byte

Value Range:

0-255. Default= 0 (display unlocked).

See Also:

---

 


Details

Invoking lcd.lock increases the value of this property by 1. If 255 is reached, the value does not roll over to 0 and stays at 255. Invoking lcd.unlock decreases the value of this property by 1. When 0 is reached, the value does not roll over to 255 and stays at 0. The display is locked when lcd.lockcount is not at 0. Of course, the display does not get locked any "harder" with every increment of the lcd.lockcount.

When the display is locked, you can make changes to the display data without showing these changes on the screen. You can then unlock the display and show all the changes made at once. This usually greatly improves the display agility perception (see Improving Graphical Performance).

Not all controllers/panels support this feature. See the Supported Controllers/Panels section for details on the display you are using. If your display does not support locking, executing lcd.lock will have no effect and lcd.lockcount will always stay at 0.