TTMSFNCAppLock Class
Component that locks an application and requires a password to reopen it, on demand or after a configurable period of user inactivity.
API unit family: TMSFNCAppLock
Inherits from: TTMSFNCCustomAppLock
Syntax
TTMSFNCAppLock = class(TTMSFNCCustomAppLock)
Remarks
Publishes the lock configuration, dialog appearance, and lock-related events for design-time use.
Properties
| Name | Description |
|---|---|
| ActiveOnIdle | Enables automatic locking after a period of user inactivity. (inherited from TTMSFNCCustomAppLock) |
| Dialog | Appearance and texts of the unlock dialog shown when reopening a locked application. (inherited from TTMSFNCCustomAppLock) |
| IdleMinutes | Inactivity period in minutes after which the application is locked automatically. (inherited from TTMSFNCCustomAppLock) |
| IdleSeconds | Inactivity period in seconds after which the application is locked automatically. (inherited from TTMSFNCCustomAppLock) |
| IncorrectPassword | Message shown when an incorrect password is entered and no OnIncorrectPassword handler is assigned. (inherited from TTMSFNCCustomAppLock) |
| Password | Password required to unlock the application. (inherited from TTMSFNCCustomAppLock) |
| Username | User name shown in the unlock dialog. When empty, the current operating-system user name is used. (inherited from TTMSFNCCustomAppLock) |
Methods
| Name | Description |
|---|---|
| Lock | Locks the application immediately, hiding its windows and disabling the idle timer. (inherited from TTMSFNCCustomAppLock) |
| Unlock | Unlocks the application immediately and restores its windows. (inherited from TTMSFNCCustomAppLock) |
Events
| Name | Description |
|---|---|
| OnIdle | Occurs while the application is idle and inactivity tracking is enabled. (inherited from TTMSFNCCustomAppLock) |
| OnIncorrectPassword | Occurs when an incorrect password is entered in the unlock dialog. (inherited from TTMSFNCCustomAppLock) |
| OnLock | Occurs after the application has been locked. (inherited from TTMSFNCCustomAppLock) |
| OnQueryUnlock | Occurs when the user attempts to reopen a locked application, allowing custom logic to decide whether unlocking proceeds without showing the password dialog. (inherited from TTMSFNCCustomAppLock) |
| OnUnlock | Occurs after the application has been unlocked. (inherited from TTMSFNCCustomAppLock) |
| OnVerifyPassword | Occurs when a password is submitted in the unlock dialog, allowing custom validation. (inherited from TTMSFNCCustomAppLock) |