org.flixel.FlxButton

Public Properties

	Property		Defined By
		acceleration : FlxPoint How fast the speed of this object is changing.	FlxObject
		active : Boolean If an object is not alive, the game loop will not automatically call update() on it.	FlxObject
		angle : Number Set the angle of a sprite to rotate it.	FlxObject
		angularAcceleration : Number How fast the spin speed should change.	FlxObject
		angularDrag : Number Like drag but for spinning.	FlxObject
		angularVelocity : Number This is how fast you want this sprite to spin.	FlxObject
		bottom : Number [read-only] The Y coordinate of the bottom of the rectangle.	FlxRect
		colHullX : FlxRect These store a couple of useful numbers for speeding up collision resolution.	FlxObject
		colHullY : FlxRect These store a couple of useful numbers for speeding up collision resolution.	FlxObject
		collideBottom : Boolean Flag for direction collision resolution.	FlxObject
		collideLeft : Boolean Flag for direction collision resolution.	FlxObject
		collideRight : Boolean Flag for direction collision resolution.	FlxObject
		collideTop : Boolean Flag for direction collision resolution.	FlxObject
		colOffsets : Array An array of FlxPoint objects.	FlxObject
		colVector : FlxPoint These store a couple of useful numbers for speeding up collision resolution.	FlxObject
		dead : Boolean Handy for tracking gameplay or animations.	FlxObject
		drag : FlxPoint This isn't drag exactly, more like deceleration that is only applied when acceleration is not affecting the sprite.	FlxObject
		exists : Boolean Kind of a global on/off switch for any objects descended from FlxObject.	FlxObject
		fixed : Boolean If an object is 'fixed' in space, it will not budge when it collides with a not-fixed object.	FlxObject
		_group : Boolean Dedicated internal flag for whether or not this class is a FlxGroup.	FlxObject
		health : Number Handy for storing health percentage or armor points or whatever.	FlxObject
		height : Number	FlxRect
		ID : int	FlxGroup
		left : Number [read-only] The X coordinate of the left side of the rectangle.	FlxRect
		maxAngular : Number Use in conjunction with angularAcceleration for fluid spin speed control.	FlxObject
		maxThrust : Number Used to cap thrust, helpful and easy!	FlxObject
		maxVelocity : FlxPoint If you are using acceleration, you can use maxVelocity with it to cap the speed automatically (very useful!).	FlxObject
		members : Array Array of all the FlxObjects that exist in this layer.	FlxGroup
		moves : Boolean Set this to false if you want to skip the automatic motion/movement stuff (see updateMotion()).	FlxObject
		name : String	FlxGroup
		on : Boolean Use this to toggle checkbox-style behavior.	FlxButton
		onFloor : Boolean Flag that indicates whether or not you just hit the floor.	FlxObject
		origin : FlxPoint WARNING: The origin of the sprite will default to its center.	FlxObject
		right : Number [read-only] The X coordinate of the right side of the rectangle.	FlxRect
		scrollFactor : FlxPoint A point that can store numbers from 0 to 1 (for X and Y independently) that governs how much this object is affected by the camera subsystem.	FlxObject
		solid : Boolean If an object is dead, the functions that automate collisions will skip it (see FlxG.overlapArrays() and FlxG.collideArrays()).	FlxObject
		thrust : Number If you want to do Asteroids style stuff, check out thrust, instead of directly accessing the object's velocity or acceleration.	FlxObject
		top : Number [read-only] The Y coordinate of the top of the rectangle.	FlxRect
		velocity : FlxPoint The basic speed of this object.	FlxObject
		visible : Boolean If an object is not visible, the game loop will not automatically call render() on it.	FlxObject
		width : Number	FlxRect
		x : Number	FlxPoint
		y : Number	FlxPoint

	Property	Defined By
		_callback : Function This function is called when the button is clicked.	FlxButton
		_first : Boolean	FlxGroup
		_flashPoint : Point This is a pre-allocated Flash Point object, which is useful for certain Flash graphics API calls	FlxObject
		_flicker : Boolean Internal helper used for retro-style flickering.	FlxObject
		_flickerTimer : Number Internal helper used for retro-style flickering.	FlxObject
		_initialized : Boolean Whether or not the button has initialized itself yet.	FlxButton
		_last : FlxPoint Helpers for moving/updating group members.	FlxGroup
		_off : FlxSprite Stores the 'off' or normal button state graphic.	FlxButton
		_offT : FlxText Stores the 'off' or normal button state label.	FlxButton
		_on : FlxSprite Stores the 'on' or highlighted button state graphic.	FlxButton
		_onT : FlxText Stores the 'on' or highlighted button state label.	FlxButton
		_onToggle : Boolean Used for checkbox-style behavior.	FlxButton
		_point : FlxPoint This is just a pre-allocated x-y point container to be used however you like	FlxObject
		_pressed : Boolean Tracks whether or not the button is currently pressed.	FlxButton
		_rect : FlxRect This is just a pre-allocated rectangle container to be used however you like	FlxObject
		_sf : FlxPoint Helper variable for correcting its members' scrollFactor objects.	FlxButton

