ui.Form.ensureElementVisible

ui.Form.EnsureElementVisible() makes sure that the static form element is brought to the attention of the user.

Syntax

CALL <form_var>.ensureElementVisible("element_id")

Usage and examples

ui.Form.EnsureElementVisible() applies to the static form elements – e.g., images, static labels (isDynamic = "false"), etc.

Usually, ui.Form.EnsureElementVisible() is used with TabPages.

When you click on, manipulate, or in any way refer to the static form element for which this method is set, your application will immediately switch to the TabPage containing this element:

CALL f.ensureElementVisible("lb1")

You can specify the form field by its identifier. If several elements share the same identifier, the method is applied to the first element found in the form.

 

ui.Form.EnsureElementVisible() has a similar method – EnsureFieldVisible() – used for compatibility reasons.

The difference between EnsureElementVisible() and EnsureFieldVisible() is that

• EnsureElementVisible() is used for static form fields like labels and images
• EnsureFieldVisible() is used for dynamic form fields