.unlock Method

Details

When the display is locked (see lcd.lock), you can make changes to the display data without showing these changes on the screen. You can then unlock the display with lcd.unlock and show all the changes made at once. This usually greatly improves the display agility perception by the user, even if your application is not working any faster (see Improving Graphical Performance).

Each time you execute this method on a previously locked display, the value of the lcd.lockcount read-only property decreases by 1. Once this value reaches 0, the display is unlocked and the user sees updated display data. The lcd.lockcount read-only property allows you to nest locks/unlocks (again, 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.