Paquetefl.controls
Clasepublic class CheckBox
HerenciaCheckBox Inheritance LabelButton Inheritance BaseButton Inheritance UIComponent Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object

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

El componente CheckBox muestra un pequeño cuadro que puede incluir una marca de verificación. Los componentes CheckBox también pueden mostrar una etiqueta de texto opcional que se sitúa a la izquierda, derecha o en la parte superior o inferior de CheckBox.

Un componente CheckBox cambia su estado en respuesta a un clic del ratón y cuando pasa del estado seleccionado a deseleccionado, y viceversa. Los componentes CheckBox incluyen un conjunto de valores true o false no excluyentes entre sí.

Ver los ejemplos



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
  autoRepeat : Boolean
Por definición, un componente CheckBox nunca se repite automáticamente, por lo que la propiedad autoRepeat se establece en false en el constructor y no se puede cambiar para CheckBox.
CheckBox
 InheritedblendMode : String
Un valor de la clase BlendMode que especifica el modo de mezcla que debe utilizarse.
DisplayObject
 InheritedbuttonMode : Boolean
Especifica el modo de botón de este elemento sprite.
Sprite
 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
 InheriteddropTarget : DisplayObject
[read-only] Especifica el objeto de visualización sobre el que se está arrastrando el elemento sprite o sobre el que se ha colocado el elemento sprite.
Sprite
 Inheritedenabled : Boolean
Obtiene o define un valor que indica si el componente puede aceptar la entrada del usuario.
BaseButton
 Inheritedfilters : Array
Matriz indexada que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización.
DisplayObject
 InheritedfocusEnabled : Boolean
Obtiene o define un valor booleano que indica si el componente puede recibir selecciones cuando el usuario hace clic sobre él.
UIComponent
 InheritedfocusManager : IFocusManager
Obtiene o define la clase FocusManager que controla la selección de este componente y sus homólogos.
UIComponent
 InheritedfocusRect : Object
Especifica si este objeto muestra un rectángulo de selección.
InteractiveObject
 Inheritedgraphics : Graphics
[read-only] Especifica el objeto Graphics que pertenece a este elemento sprite, donde pueden ejecutarse comandos de dibujo vectorial.
Sprite
 Inheritedheight : Number
Obtiene o define la altura del componente, expresada en píxeles.
UIComponent
 InheritedhitArea : Sprite
Designa otro elemento sprite para que actúe como área activa de un elemento sprite.
Sprite
 Inheritedlabel : String
Obtiene o define la etiqueta de texto del componente.
LabelButton
 InheritedlabelPlacement : String
Posición de la etiqueta respecto a un icono especificado.
LabelButton
 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
 InheritedmouseChildren : Boolean
Determina si los elementos secundarios del objeto están habilitados para ratón.
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
Especifica si este objeto recibe mensajes de ratón.
InteractiveObject
 InheritedmouseFocusEnabled : Boolean
Obtiene o define un valor booleano que indica si el componente puede recibir selecciones cuando el usuario hace clic sobre él.
UIComponent
 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
 InheritednumChildren : int
[read-only] Devuelve el número de elementos secundarios de este objeto.
DisplayObjectContainer
 InheritedopaqueBackground : Object
Especifica si el objeto de visualización es opaco con un determinado color de fondo.
DisplayObject
 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
Multiplica la anchura actual del componente por un factor de escala.
UIComponent
 InheritedscaleY : Number
Multiplica la altura actual del componente por un factor de escala.
UIComponent
 InheritedscrollRect : Rectangle
Los límites del rectángulo de desplazamiento del objeto de visualización.
DisplayObject
 Inheritedselected : Boolean
Obtiene o define un valor booleano que indica si un botón puede cambiar a la posición activado o desactivado.
LabelButton
 InheritedsoundTransform : SoundTransform
Controla el sonido dentro de este elemento sprite.
Sprite
 Inheritedstage : Stage
[read-only] El escenario del objeto de visualización.
DisplayObject
 InheritedtabChildren : Boolean
Determina si los elementos secundarios del objeto están habilitados para tabulación.
DisplayObjectContainer
 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
 InheritedtextField : TextField
Referencia al campo de texto interno del componente.
LabelButton
 InheritedtextSnapshot : TextSnapshot
[read-only] Devuelve un objeto TextSnapshot para esta instancia de DisplayObjectContainer.
DisplayObjectContainer
  toggle : Boolean
Por definición, un control CheckBox puede conmutar, por lo que la propiedad toggle se establece como true en el constructor y no se puede cambiar para un control CheckBox.
CheckBox
 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
 InheriteduseHandCursor : Boolean
Valor booleano que indica si debe aparecer la mano que señala (cursor de mano) cuando el ratón pasa por encima de un elemento sprite en el que la propiedad buttonMode se ha definido con el valor true.
Sprite
 Inheritedversion : String = "3.0.0.15"
Número de versión de los componentes.
UIComponent
 Inheritedvisible : Boolean
Obtiene o define un valor que indica si la instancia del componente actual es visible.
UIComponent
 Inheritedwidth : Number
