Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
spark.preloaders 

SplashScreenImage  - AS3 Flex

Пакетspark.preloaders
Классpublic class SplashScreenImage
НаследованиеSplashScreenImage Inheritance Object
Реализует IMXMLObject

Язык версии: ActionScript 3.0
Версия продукта: Flex 4.6
Версии среды выполнения: AIR 3

В классе SplashScreenImage можно указать различные изображения заставок экрана на основе характеристик мобильного устройства. Например, в зависимости от DPI, ориентации или разрешения экрана устройства можно выбрать различные изображения для заставок экрана.

Класс SplashScreenImage обычно определяется в файле MXML. В классе SplashScreenImageSource можно указать различные изображения для выбора и соответствующие характеристики устройств. Затем для свойства splashScreenImage приложения указывается имя MXML-компонента SplashScreenImage.

Ниже представлены действия по поиску наиболее точного соответствия между определением SplashScreenImageSource и мобильным устройством.

  1. Укажите все определения SplashScreenImageSource, которые соответствуют параметрам мобильного устройства. Соответствие определяется в следующих случаях:
    • Этот параметр не указан явно в определении SplashScreenImageSource. Например, ни один параметр свойства dpi не соответствует DPI любого устройства.
    • Свойства dpi или aspectRatio должны точно соответствовать параметрам мобильного устройства.
    • Свойство minResolution соответствует параметру устройства, если наиболее высокое из значений свойств Stage.stageWidth и Stage.stageHeight больше или равно minResolution.
  2. Если устройству соответствует более одного определения SplashScreenImageSource:
    • Выберите определение с наибольшим количеством явных параметров. Например, определение SplashScreenImageSource, указывающее свойства dpi и aspectRatio, является более точным соответствием, чем определение, указывающее только свойство dpi.
    • При наличии нескольких совпадений выберите определение с наиболее высоким значением minResolution.
    • При наличии нескольких совпадений выберите то, которое указано первым в компоненте.

Примечание. Этот класс невозможно встроить в MXML приложения. Его необходимо определить в отдельном файле MXML и создать на него ссылку с помощью свойства splashScreenImage приложения.

Синтаксис MXMLexpandedСкрыть синтаксис 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



Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
      mxmlContent : Array
Источники SplashScreenImageSource для этого SplashScreenImage.
SplashScreenImage
Общедоступные методы
 МетодОпределено
  
Конструктор.
SplashScreenImage
  
    getImageClass(aspectRatio:String, dpi:Number, resolution:Number):Class
Возвращает Class в SplashScreenImageSource, который наиболее точно соответствует указанным параметрам устройства.
SplashScreenImage
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
  
    initialized(document:Object, id:String):void
Вызывается после создания объекта реализации и инициализации всех свойств компонентов, указанных в теге MXML.
SplashScreenImage
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
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.

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>




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.