Public Methods

Hide Inherited Public Methods

Show Inherited Public Methods

	Method		Defined By
		FlxButton(X:int, Y:int, Callback:Function) Creates a new FlxButton object with a gray background and a callback function on the UI thread.	FlxButton
		add(Object:FlxObject, ShareScroll:Boolean = false):FlxObject Adds a new FlxObject subclass (FlxSprite, FlxBlock, etc) to the list of children	FlxGroup
		collide(Object:FlxObject = null):Boolean	FlxObject
		countDead():int Call this function to find out how many members of the group are dead.	FlxGroup
		countLiving():int Call this function to find out how many members of the group are not dead.	FlxGroup
		countOnScreen():int Returns a count of how many objects in this group are on-screen right now.	FlxGroup
		destroy():void [override] Called by the game state when state is changed (if this object belongs to the state)	FlxButton
		flicker(Duration:Number = 1):void Tells this object to flicker, retro-style.	FlxObject
		flickering():Boolean Check to see if the object is still flickering.	FlxObject
		getFirstAlive():FlxObject Call this function to retrieve the first object with dead == false in the group.	FlxGroup
		getFirstAvail():FlxObject Call this function to retrieve the first object with exists == false in the group.	FlxGroup
		getFirstDead():FlxObject Call this function to retrieve the first object with dead == true in the group.	FlxGroup
		getFirstExtant():FlxObject Call this function to retrieve the first object with exists == true in the group.	FlxGroup
		getFirstNull():int Call this function to retrieve the first index set to 'null'.	FlxGroup
		getRandom():FlxObject Returns a member at random from the group.	FlxGroup
		getScreenXY(Point:FlxPoint = null):FlxPoint Call this function to figure out the on-screen position of the object.	FlxObject
		hitBottom(Contact:FlxObject, Velocity:Number):void Called when this object's bottom edge collides with the top of another FlxObject.	FlxObject
		hitLeft(Contact:FlxObject, Velocity:Number):void Called when this object's left side collides with another FlxObject's right.	FlxObject
		hitRight(Contact:FlxObject, Velocity:Number):void Called when this object's right side collides with another FlxObject's left.	FlxObject
		hitTop(Contact:FlxObject, Velocity:Number):void Called when this object's top collides with the bottom of another FlxObject.	FlxObject
		hurt(Damage:Number):void Call this function to "damage" (or give health bonus) to this sprite.	FlxObject
		kill():void [override] Calls kill on the group and all its members.	FlxGroup
		loadGraphic(Image:FlxSprite, ImageHighlight:FlxSprite = null):FlxButton Set your own image as the button background.	FlxButton
		loadText(Text:FlxText, TextHighlight:FlxText = null):FlxButton Add a text label to the button.	FlxButton
		onScreen():Boolean Check and see if this object is currently on screen.	FlxObject
		overlaps(Object:FlxObject):Boolean Checks to see if some FlxObject object overlaps this FlxObject object.	FlxObject
		overlapsPoint(X:Number, Y:Number, PerPixel:Boolean = false):Boolean Checks to see if a point in 2D space overlaps this FlxObject object.	FlxObject
		preCollide(Object:FlxObject):void FlxU.collide() (and thus FlxObject.collide()) call this function each time two objects are compared to see if they collide.	FlxObject
		refreshHulls():void Called by FlxObject.updateMotion() and some constructors to rebuild the basic collision data for this object.	FlxObject
		remove(Object:FlxObject, Splice:Boolean = false):FlxObject Removes an object from the group.	FlxGroup
		render():void [override] Automatically goes through and calls render on everything you added, override this loop to control render order manually.	FlxGroup
		replace(OldObject:FlxObject, NewObject:FlxObject):FlxObject Replaces an existing FlxObject with a new one.	FlxGroup
		reset(X:Number, Y:Number):void [override] If the group's position is reset, we want to reset all its members too.	FlxGroup
		resetFirstAvail(X:Number = 0, Y:Number = 0):Boolean Finds the first object with exists == false and calls reset on it.	FlxGroup
		toString():String [override]	FlxGroup
		update():void [override] Called by the game loop automatically, handles mouseover and click detection.	FlxButton

	Method	Defined By
		destroyMembers():void Internal function that actually loops through and destroys each member.	FlxGroup
		killMembers():void Internal function that calls kill on all members.	FlxGroup
		onMouseUp(event:MouseEvent):void Internal function for handling the actual callback call (for UI thread dependent calls like FlxU.openURL()).	FlxButton
		renderMembers():void Internal function that actually loops through and renders all the group members.	FlxGroup
		saveOldPosition():void Internal function, helps with the moving/updating of group members.	FlxGroup
		updateFlickering():void Just updates the retro-style flickering.	FlxObject
		updateMembers():void Internal function that actually goes through and updates all the group members.	FlxGroup
		updateMotion():void Internal function for updating the position and speed of this object.	FlxObject
		visibility(On:Boolean):void Internal function for handling the visibility of the off and on graphics.	FlxButton

	Constant	Defined By
		_pZero : FlxPoint [static] A handy "empty point" object	FlxObject

