Paqueteflash.display
Clasepublic class SimpleButton
HerenciaSimpleButton Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

La clase SimpleButton le permite controlar todas las instancias de los símbolos de botones de un archivo SWF. Tras crear una instancia de un botón en la herramienta de edición, puede utilizar los métodos y propiedades de la clase SimpleButton para manipular botones con ActionScript.

Puede asignar un nombre de instancia a un botón en el inspector de propiedades. Los nombres de instancias de SimpleButton se muestran en el explorador de películas y en el cuadro de diálogo Insertar ruta de destino del panel Acciones.

En ActionScript 3.0, se utiliza el constructor new SimpleButton() para crear una instancia de SimpleButton.

La clase SimpleButton hereda de la clase InteractiveObject.

Ver los ejemplos

Véase también

Clase InteractiveObject
Clases principales de visualización


Propiedades públicas
 PropiedadDefinido por
 InheritedaccessibilityProperties : AccessibilityProperties
Las opciones de accesibilidad actuales para este objeto de visualización.
DisplayObject
 Inheritedalpha : Number
Indica el valor de transparencia alfa del objeto especificado.
DisplayObject
 InheritedblendMode : String
Un valor de la clase BlendMode que especifica el modo de mezcla que debe utilizarse.
DisplayObject
 InheritedcacheAsBitmap : Boolean
Si se define como true, Flash Player deja en caché una representación interna de mapa de bits del objeto de visualización.
DisplayObject
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
 InheritedcontextMenu : ContextMenu
Especifica el menú contextual asociado a este objeto.
InteractiveObject
 InheriteddoubleClickEnabled : Boolean
Especifica si este objeto recibe eventos doubleClick.
InteractiveObject
  downState : DisplayObject
Especifica un objeto de visualización que se utiliza como objeto visual para el estado "Presionado" del botón, el estado en que se encuentra el botón cuando el usuario hace clic en el objeto hitTestState.
SimpleButton
  enabled : Boolean
Un valor booleano que especifica si está activado un botón.
SimpleButton
 Inheritedfilters : Array
Matriz indexada que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización.
DisplayObject
 InheritedfocusRect : Object
Especifica si este objeto muestra un rectángulo de selección.
InteractiveObject
 Inheritedheight : Number
Indica la altura del objeto de visualización, expresada en píxeles.
DisplayObject
  hitTestState : DisplayObject
Especifica un objeto de visualización que se utiliza como objeto de prueba de zona activa para el botón.
SimpleButton
 InheritedloaderInfo : LoaderInfo
[read-only] Devuelve un objeto LoaderInfo que contiene información sobre la carga del archivo al que pertenece este objeto de visualización.
DisplayObject
 Inheritedmask : DisplayObject
El objeto de visualización que origina la llamada se enmascara mediante el objeto mask especificado.
DisplayObject
 InheritedmouseEnabled : Boolean
Especifica si este objeto recibe mensajes de ratón.
InteractiveObject
 InheritedmouseX : Number
[read-only] Indica la coordenada x de la posición del ratón en píxeles.
DisplayObject
 InheritedmouseY : Number
[read-only] Indica la coordenada y de la posición del ratón en píxeles.
DisplayObject
 Inheritedname : String
Indica el nombre de instancia de DisplayObject.
DisplayObject
 InheritedopaqueBackground : Object
Especifica si el objeto de visualización es opaco con un determinado color de fondo.
DisplayObject
  overState : DisplayObject
Especifica un objeto de visualización que se utiliza como objeto visual para el estado del botón cuando se desplaza el puntero sobre él, el estado en que se encuentra el botón cuando el ratón se sitúa sobre el botón.
SimpleButton
 Inheritedparent : DisplayObjectContainer
[read-only] Indica el objeto DisplayObjectContainer que contiene este objeto de visualización.
DisplayObject
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
 Inheritedroot : DisplayObject
[read-only] Para un objeto de visualización en un archivo SWF cargado, la propiedad root es el objeto de visualización de nivel más alto en la parte de la estructura de árbol de la lista de visualización representada por dicho archivo SWF.
DisplayObject
 Inheritedrotation : Number
Indica el giro de la instancia de DisplayObject, expresado en grados, con respecto a su orientación original.
DisplayObject
 Inheritedscale9Grid : Rectangle
La cuadrícula de escala aplicada actualmente.
DisplayObject
 InheritedscaleX : Number
Indica la escala horizontal (percentage) del objeto aplicada desde el punto de registro.
DisplayObject
 InheritedscaleY : Number
Indica la escala vertical (percentage) de un objeto aplicada desde el punto de registro del objeto.
DisplayObject
 InheritedscrollRect : Rectangle
