Paket | spark.preloaders |
Klasse | public class SplashScreenImage |
Vererbung | SplashScreenImage Object |
Implementiert | IMXMLObject |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.6 |
Laufzeitversionen: | AIR 3 |
Eine SplashScreenImage-Klasse wird in der Regel in einer MXML-Datei definiert. Definieren Sie die SplashScreenImageSource-Klasse über diverse Bildauswahlen und korrespondierende Gerätekonfigurationen. Dann stellen Sie die Eigenschaft splashScreenImage
der Anwendung auf den Namen der MXML-Komponente SplashScreenImage
ein.
Die Prozedur zur Ermittlung der passenden SplashScreenImageSource-Definition zu einem mobilen Gerät sieht wie folgt aus:
- Bestimmen Sie alle SplashScreenImageSource-Definitionen, die zu den Einstellungen des mobilen Geräts passen. Zu einer Übereinstimmung kommt es, wenn:
- Die Einstellung in der SplashScreenImageSource-Definition nicht ausdrücklich festgelegt ist. Zum Beispiel passen die Einstellungen der
dpi
-Eigenschaft zu keinem DPI-Wert eines Geräts. - Die Eigenschaft
dpi
oderaspectRatio
muss genau mit der entsprechenden Einstellung des mobilen Geräts übereinstimmen. - Die Eigenschaft
minResolution
entspricht einer Einstellung auf dem Gerät, wenn der größere Wert der EigenschaftenStage.stageWidth
oderStage.stageHeight
größer gleichminResolution
ist.
- Die Einstellung in der SplashScreenImageSource-Definition nicht ausdrücklich festgelegt ist. Zum Beispiel passen die Einstellungen der
- Wenn es mehr als eine passende SplashScreenImageSource-Definition zu einem Gerät gibt:
- Wählen Sie die Definition mit den meisten expliziten Einstellungen. Beispiel: Eine SplashScreenImageSource-Definition, in der sowohl die Eigenschaft
dpi
als auchaspectRatio
festgelegt ist, führt zu einer besseren Übereinstimmung als eine Definition, die nur die Eigenschaftdpi
bietet. - Wenn es noch mehr Übereinstimmungen gibt, wählen Sie diejenige mit dem höchsten
minResolution
-Wert. - Wenn es immer noch mehr als eine Übereinstimmung gibt, wählen Sie die erste in der Komponente definierte Übereinstimmung.
- Wählen Sie die Definition mit den meisten expliziten Einstellungen. Beispiel: Eine SplashScreenImageSource-Definition, in der sowohl die Eigenschaft
Hinweis: Diese Klasse kann nicht inline in der MXML der Anwendung festgelegt werden. Die Klasse muss in einer separaten MXML-Datei definiert werden und über die Eigenschaft splashScreenImage
der Anwendung referenziert werden.
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>
Standard-MXML-EigenschaftmxmlContent
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
mxmlContent : Array
Die SplashScreenImageSource-Quellen für dieses SplashScreenImage. | SplashScreenImage |
Methode | Definiert von | ||
---|---|---|---|
Konstruktor. | SplashScreenImage | ||
Gibt die Klasse der SplashScreenImageSource, die am besten mit den angegebenen Geräteparametern übereinstimmt, zurück. | SplashScreenImage | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Wird aufgerufen, nachdem das Implementierungsobjekt erstellt und sämtliche im MXML-Tag angegebenen Komponenteneigenschaften initialisiert wurden. | SplashScreenImage | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
mxmlContent | Eigenschaft |
mxmlContent:Array
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.6 |
Laufzeitversionen: | AIR 3 |
Die SplashScreenImageSource-Quellen für dieses SplashScreenImage
. Normalerweise wird diese Methode nicht direkt vom Benutzer aufgerufen. Stattdessen fügen Sie inline SplashScreenImageSource-Definitionen in der MXML-Datei der SplashScreenImage-Komponente hinzu.
Implementierung
public function get mxmlContent():Array
public function set mxmlContent(value:Array):void
SplashScreenImage | () | Konstruktor |
public function SplashScreenImage()
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.6 |
Laufzeitversionen: | AIR 3 |
Konstruktor.
getImageClass | () | Methode |
public function getImageClass(aspectRatio:String, dpi:Number, resolution:Number):Class
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.6 |
Laufzeitversionen: | AIR 3 |
Gibt die Klasse der SplashScreenImageSource, die am besten mit den angegebenen Geräteparametern übereinstimmt, zurück.
Diese Methode wird nicht direkt aufgerufen, sondern wird intern von Flex aufgerufen.
Überschreiben Sie diese Methode in einer SplashScreenImage-Komponente, wenn Sie die Standard-Flex-Logik, die passendste SplashScreenImageSource-Instanz auszusuchen, außer Kraft setzen möchten.
Parameter
aspectRatio:String — Entweder flash.display.StageAspectRatio.PORTRAIT oder flash.display.StageAspectRatio.LANDSCAPE , je nachdem, was größer ist.
| |
dpi:Number — Der DPI-Wert des mobilen Geräts.
| |
resolution:Number — Die Auflösung der größeren Abmessungen des mobilen Geräts in Pixeln.
|
Class — Die Klasse für das Bild, das als Bild des Begrüßungsbildschirms angezeigt werden soll.
|
Verwandte API-Elemente
initialized | () | Methode |
public function initialized(document:Object, id:String):void
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4.6 |
Laufzeitversionen: | AIR 3 |
Wird aufgerufen, nachdem das Implementierungsobjekt erstellt und sämtliche im MXML-Tag angegebenen Komponenteneigenschaften initialisiert wurden.
Parameter
document:Object — Das MXML-Dokument, das dieses Objekt erstellt hat.
| |
id:String — Der von document für den Verweis auf dieses Objekt verwendete Bezeichner. Wenn das Objekt eine verschachtelte Eigenschaft in document ist, ist id „ 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, 10:04 AM Z