Property Detail

_callback

property

protected var _callback:Function

This function is called when the button is clicked.

_initialized

property

protected var _initialized:Boolean

Whether or not the button has initialized itself yet.

_off

property

protected var _off:FlxSprite

Stores the 'off' or normal button state graphic.

_offT

property

protected var _offT:FlxText

Stores the 'off' or normal button state label.

_on

property

protected var _on:FlxSprite

Stores the 'on' or highlighted button state graphic.

_onT

property

protected var _onT:FlxText

Stores the 'on' or highlighted button state label.

_onToggle

property

protected var _onToggle:Boolean

Used for checkbox-style behavior.

_pressed

property

protected var _pressed:Boolean

Tracks whether or not the button is currently pressed.

_sf

property

protected var _sf:FlxPoint

Helper variable for correcting its members' scrollFactor objects.

property

on:Boolean

Use this to toggle checkbox-style behavior.

Implementation
public function get on():Boolean
public function set on(value:Boolean):void

Constructor Detail

FlxButton

()

Constructor

public function FlxButton(X:int, Y:int, Callback:Function)

Creates a new FlxButton object with a gray background and a callback function on the UI thread.

Parameters

	`X:int` — The X position of the button.

	`Y:int` — The Y position of the button.

	`Callback:Function` — The function to call whenever the button is clicked.

Method Detail

destroy

()

method

override public function destroy():void

Called by the game state when state is changed (if this object belongs to the state)

loadGraphic

()

method

public function loadGraphic(Image:FlxSprite, ImageHighlight:FlxSprite = null):FlxButton

Set your own image as the button background.

Parameters

	`Image:FlxSprite` — A FlxSprite object to use for the button background.

	`ImageHighlight:FlxSprite` (default = `null`) — A FlxSprite object to use for the button background when highlighted (optional).

Returns

FlxButton — This FlxButton instance (nice for chaining stuff together, if you're into that).

loadText

()

method

public function loadText(Text:FlxText, TextHighlight:FlxText = null):FlxButton

Add a text label to the button.

Parameters

	`Text:FlxText` — A FlxText object to use to display text on this button (optional).

	`TextHighlight:FlxText` (default = `null`) — A FlxText object that is used when the button is highlighted (optional).

Returns

FlxButton — This FlxButton instance (nice for chaining stuff together, if you're into that).

onMouseUp

()

method

protected function onMouseUp(event:MouseEvent):void

Internal function for handling the actual callback call (for UI thread dependent calls like FlxU.openURL()).

Parameters

event:MouseEvent

update

()

method

override public function update():void

Called by the game loop automatically, handles mouseover and click detection.

visibility

()

method

protected function visibility(On:Boolean):void

Internal function for handling the visibility of the off and on graphics.

Parameters

On:Boolean — Whether the button should be on or off.

Sun Apr 17 2011, 12:17 AM -07:00

API Documentation	All Packages \| All Classes \| Index \| Frames No Frames
FlxButton	Properties \| Methods

Package	org.flixel
Class	public class FlxButton
Inheritance	FlxButton FlxGroup FlxObject FlxRect FlxPoint Object