Selection.setFocus()

Disponibilidad

Flash Player 5. Los nombres de instancia para botones y clips de película sólo funcionan en Flash Player 6 y versiones posteriores.

Sintaxis

Selection.setFocus("instanceName")

Parámetros

instanceName Cadena que especifica la ruta del nombre de instancia de un botón, un clip de película o un campo de texto.

Valor devuelto

Un evento.

Descripción

Método; activa el campo de texto, botón o clip de película seleccionable (editable) especificado por instanceName. El parámetro instanceName debe ser un literal de cadena de la ruta a la instancia. Para especificar la ruta, puede utilizar notación con puntos o con barras. Además, puede utilizar una ruta relativa o absoluta. Si utiliza ActionScript 2.0, debe utilizar la notación con puntos.

Si se pasa el valor null, el elemento seleccionado se elimina.

Ejemplo

El ejemplo siguiente selecciona un campo de texto asociado con myVar en la línea de tiempo principal. El parámetro instanceName es una ruta absoluta, de modo que puede llamar a la acción desde cualquier línea de tiempo.

Selection.setFocus("_root.myVar");

En el ejemplo siguiente, el campo de texto asociado con myVar se encuentra en un clip de película llamado myClip en la línea de tiempo principal. Para establecer el elemento seleccionado, puede utilizar cualquiera de las dos rutas siguientes; la primera es relativa, y la segunda, absoluta.

Selection.setFocus("myClip.myVar");
Selection.setFocus("_root.myClip.myVar");