Los límites del rectángulo de desplazamiento del objeto de visualización.
DisplayObject
  soundTransform : SoundTransform
El objeto SoundTransform asignado a este botón.
SimpleButton
 Inheritedstage : Stage
[read-only] El escenario del objeto de visualización.
DisplayObject
 InheritedtabEnabled : Boolean
Especifica si este objeto está en el orden de tabulación.
InteractiveObject
 InheritedtabIndex : int
Especifica el orden de tabulación de los objetos de un archivo SWF.
InteractiveObject
  trackAsMenu : Boolean
Indica si otros objetos de visualización que sean objetos SimpleButton o MovieClip pueden recibir eventos de liberación del botón del ratón.
SimpleButton
 Inheritedtransform : Transform
Objeto con propiedades pertenecientes a una matriz, transformación de color y límites de píxel de un objeto de visualización.
DisplayObject
  upState : DisplayObject
Especifica un objeto de visualización que se utiliza como objeto visual para el estado del botón sin presionar, el estado en que se encuentra el botón cuando el ratón no está situado sobre el botón.
SimpleButton
  useHandCursor : Boolean
Valor booleano que, cuando se establece como true, indica si debe aparecer el cursor de mano cuando el ratón pasa por encima de un botón.
SimpleButton
 Inheritedvisible : Boolean
Indica si el objeto de visualización es visible.
DisplayObject
 Inheritedwidth : Number
Indica la anchura del objeto de visualización, expresada en píxeles.
DisplayObject
 Inheritedx : Number
Indica la coordenada x de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal.
DisplayObject
 Inheritedy : Number
Indica la coordenada y de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal.
DisplayObject
Métodos públicos
 MétodoDefinido por
  
SimpleButton(upState:DisplayObject = null, overState:DisplayObject = null, downState:DisplayObject = null, hitTestState:DisplayObject = null)
Crea una nueva instancia de SimpleButton.
SimpleButton
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento.
EventDispatcher
 Inherited
Distribuye un evento en el flujo del evento.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Devuelve un rectángulo que define el área del objeto de visualización relativo al sistema de coordenadas del objeto targetCoordinateSpace.
DisplayObject
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Devuelve un rectángulo que define el límite del objeto de visualización, basado en el sistema de coordenadas definido por el parámetro targetCoordinateSpace, excluyendo los trazos en las formas.
DisplayObject
 Inherited
Convierte el objeto point de las coordenadas del escenario (globales) en las coordenadas del objeto de visualización (locales).
DisplayObject
 Inherited
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.
EventDispatcher
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Evalúa el objeto de visualización para comprobar si se solapa o presenta un punto de intersección con el objeto de visualización obj.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Evalúa el objeto de visualización para comprobar si se solapa o presenta un punto de intersección con el punto especificado por los parámetros x e y.
DisplayObject
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Convierte el objeto point de coordenadas del objeto de visualización (locales) en coordenadas del escenario (globales).
DisplayObject
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Elimina un detector del objeto EventDispatcher.
EventDispatcher
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Devuelve el valor simple del objeto especificado.
Object
 Inherited
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto.
EventDispatcher
Eventos
 Evento Resumen Definido por
 Inherited Se distribuye cuando Flash Player queda seleccionado por el sistema operativo y pasa a estar activo.EventDispatcher
 Inherited Se distribuye cuando un objeto de visualización se añade a la lista de visualización.DisplayObject
 Inherited Se distribuye cuando un objeto de visualización se añade a la lista de visualización del escenario, bien directamente o a través de un subárbol que contiene el objeto de visualización.DisplayObject
 Inherited Se distribuye cuando un usuario pulsa y suelta el botón principal del dispositivo de señalización sobre el mismo objeto InteractiveObject.InteractiveObject
 Inherited Se distribuye cuando Flash Player deja de estar seleccionado por el sistema operativo y pasa a estar inactivo.EventDispatcher
 Inherited Se distribuye cuando un usuario pulsa y suelta el botón principal de un dispositivo de señalización dos veces en una sucesión rápida sobre el mismo objeto InteractiveObject cuando el indicador doubleClickEnabled de dicho objeto se ha definido como true.InteractiveObject
 Inherited Se distribuye cuando la cabeza lectora entra en un nuevo fotograma.DisplayObject
 Inherited Se distribuye después de que un objeto de visualización quede seleccionado.InteractiveObject
 Inherited Se distribuye después de que un objeto de visualización deje de estar seleccionado.InteractiveObject
 Inherited Se distribuye cuando el usuario pulsa una tecla.InteractiveObject
 Inherited Se distribuye cuando el usuario intenta cambiar la selección empleando la navegación mediante teclado.InteractiveObject
 Inherited Se distribuye cuando el usuario suelta una tecla.InteractiveObject
 Inherited Se distribuye cuando el usuario pulsa el botón del dispositivo de señalización sobre una instancia de InteractiveObject en la ventana de Flash Player.InteractiveObject
 Inherited Se distribuye cuando el usuario intenta cambiar la selección empleando un dispositivo de señalización.InteractiveObject
 Inherited Se distribuye cuando el usuario mueve el dispositivo de señalización mientras éste se encuentra sobre un InteractiveObject.InteractiveObject
 Inherited Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject.InteractiveObject
 Inherited Se distribuye cuando el usuario pasa el dispositivo de señalización por encima de una instancia de InteractiveObject en la ventana de Flash Player.InteractiveObject
 Inherited Se distribuye cuando el usuario suelta el botón del dispositivo de señalización sobre una instancia de InteractiveObject en la ventana de Flash Player.InteractiveObject
 Inherited Se distribuye cuando se hace girar una rueda de ratón sobre una instancia de InteractiveObject en la ventana de Flash Player.InteractiveObject
 Inherited Se distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización.DisplayObject
 Inherited Se distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización, bien directamente o a través de la eliminación de un subárbol que contiene el objeto de visualización.DisplayObject
 Inherited Se distribuye cuando la lista de visualización se va a actualizar y mostrar.DisplayObject
 Inherited Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject.InteractiveObject
 Inherited Se distribuye cuando el usuario mueve un dispositivo de señalización sobre una instancia de InteractiveObject.InteractiveObject
 Inherited Se distribuye cuando cambia el valor del indicador tabChildren del objeto.InteractiveObject
 Inherited Se distribuye cuando cambia el indicador tabEnabled del objeto.InteractiveObject
 Inherited Se distribuye cuando cambia el valor de la propiedad tabIndex del objeto.InteractiveObject