Obtiene o define la anchura del componente, expresada en píxeles.
UIComponent
 Inheritedx : Number
Obtiene o define la coordenada x que representa la posición del componente a lo largo del eje x en su contenedor principal.
UIComponent
 Inheritedy : Number
Obtiene o define la coordenada y que representa la posición del componente a lo largo del eje y en su contenedor principal.
UIComponent
Métodos públicos
 MétodoDefinido por
  
Crea una instancia de componente CheckBox nueva.
CheckBox
 Inherited
Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer.
DisplayObjectContainer
 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
Indica si las restricciones de seguridad provocarían la omisión de objetos de visualización de la lista devuelta al llamar al método DisplayObjectContainer.getObjectsUnderPoint() con el punto point especificado.
DisplayObjectContainer
 Inherited
Elimina una propiedad de estilo de esta instancia de componente.
UIComponent
 Inherited
Determina si el objeto de visualización especificado es un elemento secundario de la instancia de DisplayObjectContainer o la propia instancia.
DisplayObjectContainer
 Inherited
Distribuye un evento en el flujo del evento.
EventDispatcher
  
Muestra u oculta el indicador de selección alrededor de este componente.
CheckBox
 Inherited
Inicia de forma inmediata una operación de dibujo, sin invalidarlo todo como ocurre con invalidateNow.
UIComponent
 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
Devuelve la instancia del objeto de visualización secundario que sale del índice especificado.
DisplayObjectContainer
 Inherited
Devuelve el objeto de visualización secundario que sale con el nombre especificado.
DisplayObjectContainer
 Inherited
Devuelve la posición de índice de una instancia secundaria de DisplayObject.
DisplayObjectContainer
 Inherited
Recupera el objeto que está seleccionado actualmente.
UIComponent
 Inherited
Devuelve una matriz de objetos que quedan bajo el punto especificado y son elementos secundarios (o terciarios, etc.) de esta instancia de DisplayObjectContainer.
DisplayObjectContainer
 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
Recupera una propiedad de estilo que se define en la cadena de búsqueda de estilo del componente.
UIComponent
  
[static] Devuelve la asignación de estilos predeterminada del componente actual.
CheckBox
 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
invalidate(property:String, callLater:Boolean = true):void
Marca una propiedad como no válida y vuelve a dibujar el componente en el siguiente fotograma a menos que se especifique lo contrario.
UIComponent
 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
[static] Combina los estilos de varias clases en un objeto.
UIComponent
 Inherited
Mueve el componente a la posición especificada dentro de su elemento principal.
UIComponent
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Elimina la instancia child de DisplayObject especificada de la lista de elementos secundarios de la instancia de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
Elimina una instancia de DisplayObject secundaria de la posición de índice especificada en la lista de elementos secundarios de DisplayObjectContainer.
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Elimina un detector del objeto EventDispatcher.
EventDispatcher
 Inherited
Cambia la posición de un elemento secundario existente en el contendor de objeto de visualización.
DisplayObjectContainer
 Inherited
Selecciona este componente.
UIComponent
 Inherited
Establece el estado del ratón a través de ActionScript.
BaseButton
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
setSize(width:Number, height:Number):void
Define el componente en la anchura y altura especificadas.
UIComponent
 Inherited
setStyle(style:String, value:Object):void
Define una propiedad de estilo en esta instancia de componente.
UIComponent
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
Permite al usuario arrastrar el elemento sprite especificado.
Sprite
 Inherited
Finaliza el método startDrag().
Sprite
 Inherited
Intercambia el orden z (de delante a atrás) de los dos objetos secundarios especificados.
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
Intercambia el orden z (de delante a atrás) de los objetos secundarios situados en las posiciones de índice especificadas en la lista de elementos secundarios.
DisplayObjectContainer
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Valida y actualiza las propiedades y el diseño de este objeto y lo vuelve a dibujar, si es necesario.
UIComponent
 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 el usuario presiona el componente Button.BaseButton
 Inherited Se distribuye si cambia el valor de la propiedad "selected" de un componente Button de activación.BaseButton
 Inherited Se distribuye tras presionar el botón de activación con el ratón o la barra espaciadora.LabelButton
 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 la visibilidad del componente cambia de visible a invisible.UIComponent
 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 se modifica el valor de la etiqueta.LabelButton
 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 se mueve el componente.UIComponent
 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 se cambia el tamaño del componente.UIComponent
 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 la visibilidad del componente cambia de invisible a visible.UIComponent
 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
Estilos
 Estilo Descripción Definido por
  
disabledIcon
Tipo: Class
Nombre de la clase que se utiliza como icono cuando el botón no está desactivado. El valor predeterminado es CheckBox_disabledIcon.
CheckBox
 Inherited Tipo: Class
Nombre de la clase que se utiliza como aspecto para el fondo y el borde cuando el botón no está seleccionado y está desactivado.
LabelButton
 Inherited Tipo: flash.text.TextFormat
El objeto TextFormat que se utilizará para representar la etiqueta del componente cuando el botón esté desactivado.
UIComponent
  
