Skip to main content
Version: 8.1

system.security.lockScreen

This function is used in Python Scripting.

Description

Used to put a running client in lock-screen mode. The screen can be unlocked by the user with the proper credentials, or by scripting via the system.security.unlockScreen() function.

Client Permission Restrictions

This scripting function has no Client Permission restrictions.

Syntax

system.security.lockScreen([obscure])

Parameters

TypeParameterDescription
BooleanobscureIf true(1), the locked screen will be opaque, otherwise it will be partially visible. [optional]

Returns

Nothing

Scope

Vision Client

Code Example

Code Snippet
# This would run in a timer script to lock the screen after 15 seconds of inactivity, and then log the user out after 30 seconds of inactivity.

if system.util.getInactivitySeconds() > 15 and not system.security.isScreenLocked():
system.security.lockScreen()
elif system.util.getInactivitySeconds() > 30:
system.security.logout()

Keywords

system security lockScreen, security.lockScreen