Visible (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls

Control attributes
Group of controls
Knowing the visibility of an element in WEBDEV
Using shortcuts according to control states
Controls on tabs
Rows in a Table control
Action Bar
Columns in a Table control
Limits

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Visible (Property)

In french: Visible

The Visible property is used to:

Find out whether an element is visible.
Make an element visible or invisible.

This property applies to the:

controls and groups of controls found in a window, in a page or in a report.
report blocks,
menu options.

Remarks:

In the window editor and in the page editor, the control visibility is defined in the "UI" tab of the control description.
In the report editor, the control visibility is defined in the "Details" tab of the control description.
The Visible property is available for table rows.

Example

// Make the "EDT_Company" control visible if it is invisible
IF EDT_Company.Visible = False THEN
EDT_Company.Visible = True
END

Syntax

Finding out whether an element is visible Hide the details

<Result> = <Element used>.Visible

<Result>: Boolean

True if the specified element is visible,
False otherwise.

<Element used>: Type of element

Name of the element to be used.

Making a control or a report block visible/invisible Hide the details

<Element used>.Visible = <Visible/Invisible>

<Element used>: Type of element

Name of element to use.

<Visible/Invisible>: Boolean

True if the specified element must be visible,
False if the specified element must be invisible.

Remarks

Control attributes

The Visible property does not modify the other state attributes of the control (selection without input, active or grayed out)

Group of controls

If the specified object is a group of controls, the visibility of all controls from that group changes.

Knowing the visibility of an element in WEBDEV

Reading the Visible property in WEBDEV can cause problems.. In fact, the result of the Visible property corresponds to a visibility that takes into account the visibility of the parents..

If a Popup page is open, using the Visible property on one of the Popup control fields in server code will always return False. Popup display is a browser-only event. The server does not know that the popup is visible. So the visibility of the fields in the popup is always Faux.

Using shortcuts according to control states

You cannot use shortcuts with an invisible control. For example, an invisible button does not react when shortcuts are used.

Controls on tabs

If a control on a tab pane is visible, but the pane is not displayed, the Visible property will return False.

Rows in a Table control

A row found in a Table control can be made visible or invisible. For example:

// Makes the second row of the Table control invisible
TABLE_Table[2].Visible = False

If the Table control uses bars with alternated colors, the alternation of colors will be respected.

Note: If the Visible property is used on a table cell, all cells in the corresponding column will be rendered invisible..

Action Bar

The Visible property can be used to hide an Action Bar control.

In this case, an animation is automatically applied when the Action Bar disappears.

Columns in a Table control

The Visible property can be used to hide columns of a Table control.

However, the Visible property must not be used in Ajax code to modify a column in a non-Ajax Table field: in this case, only the columns will be invisible, not the column titles.

Limits

The Visible property does not apply to reports.

The Visible property cannot be used on:

a row of a List Box or Combo Box control,
a window menu
an element in a TreeView control.

If the Visible property is used on a table cell, all cells found in the corresponding column will be hidden.

The Visible property cannot be used on:

a row of a List Box or Combo Box control,
a menu or a menu option,
an HTML table,
a control found in a looper.

The Visible property can only be used with the following elements:

Button control.
Static Text control.
Edit control.
Image control.
Check Box control.
Radio Button control.
List Box control.
Combo Box control.
TreeView control.
Tab control.
Window.
Table control.
Column of a Table control.
Supercontrol.

The Visible property can only be used with the following elements:

Button control.
Static Text control.
Image control.
Window.

The Visible property does not apply to windows.