userSecurityLevel

Type: Integer

Availability: Read or write at run time

The userSecurityLevel property of the Application class contains the security level for the current user. The default value is zero (0).

It is your responsibility to assign a value to this property. The userSecurityLevel property is used in conjunction with the securityLevelEnabled and securityLevelVisible properties for Window classes.

When a form is loaded, the following rules determine the state of controls and menu items on the form.

• If securityLevelEnabled > app.userSecurityLevel for a form, control, or menu item, it is automatically disabled, regardless of the value of the enabled property.

• If securityLevelVisible > app.userSecurityLevel for a control or menu item, its visible property is set to false.

• If securityLevelVisible > app.userSecurityLevel for a form when the show or showModal method is called, the method call is rejected.

You can subsequently override the values of the enabled and the visible properties.

You should set the userSecurityLevel property during the initialize method or getAndValidateUser process before the creation of a form, as the setting of this property is actioned when forms and controls are created.

Changing the value of app.userSecurityLevel does not change the behavior of forms that have already been loaded.

Changing the value of the securityLevelEnabled property of a form, control, or menu item causes a reevaluation of its enabled status, based on the above rules.

Changing the value of the securityLevelVisible property of a form, control, or menu item causes a reevaluation of its visible status, based on the above rules.