| Package | spark.preloaders |
| Classe | public class SplashScreenImage |
| Héritage | SplashScreenImage  Object |
| Implémente | IMXMLObject |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.6 |
| Versions du moteur d’exécution: | AIR 3 |
En règle générale, vous définissez une classe SplashScreenImage dans un fichier MXML. Utilisez la classe SplahsScreenImageSource pour définir les différents choix d’images et les configurations de périphérique correspondantes. Vous définissez ensuite la propriété splashScreenImage de l’application sur le nom du composant MXML SplashScreenImage.
La procédure permettant de déterminer la meilleure correspondance entre une définition SplahsScreenImageSource et un périphérique mobile est la suivante :
- Déterminez l’ensemble des définitions SplashScreenImageSource qui correspondent aux paramètres du périphérique mobile. Une correspondance existe lorsque :
- Le paramètre n’est pas défini de manière explicite dans la définition SplashScreenImageSource. Par exemple, aucun paramètre pour la propriété
dpine correspond à la résolution PPP d’un périphérique. - Pour les propriétés
dpiouaspectRatio, la propriété doit correspondre exactement au paramètre correspondant du périphérique mobile. - Pour la propriété
minResolution, la propriété correspond à un paramètre sur le périphérique lorsque la plus élevée des propriétésStage.stageWidthetStage.stageHeightest égale ou supérieure àminResolution.
- Le paramètre n’est pas défini de manière explicite dans la définition SplashScreenImageSource. Par exemple, aucun paramètre pour la propriété
- S’il existe plusieurs définitions SplashScreenImageSource qui correspondent au périphérique, alors :
- Choisissez celle comportant le plus grand nombre de paramètres explicites. Par exemple, une définition SplashScreenImageSource qui spécifie à la fois les propriétés
dpietaspectRatioétablit une meilleure correspondance que si elle définit uniquement la propriétédpi. - S’il existe toujours plusieurs correspondances, choisissez celle ayant la valeur
minResolutionla plus élevée. - S’il existe toujours plusieurs correspondances, choisissez la première définie dans le composant.
- Choisissez celle comportant le plus grand nombre de paramètres explicites. Par exemple, une définition SplashScreenImageSource qui spécifie à la fois les propriétés
Remarque : cette classe ne peut pas être définie en ligne dans le fichier MXML de l’application. Vous devez la définir dans un fichier MXML distinct et la référencer à l’aide de la propriété splashScreenImage de l’application.
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <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>
Propriété MXML par défautmxmlContent
Eléments de l’API associés
| Propriété | Défini par | ||
|---|---|---|---|
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| mxmlContent : Array
Sources SplashScreenImageSource pour cette propriété SplashScreenImage. | SplashScreenImage | ||
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | SplashScreenImage | ||
Renvoie la classe de l’élément SplashScreenImageSource correspondant le mieux aux paramètres de périphérique spécifiés. | SplashScreenImage | ||
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
Appelé une fois que l’objet d’implémentation a été créé et que toutes les propriétés de composants spécifiées sur la balise MXML ont été initialisées. | SplashScreenImage | ||
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
mxmlContent | propriété |
mxmlContent:Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.6 |
| Versions du moteur d’exécution: | AIR 3 |
Sources SplashScreenImageSource pour cette propriété SplashScreenImage. Vous ne devez généralement pas appeler cette méthode directement. Au lieu de cela, vous ajoutez des définitions SplashScreenImageSource en ligne dans le fichier MXML du composant SplashScreenImage.
Implémentation
public function get mxmlContent():Array public function set mxmlContent(value:Array):void SplashScreenImage | () | Constructeur |
public function SplashScreenImage()| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.6 |
| Versions du moteur d’exécution: | AIR 3 |
Constructeur.
getImageClass | () | méthode |
public function getImageClass(aspectRatio:String, dpi:Number, resolution:Number):Class| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.6 |
| Versions du moteur d’exécution: | AIR 3 |
Renvoie la classe de l’élément SplashScreenImageSource correspondant le mieux aux paramètres de périphérique spécifiés.
Vous n’appelez pas cette méthode directement, elle est appelée de manière interne par Flex.
Remplacez cette méthode dans un composant SplashScreenImage pour remplacer la logique par défaut de Flex qui choisit l’instance SplashScreenImageSource la plus adaptée.
Paramètres
aspectRatio:String — Soit flash.display.StageAspectRatio.PORTRAIT, soit flash.display.StageAspectRatio.LANDSCAPE, la plus grande valeur des deux.
| |
dpi:Number — Résolution PPP du périphérique.
| |
resolution:Number — Résolution de la plus grande dimension du périphérique mobile en pixels.
|
Class — Classe de l’image à afficher en tant qu’image d’écran de démarrage.
|
Eléments de l’API associés
initialized | () | méthode |
public function initialized(document:Object, id:String):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.6 |
| Versions du moteur d’exécution: | AIR 3 |
Appelé une fois que l’objet d’implémentation a été créé et que toutes les propriétés de composants spécifiées sur la balise MXML ont été initialisées.
Paramètres
document:Object — Document MXML ayant créé cet objet.
| |
id:String — Identifiant utilisé par le document pour se référer à cet objet. Si l’objet est une propriété profonde de la propriété document, id a la valeur 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, 09:30 AM Z