FMXISButtonMomentary

Availability

Flash Player 6 r65.

Description

This class is a simple momentary button with repeat-on-down functionality that also allows developers to swap out the button graphics dynamically, based on specified linkage ID's of the up and down graphics (upLinkID and downLinkID, respectively). Unlike some of the other components, developers can change the graphics on the fly, not just through the property inspector or at initialization time.

For the FLA version of the component, designers can change the appearance by changing the defaultButUp and defaultButDn movie clips in the Library.

The class has six events, by default called:

• onPress - Generated when button first pressed, and repeated at specified frequency
• onRelease - Generated when button released
• onReleaseOutside - Generated when button released outside confines of the hit area
• onRollOver - Generated when cursor rolls over button hit area
• onRollOut - Generated when cursor rolls out of button hit area
• onDragOut - Generated when cursor rolls out of button hit area while left mouse button down

The event names can be changed (if desired) in the component property inspector, on initialization through the initObject of attachMovie(), or programmatically through the respective property.

Technical Note: If you poke around the class definitions, defined in Classes > mx > fmxis, you will see this component's superclasses, FMXISButton and FMXISButtonRepeater. We did not expose these as components because the functionality is completely subsumed by FMXISButtonMomentary.

Code Hinting

The suffix of variables recognized for codehinting purposes as FMXISButtonMomentary's is _butMoment.