downIcon
Tipo: Class
Nombre de la clase que se utiliza como icono cuando el botón no está seleccionado y el botón del ratón está presionado. El valor predeterminado es CheckBox_downIcon.
CheckBox
 Inherited Tipo: Class
Nombre de la clase que se utiliza como aspecto para el fondo y el borde cuando el botón no está seleccionado y el botón del ratón está presionado.
LabelButton
 Inherited Tipo: Boolean
Indica si se utilizan contornos de fuentes incorporadas para representar el campo de texto.
LabelButton
 Inherited Tipo: Number   Formato: Length
El relleno que separa los límites externos del componente de los bordes externos del indicador de selección, expresado en píxeles.
UIComponent
 Inherited Tipo: Class
El aspecto que se utilizará para mostrar los indicadores de selección.
UIComponent
  
icon
Tipo: Class
Nombre de la clase que se utiliza como icono cuando el botón de activación no está seleccionado y el ratón no está sobre el componente. El valor predeterminado es null.
CheckBox
  
overIcon
Tipo: Class
Nombre de la clase que se utiliza como icono cuando el botón no está seleccionado y el ratón está sobre el componente. El valor predeterminado es CheckBox_overIcon.
CheckBox
 Inherited Tipo: Class
Nombre de la clase que se utiliza como aspecto para el fondo y el borde cuando el botón no está seleccionado y el ratón está sobre el componente.
LabelButton
 Inherited Tipo: Number   Formato: Time
El número de milisegundos de espera después de que el evento buttonDown se distribuyera por primera vez antes de enviar un segundo evento buttonDown.
LabelButton
 Inherited Tipo: Number   Formato: Time
El intervalo, en milisegundos, entre los eventos buttonDown que se distribuyen después del retardo especificado por el estilo repeatDelay.
LabelButton
  
selectedDisabledIcon
Tipo: Class
Nombre de la clase que se utiliza como icono cuando el botón está seleccionado y desactivado. El valor predeterminado es CheckBox_selectedDisabledIcon.
CheckBox
 Inherited Tipo: Class
Nombre de la clase que se utiliza como aspecto para el fondo y el borde cuando un botón de activación está seleccionado y desactivado.
LabelButton
  
selectedDownIcon
Tipo: Class
Nombre de la clase que se utiliza como icono cuando el botón está seleccionado y el botón del ratón está presionado. El valor predeterminado es CheckBox_selectedDownIcon.
CheckBox
 Inherited Tipo: Class
Nombre de la clase que se utiliza como aspecto para el fondo y el borde cuando un botón de activación está seleccionado y el botón del ratón está presionado.
LabelButton
  
selectedOverIcon
Tipo: Class
Nombre de la clase que se utiliza como icono cuando el botón está seleccionado y el ratón está sobre el componente. El valor predeterminado es CheckBox_selectedOverIcon.
CheckBox
 Inherited Tipo: Class
Nombre de la clase que se utiliza como aspecto para el fondo y el borde cuando un botón de activación está seleccionado y el ratón está sobre el componente.
LabelButton
  
selectedUpIcon
Tipo: Class
Nombre de la clase que se utiliza como icono cuando el botón está seleccionado y el botón del ratón no está presionado. El valor predeterminado es CheckBox_selectedUpIcon.
CheckBox
 Inherited Tipo: Class
Nombre de la clase que se utiliza como aspecto para el fondo y el borde cuando un botón de activación está seleccionado y el ratón no está sobre el componente.
LabelButton
 Inherited Tipo: flash.text.TextFormat
El objeto TextFormat que se utilizará para representar la etiqueta del componente.
UIComponent
  
textPadding
Tipo: Number   Formato: Length
El espaciado entre el texto y los bordes del componente, así como el espaciado entre el texto y el icono, expresado en píxeles. El valor predeterminado es 5.
CheckBox
  
upIcon
Tipo: Class
Nombre de la clase que se utiliza como icono cuando el botón de activación no está seleccionado y el ratón no está sobre el componente. El valor predeterminado es CheckBox_upIcon.
CheckBox
 Inherited Tipo: Class
Nombre de la clase que se utiliza como aspecto para el fondo y el borde cuando el botón no está seleccionado y el ratón no está sobre el componente.
LabelButton
Información sobre propiedades
autoRepeatpropiedad
autoRepeat:Boolean  [read-write]

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

Por definición, un componente CheckBox nunca se repite automáticamente, por lo que la propiedad autoRepeat se establece en false en el constructor y no se puede cambiar para CheckBox.

El valor predeterminado es false.


Implementación
    public function get autoRepeat():Boolean
    public function set autoRepeat(value:Boolean):void
togglepropiedad 
toggle:Boolean  [read-write]

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

Por definición, un control CheckBox puede conmutar, por lo que la propiedad toggle se establece como true en el constructor y no se puede cambiar para un control CheckBox.

El valor predeterminado es true.


Implementación
    public function get toggle():Boolean
    public function set toggle(value:Boolean):void

Emite
Error — Este valor no se puede cambiar por un componente CheckBox.
Información sobre constructores
CheckBox()constructor
public function CheckBox()