Visible Property

Article
09/30/2022

Version: Available or changed with runtime version 1.0.

Sets whether to display the page or control.

Applies to

Page Label
Page Field
Page Group
Page Part
Page System Part
Page Chart Part
Page Action
Page Action Group
Page Action Ref
Page Custom Action
Page View
Page User Control

Property Value

True on pages if you want the page or control to be visible; otherwise, false on pages. The default is true on pages.

Syntax

Visible = false;

Remarks

Because this property also applies to containers, such as pages and subpages, if the Visible property for the container is set to false, then controls on the container are also not displayed, even if the Visible property is set to true.

Dynamic Visibility of Controls

Note

You can also use as property value a Boolean variable that evaluates to true or false. To use a variable for the Visible property, it must be set as a global page variable and the InDataSet Property must be defined on the variable.

On pages, you use the Visible property to show or hide group, part, field, and action controls. You can show or hide the control either statically by setting the property to true or false, or dynamically by using a Boolean variable or a Boolean field on the page. The Boolean field on the page can be either a true/false Boolean or a Boolean expression, such as "Credit Limit > Sales YTD".

Note

The dynamic options are only possible for group, part, and action controls.

Using a variable for field and action controls requires that the variable be resolved by the OnInit Trigger or OnOpenPage Trigger.

UI Customization and Visibility of Controls

When a part, field, action, or view is hidden by setting the Visible property, users are able to access and display that control again using personalization and role customization features in the user interface. The Visible property is not a replacement for user permissions or the application of proper security practices.

When the Visible property is specified by a Boolean variable, users can choose to hide the control while the Boolean evaluates to true, but cannot forcibly show the control while the control Boolean evaluates to false.