Información sobre propiedades
downStatepropiedad
downState:DisplayObject  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica un objeto de visualización que se utiliza como objeto visual para el estado "Presionado" del botón; el estado en que se encuentra el botón cuando el usuario hace clic en el objeto hitTestState.


Implementación
    public function get downState():DisplayObject
    public function set downState(value:DisplayObject):void

Véase también

enabledpropiedad 
enabled:Boolean  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Un valor booleano que especifica si está activado un botón. Cuando un botón está desactivado (la propiedad enabled está configurada como false), el botón está visible pero no se puede hacer clic en él. El valor predeterminado es true. Esta propiedad resulta útil si desea desactivar parte de la navegación; por ejemplo, puede que desee desactivar un botón de la página mostrada actualmente para que no se pueda hacer clic en él y no pueda volver a cargarse la página.


Implementación
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void
hitTestStatepropiedad 
hitTestState:DisplayObject  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica un objeto de visualización que se utiliza como objeto de prueba de zona activa para el botón. En el caso de un botón básico, establezca la propiedad hitTestState con el mismo objeto de visualización que la propiedad overState. Si no establece la propiedad hitTestState, SimpleButton está inactivo, no responde a los eventos del ratón y el teclado.


Implementación
    public function get hitTestState():DisplayObject
    public function set hitTestState(value:DisplayObject):void

Véase también

overStatepropiedad 
overState:DisplayObject  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica un objeto de visualización que se utiliza como objeto visual para el estado del botón cuando se desplaza el puntero sobre él, el estado en que se encuentra el botón cuando el ratón se sitúa sobre el botón.


Implementación
    public function get overState():DisplayObject
    public function set overState(value:DisplayObject):void

Véase también

soundTransformpropiedad 
soundTransform:SoundTransform  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

El objeto SoundTransform asignado a este botón. Un objeto SoundTransform incluye propiedades para establecer el volumen, el desplazamiento lateral, la asignación del altavoz izquierdo y la asignación del altavoz derecho. Este objeto SoundTransform aplica todos los estados del botón. Este objeto SoundTransform sólo afecta a los sonidos incorporados.


Implementación
    public function get soundTransform():SoundTransform
    public function set soundTransform(value:SoundTransform):void

Véase también

trackAsMenupropiedad 
trackAsMenu:Boolean  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Indica si otros objetos de visualización que sean objetos SimpleButton o MovieClip pueden recibir eventos de liberación del botón del ratón. La propiedad trackAsMenu permite crear menús. Puede establecer la propiedad trackAsMenu en cualquier objeto SimpleButton o MovieClip. Si la propiedad trackAsMenu no existe, el comportamiento predeterminado será false.

Puede cambiar la propiedad trackAsMenu en cualquier momento; el botón modificado adoptará de inmediato el nuevo comportamiento.


Implementación
    public function get trackAsMenu():Boolean
    public function set trackAsMenu(value:Boolean):void
