Table of Contents

TextField._visible Property Flash 6

whether the text field is shown or hidden read/write
theField._visible

Description

The Boolean _visible property indicates whether theField is currently shown (true) or hidden (false). We use _visible as a quick means of hiding a text field from view. Hidden fields can still be controlled via ActionScript and generally operate as normal; they simply are not displayed on screen. However, a hidden text field can receive neither focus nor user input, so its onChanged( ), onKillFocus( ), and onSetFocus( ) events do not fire. However, the onScroller( ) event will still fire in response to text field content changes.

The initial value of the _visible property is true for all text fields, even for text fields that are fully transparent or completely off stage. The _visible property changes only when it is modified explicitly by a script; think of it as a way to show and hide text fields programmatically, not as a reflection of all factors, such as position and transparency, that can affect a field's visibility.

Hiding a text field using the _visible property is preferred to setting it to fully transparent or moving it off stage because the Flash Player does not attempt to draw text fields with _visible set to false, thus improving rendering performance.

Example

The following code hides theField_txt:

this.createTextField("theField_txt", 1, 0, 0, 200, 20);
theField_txt.text = "You won't see this!";
theField_txt._visible = false;

See Also

TextField._alpha


Table of Contents