SplashScreenImage

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

Utilisez la classe SplashScreenImage pour spécifier des images d’écran de démarrage différentes selon les caractéristiques d’un périphérique mobile. Par exemple, vous pouvez utiliser des images différentes pour un écran de démarrage selon la résolution PPP, l’orientation ou la résolution du périphérique.

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é dpi ne correspond à la résolution PPP d’un périphérique.
- Pour les propriétés dpi ou aspectRatio, 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és Stage.stageWidth et Stage.stageHeight est égale ou supérieure à minResolution.
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 dpi et aspectRatio é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 minResolution la plus élevée.
- S’il existe toujours plusieurs correspondances, choisissez la première définie dans le composant.

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.

Syntaxe MXML expanded

Masquer la syntaxe 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>

Propriété MXML par défautmxmlContent

Consulter les exemples

Eléments de l’API associés

spark.preloaders.SplashScreenImageSource
spark.components.Application.splashScreenImage

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	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éthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		SplashScreenImage() Constructeur.	SplashScreenImage
		getImageClass(aspectRatio:String, dpi:Number, resolution:Number):Class Renvoie la classe de l’élément SplashScreenImageSource correspondant le mieux aux paramètres de périphérique spécifiés.	SplashScreenImage
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		initialized(document:Object, id:String):void 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
		isPrototypeOf(theClass:Object):Boolean 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
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object

Détails de la propriété

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

Détails du constructeur

()

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.

Détails de la méthode

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.

Valeur renvoyée

Class — Classe de l’image à afficher en tant qu’image d’écran de démarrage.

Eléments de l’API associés

flash.display.StageAspectRatio

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.

Exemples Comment utiliser cet exemple

DynamicSplashScreenExample1.mxml

<?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>

DynamicSplashScreenExample1HomeView.mxml

<?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>

SplashScreenImage1.mxml

<?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>

Informations juridiques | Politique de confidentialité en ligne

SplashScreenImage - AS3 Flex

Packagesx

Eléments du langage

Annexes

Package spark.preloaders

mxmlContent