upStatepropiedad 
upState:DisplayObject  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Especifica un objeto de visualización que se utiliza como objeto visual para el estado del botón sin presionar, el estado en que se encuentra el botón cuando el ratón no está situado sobre el botón.


Implementación
    public function get upState():DisplayObject
    public function set upState(value:DisplayObject):void

Véase también

useHandCursorpropiedad 
useHandCursor:Boolean  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Valor booleano que, cuando se establece como true, indica si debe aparecer el cursor de mano cuando el ratón pasa por encima de un botón. Si esta propiedad se establece como false, se mostrará el cursor de puntero de flecha. El valor predeterminado es true.

Puede cambiar la propiedad useHandCursor en cualquier momento; el botón modificado adoptará de inmediato el nuevo comportamiento de cursor.


Implementación
    public function get useHandCursor():Boolean
    public function set useHandCursor(value:Boolean):void
Información sobre constructores
SimpleButton()constructor
public function SimpleButton(upState:DisplayObject = null, overState:DisplayObject = null, downState:DisplayObject = null, hitTestState:DisplayObject = null)

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Crea una nueva instancia de SimpleButton. Cualquiera de los objetos de visualización que representan los diversos estados del botón pueden establecerse como parámetros en el constructor.

Parámetros
upState:DisplayObject (default = null) — El valor inicial del estado sin presionar de SimpleButton.
 
overState:DisplayObject (default = null) — El valor inicial del estado de SimpleButton cuando se desplaza el puntero sobre él.
 
downState:DisplayObject (default = null) — El valor inicial del estado presionado de SimpleButton.
 
hitTestState:DisplayObject (default = null) — El valor inicial del estado hitTest de SimpleButton.
Ejemplos Cómo utilizar los ejemplos
SimpleButtonExample.as

En el ejemplo siguiente, se utiliza la clase SimpleButtonExample, que a su vez utiliza la clase CustomSimpleButton, y esta clase crea la instancia de cuatro objetos ButtonDisplayState. El resultado es un botón creado con forma cuadrada, cuyo color de fondo cambia según el estado del ratón mediante la anulación de las propiedades de instancia de la clase SimpleButton. Esto se consigue realizando los pasos siguientes:
  1. En el constructor SimpleButtonExample(), se crea un nuevo objeto CustomSimpleButton de tipo SimpleButton denominado button, que llama al método constructor CustomSimpleButton. El objeto button se añade a la lista de visualización. El color y el tamaño del botón se determinan en los pasos siguientes.
  2. En la clase CustomSimpleButton, se declaran propiedades de instancia que se utilizarán más adelante para controlar el tamaño y el color de fondo de button, según el estado que tengan (naranja para el estado normal, amarillo oscuro para cuando se pasa el ratón por encima, azul claro cuando el ratón está en estado presionado). En todos los estados de button, el tamaño del cuadrado se establece en 80 píxeles mediante la propiedad size.
  3. La función constructora para la clase CustomSimpleButton establece las propiedades downState, overState, upState, hitTestState y useHandCursor con cuatro instancias de la clase ButtonDisplayState.
  4. En la clase ButtonDisplayState, el constructor establece el valor del color de fondo y el tamaño del cuadrado y llama al método draw().
  5. El método draw() vuelve a dibujar el cuadrado con el tamaño y color de fondo definidos en el constructor según el estado del botón.
package {
    import flash.display.Sprite;

    public class SimpleButtonExample extends Sprite {
        public function SimpleButtonExample() {
            var button:CustomSimpleButton = new CustomSimpleButton();
            addChild(button);
        }
    }
}

import flash.display.DisplayObject;
import flash.display.Shape;
import flash.display.SimpleButton;

class CustomSimpleButton extends SimpleButton {
    private var upColor:uint   = 0xFFCC00;
    private var overColor:uint = 0xCCFF00;
    private var downColor:uint = 0x00CCFF;
    private var size:uint      = 80;

    public function CustomSimpleButton() {
        downState      = new ButtonDisplayState(downColor, size);
        overState      = new ButtonDisplayState(overColor, size);
        upState        = new ButtonDisplayState(upColor, size);
        hitTestState   = new ButtonDisplayState(upColor, size * 2);
        hitTestState.x = -(size / 4);
        hitTestState.y = hitTestState.x;
        useHandCursor  = true;
    }
}

class ButtonDisplayState extends Shape {
    private var bgColor:uint;
    private var size:uint;

    public function ButtonDisplayState(bgColor:uint, size:uint) {
        this.bgColor = bgColor;
        this.size    = size;
        draw();
    }

    private function draw():void {
        graphics.beginFill(bgColor);
        graphics.drawRect(0, 0, size, size);
        graphics.endFill();
    }
}




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/display/SimpleButton.html