| Пакет | spark.preloaders |
| Класс | public class SplashScreenImage |
| Наследование | SplashScreenImage  Object |
| Реализует | IMXMLObject |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.6 |
| Версии среды выполнения: | AIR 3 |
Класс SplashScreenImage обычно определяется в файле MXML. В классе SplashScreenImageSource можно указать различные изображения для выбора и соответствующие характеристики устройств. Затем для свойства splashScreenImage приложения указывается имя MXML-компонента SplashScreenImage.
Ниже представлены действия по поиску наиболее точного соответствия между определением SplashScreenImageSource и мобильным устройством.
- Укажите все определения SplashScreenImageSource, которые соответствуют параметрам мобильного устройства. Соответствие определяется в следующих случаях:
- Этот параметр не указан явно в определении SplashScreenImageSource. Например, ни один параметр свойства
dpiне соответствует DPI любого устройства. - Свойства
dpiилиaspectRatioдолжны точно соответствовать параметрам мобильного устройства. - Свойство
minResolutionсоответствует параметру устройства, если наиболее высокое из значений свойствStage.stageWidthиStage.stageHeightбольше или равноminResolution.
- Этот параметр не указан явно в определении SplashScreenImageSource. Например, ни один параметр свойства
- Если устройству соответствует более одного определения SplashScreenImageSource:
- Выберите определение с наибольшим количеством явных параметров. Например, определение SplashScreenImageSource, указывающее свойства
dpiиaspectRatio, является более точным соответствием, чем определение, указывающее только свойствоdpi. - При наличии нескольких совпадений выберите определение с наиболее высоким значением
minResolution. - При наличии нескольких совпадений выберите то, которое указано первым в компоненте.
- Выберите определение с наибольшим количеством явных параметров. Например, определение SplashScreenImageSource, указывающее свойства
Примечание. Этот класс невозможно встроить в MXML приложения. Его необходимо определить в отдельном файле MXML и создать на него ссылку с помощью свойства splashScreenImage приложения.
Показать синтаксис MXML
Скрыть синтаксис 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>
Свойство MXML по умолчаниюmxmlContent
Связанные элементы API
| Свойство | Определено | ||
|---|---|---|---|
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| mxmlContent : Array
Источники SplashScreenImageSource для этого SplashScreenImage. | SplashScreenImage | ||
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | SplashScreenImage | ||
Возвращает Class в SplashScreenImageSource, который наиболее точно соответствует указанным параметрам устройства. | SplashScreenImage | ||
|
Показывает, определено ли заданное свойство для объекта. | Object | |
Вызывается после создания объекта реализации и инициализации всех свойств компонентов, указанных в теге MXML. | SplashScreenImage | ||
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
mxmlContent | свойство |
mxmlContent:Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.6 |
| Версии среды выполнения: | AIR 3 |
Источники SplashScreenImageSource для этого SplashScreenImage. Этот метод обычно не вызывается напрямую. Вместо этого определения SplashScreenImageSource встраиваются в файл MXML компонента SplashScreenImage.
Реализация
public function get mxmlContent():Array public function set mxmlContent(value:Array):void SplashScreenImage | () | Конструктор |
public function SplashScreenImage()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.6 |
| Версии среды выполнения: | AIR 3 |
Конструктор.
getImageClass | () | метод |
public function getImageClass(aspectRatio:String, dpi:Number, resolution:Number):Class| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.6 |
| Версии среды выполнения: | AIR 3 |
Возвращает Class в SplashScreenImageSource, который наиболее точно соответствует указанным параметрам устройства.
Этот метод вызывается не напрямую, а внутри Flex.
Если необходимо изменить стандартную логику Flex по поиску наиболее точного соответствия для экземпляра SplashScreenImageSource, этот метод можно переопределить в компоненте SplashScreenImage.
Параметры
aspectRatio:String — Свойство с наиболее высоким значением: flash.display.StageAspectRatio.PORTRAIT или flash.display.StageAspectRatio.LANDSCAPE.
| |
dpi:Number — DPI мобильного устройства.
| |
resolution:Number — Разрешение экрана мобильного устройства с большей размерностью, в пикселах.
|
Class — Класс изображения, используемого в качестве заставки.
|
Связанные элементы API
initialized | () | метод |
public function initialized(document:Object, id:String):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.6 |
| Версии среды выполнения: | AIR 3 |
Вызывается после создания объекта реализации и инициализации всех свойств компонентов, указанных в теге MXML.
Параметры
document:Object — Документ MXML, создавший этот объект.
| |
id:String — Идентификатор, используемый document в качестве ссылки на этот объект. Если объект представляет собой глубокое свойство document, идентификатор 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, 11:34 AM Z