TextField._visible Property

ActionScript for Flash MX: The Definitive Guide, 2nd Edition
By Colin Moock
Chapter 18.  ActionScript Language Reference
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



    ActionScript for Flash MX. The Definitive Guide
    ActionScript for Flash MX: The Definitive Guide, Second Edition
    ISBN: 059600396X
    EAN: 2147483647
    Year: 2002
    Pages: 780
    Authors: Colin Moock

    flylib.com © 2008-2017.
    If you may any questions please contact us: flylib@qtcs.net