| 패키지 | spark.preloaders |
| 클래스 | public class SplashScreenImage |
| 상속 | SplashScreenImage  Object |
| 구현 | IMXMLObject |
| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 4.6 |
| 런타임 버전: | 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
dpiproperty matches any device's DPI. - For the
dpioraspectRatioproperty, the property must exactly match the corresponding setting of the mobile device. - For the
minResolutionproperty, the property matches a setting on the device when the larger of theStage.stageWidthandStage.stageHeightproperties 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
dpiandaspectRatioproperties is a better match than one that only species thedpiproperty. - If there is still more than one match, choose the one with highest
minResolutionvalue. - 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.
MXML 구문 표시
MXML 구문 숨기기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>
기본 MXML 속성mxmlContent
관련 API 요소
| 속성 | 정의 주체 | ||
|---|---|---|---|
 | constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
| mxmlContent : Array
The SplashScreenImageSource sources for this
SplashScreenImage. | SplashScreenImage | ||
| 메서드 | 정의 주체 | ||
|---|---|---|---|
Constructor. | SplashScreenImage | ||
Returns the Class of the SplashScreenImageSource that best matches
the specified device parameters. | SplashScreenImage | ||
|
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | |
Called after the implementing object has been created and all
component properties specified on the MXML tag have been initialized. | SplashScreenImage | ||
|
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | |
|
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | |
|
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | |
|
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 문자열 표현을 반환합니다. | Object | |
|
지정된 객체의 프리미티브 값을 반환합니다. | Object | |
mxmlContent | 속성 |
mxmlContent:Array| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 4.6 |
| 런타임 버전: | AIR 3 |
The SplashScreenImageSource sources for this
SplashScreenImage.
Typically you do not call this method directly.
Instead, you add SplashScreenImageSource definitions
inline in the MXML file of the SplashScreenImage component.
구현
public function get mxmlContent():Array public function set mxmlContent(value:Array):void SplashScreenImage | () | 생성자 |
public function SplashScreenImage()| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 4.6 |
| 런타임 버전: | AIR 3 |
Constructor.
getImageClass | () | 메서드 |
public function getImageClass(aspectRatio:String, dpi:Number, resolution:Number):Class| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 4.6 |
| 런타임 버전: | AIR 3 |
Returns the Class of the SplashScreenImageSource that best matches the specified device parameters.
You do not call this method directly; it is called internally by Flex.
Override this method in a SplashScreenImage component if you want to override the default Flex logic of picking the best matching SplashScreenImageSource instance.
매개 변수
aspectRatio:String — Either flash.display.StageAspectRatio.PORTRAIT or
flash.display.StageAspectRatio.LANDSCAPE, whichever is greater.
| |
dpi:Number — The DPI of the mobile device.
| |
resolution:Number — The resolution of the mobile device's bigger dimension, in pixels.
|
Class — The Class for the image to be displayed as a splash screen image.
|
관련 API 요소
initialized | () | 메서드 |
public function initialized(document:Object, id:String):void| 언어 버전: | ActionScript 3.0 |
| 제품 버전: | Flex 4.6 |
| 런타임 버전: | AIR 3 |
Called after the implementing object has been created and all component properties specified on the MXML tag have been initialized.
매개 변수
document:Object — The MXML document that created this object.
| |
id:String — The identifier used by document to refer
to this object.
If the object is a deep property on document,
id is null.
|
<?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>
Tue Jun 12 2018, 03:17 PM Z