Package | spark.preloaders |
Class | public class SplashScreenImage |
Inheritance | SplashScreenImage ![]() |
Implements | IMXMLObject |
Language Version: | ActionScript 3.0 |
Product Version: | Flex 4.6 |
Runtime Versions: | AIR 3 |
You typically define a SplashScreenImage class
in an MXML file.
Use the SplahsScreenImageSource class to define the different
image choices and corresponding device configurations.
You then set the application's splashScreenImage
property to the name of the SplashScreenImage
MXML component.
The procedure for determining the best match of an SplahsScreenImageSource definition to a mobile device is as follows:
- Determine all of the SplashScreenImageSource definitions
that match the settings of the mobile device.
A match occurs when:
- The SplashScreenImageSource definition does not have that setting explicitly defined.
For example, no setting for the
dpi
property matches any device's DPI. - For the
dpi
oraspectRatio
property, the property must exactly match the corresponding setting of the mobile device. - For the
minResolution
property, the property matches a setting on the device when the larger of theStage.stageWidth
andStage.stageHeight
properties is equal to or greater thanminResolution
.
- The SplashScreenImageSource definition does not have that setting explicitly defined.
For example, no setting for the
- If there's more than one SplashScreenImageSource definition that matches the device then:
- Choose the one with largest number of explicit settings.
For example, a SplashScreenImageSource definition that specifies both the
dpi
andaspectRatio
properties is a better match than one that only species thedpi
property. - If there is still more than one match, choose the one with highest
minResolution
value. - If there is still more than one match, choose the first one defined in the component.
- Choose the one with largest number of explicit settings.
For example, a SplashScreenImageSource definition that specifies both the
Note: This class cannot be set inline in the MXML of the application.
You must define it in a separate MXML file and reference it by using the
application's splashScreenImage
property.

The <s:SplashScreenImage>
tag inherits all of the tag
attributes of its superclass and adds no new tag attributes:
<s:SplashScreenImage xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark"> <!-- Define one or more SplashScreenImageSource. --> <s:SplashScreenImageSource source="@Embed('assets/logoDefault.jpg')"/> <s:SplashScreenImageSource source="@Embed('assets/logo240Portrait.jpg')" dpi="240" aspectRatio="portrait"/> </s:SplashScreenImage>
Default MXML PropertymxmlContent
Related API Elements
Property | Defined By | ||
---|---|---|---|
![]() | constructor : Object
A reference to the class object or constructor function for a given object instance. | Object |
Method | Defined By | ||
---|---|---|---|
![]() |
Indicates whether an object has a specified property defined. | Object | |
![]() |
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter. | Object | |
![]() |
Indicates whether the specified property exists and is enumerable. | Object | |
![]() |
Sets the availability of a dynamic property for loop operations. | Object | |
![]() |
Returns the string representation of this object, formatted according to locale-specific conventions. | Object | |
![]() |
Returns the string representation of the specified object. | Object | |
![]() |
Returns the primitive value of the specified object. | Object |
<?xml version="1.0" encoding="utf-8"?> <s:ViewNavigatorApplication xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark" firstView="views.DynamicSplashScreenExample1HomeView" splashScreenImage="SplashScreenImage1"> </s:ViewNavigatorApplication>
<?xml version="1.0" encoding="utf-8"?> <s:View xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark" title="HomeView"> <fx:Declarations> <!-- Place non-visual elements (e.g., services, value objects) here --> </fx:Declarations> </s:View>
<?xml version="1.0" encoding="utf-8"?> <s:SplashScreenImage xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark"> <fx:Script> <![CDATA[ [Embed("soccer-ball.jpg")] private var andImage:Class; override public function getImageClass(aspectRatio:String, dpi:Number, resolution:Number):Class { // Are we running on IOS ? if (Capabilities.version.indexOf("IOS") == 0) return andImage; return super.getImageClass(aspectRatio, dpi, resolution); } ]]> </fx:Script> <!-- no settings, so this acts as default--> <s:SplashScreenImageSource source="@Embed('image_not_found.jpg')"/> <!-- specific settings --> <s:SplashScreenImageSource source="@Embed('pinkball.jpg')" dpi="160" minResolution="0"/> <s:SplashScreenImageSource source="@Embed('yellowball.jpg')" dpi="160" minResolution="500"/> <s:SplashScreenImageSource source="@Embed('orangball.png')" dpi="160" minResolution="1000"/> <s:SplashScreenImageSource source="@Embed('yellowball.jpg')" dpi="160" minResolution="1000" aspectRatio="portrait"/> <s:SplashScreenImageSource source="@Embed('yellowball.jpg')" dpi="240" aspectRatio="portrait"/> <s:SplashScreenImageSource source="@Embed('pinkball.jpg')" dpi="240" aspectRatio="landscape"/> <s:SplashScreenImageSource source="@Embed('pinkball.jpg')" dpi="320"/> </s:SplashScreenImage>
Wed Nov 21 2018, 06:34 AM -08:00