| Пакет | mx.core |
| Класс | public class BitmapAsset |
| Наследование | BitmapAsset  FlexBitmap Bitmap DisplayObject EventDispatcher Object |
| Реализует | IFlexAsset, IFlexDisplayObject, ILayoutDirectionElement |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Встраиваемое растровое изображение может быть расположено в файле JPEG, GIF или PNG. Можно также встроить растровый символ, расположенный в SWF-файле, созданном Flash. В обоих случаях компилятор MXML автоматически создает класс, который расширяет класс BitmapAsset для представления встроенного растрового изображения.
Класс BitmapAsset, как правило, не используется при создании приложения Flex напрямую. Например, можно встроить GIF-файл и отобразить изображение в элементе управления Image при помощи следующего кода:
<mx:Image id="logo" source="@Embed(source='Logo.gif')"/>
или можно использовать его как фоновое изображение приложения в синтаксисе CSS при помощи следующего кода:
<fx:Style>
@namespace mx "library://ns.adobe.com/flex/mx"
mx|Application {
backgroundImage: Embed(source="Logo.gif")
}
<fx:Style/>
Для этого необязательно учитывать, что компилятор MXML создал подкласс BitmapAsset.
При этом понимание процессов на уровне ActionScript может оказаться полезным. Для встраивания растрового изображения в ActionScript объявляется переменная типа Class, в которой размещаются метаданные [Embed]. Например, GIF-файл встраивается следующим образом:
[Bindable] [Embed(source="Logo.gif")] private var logoClass:Class;
Компилятор MXML определяет расширение .gif, преобразует данные GIF в растровый формат, используемый в проигрывателе, автоматически создает подкласс класса BitmapAsset и настраивает переменную, которая становится ссылкой на этот автоматически созданный класс. Это ссылку класса затем можно использовать для создания экземпляров BitmapAsset при помощи оператора new, для которых можно использовать интерфейс API класса BitmapAsset:
var logo:BitmapAsset = BitmapAsset(new logoClass()); logo.bitmapData.noise(4);
Однако самостоятельное создание экземпляров BitmapAsset необходимо в редких случаях, так как свойства и стили изображения могут быть установлены в классе, порождающем изображение, а его компоненты создадут все необходимые экземпляры. Например, для отображения этого изображения в элементе управления Image можно установить свойство Image source на logoClass. В MXML это выполняется следующим образом:
<mx:Image id="logo" source="{logoClass}"/>
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | accessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта. | DisplayObject | |
| alpha : Number
Указывает значение альфа-прозрачности заданного объекта. | DisplayObject | |
| bitmapData : BitmapData
Объект BitmapData, указанный в ссылке. | Bitmap | |
| blendMode : String
Значение класса BlendMode, задающее режим наложения. | DisplayObject | |
| blendShader : Shader [только для записи]
Задает затенение, используемое при наложении переднего плана на фон. | DisplayObject | |
| cacheAsBitmap : Boolean
При значении true среда выполнения Flash кэширует внутреннее растровое представление экранного объекта. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
Если задано ненулевое значение, данный объект Matrix определяет способ визуализации экранного объекта, когда свойство cacheAsBitmap имеет значение true. | DisplayObject | |
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| filters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом. | DisplayObject | |
| height : Number
Указывает высоту экранного объекта в пикселях. | DisplayObject | |
| layoutDirection : String
Определяет требуемое направление макета для элемента: один из LayoutDirection.LTR (слева направо), LayoutDirection.RTL (справа налево) или null (наследование). | BitmapAsset | ||
| loaderInfo : LoaderInfo [только для чтения]
Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект. | DisplayObject | |
| mask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask. | DisplayObject | |
| measuredHeight : Number [только для чтения]
Рассчитанная высота этого объекта. | BitmapAsset | ||
| measuredWidth : Number [только для чтения]
Измеренная ширина этого объекта. | BitmapAsset | ||
| metaData : Object
Получает объект метаданных экземпляра DisplayObject, если метаданные хранились вместе с экземпляром этого DisplayObject в SWF-файле через тег PlaceObject4. | DisplayObject | |
| mouseX : Number [только для чтения]
Указывает координату x мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | |
| mouseY : Number [только для чтения]
Указывает координату y мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | |
| name : String
Указывает имя экземпляра DisplayObject. | DisplayObject | |
| opaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона. | DisplayObject | |
| parent : DisplayObjectContainer [только для чтения]
Указывает объект DisplayObjectContainer, содержащий данный экранный объект. | DisplayObject | |
| pixelSnapping : String
Определяет, должен ли объект Bitmap быть привязанным к ближайшему пикселю. | Bitmap | |
| root : DisplayObject [только для чтения]
В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом. | DisplayObject | |
| rotation : Number
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах). | DisplayObject | |
| rotationX : Number
Обозначает поворот в градусах по оси x экземпляра DisplayObject относительно исходной ориентации по трехмерному вышестоящему контейнеру. | DisplayObject | |
| rotationY : Number
Обозначает угол поворота в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру. | DisplayObject | |
| rotationZ : Number
Обозначает поворот в градусах по оси z экземпляра DisplayObject от исходной ориентации относительно трехмерного родительского контейнера. | DisplayObject | |
| scale9Grid : Rectangle
Текущая активная сетка масштабирования. | DisplayObject | |
| scaleX : Number
Указывает горизонтальное масштабирование объекта от точки регистрации (в процентах). | DisplayObject | |
| scaleY : Number
Указывает вертикальное масштабирование объекта от точки регистрации (в процентах). | DisplayObject | |
| scaleZ : Number
Указывает глубину масштабирования объекта (в процентах) относительно точки регистрации этого объекта. | DisplayObject | |
| scrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта. | DisplayObject | |
| smoothing : Boolean
Определяет, следует ли сглаживать растровое изображение при масштабировании. | Bitmap | |
| stage : Stage [только для чтения]
Класс Stage экранного объекта. | DisplayObject | |
| transform : flash.geom:Transform
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта. | DisplayObject | |
| visible : Boolean
Определяет видимость экранного объекта. | DisplayObject | |
| width : Number
Указывает ширину экранного объекта в пикселях. | DisplayObject | |
| x : Number
Указывает координату x экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer. | DisplayObject | |
| y : Number
Указывает координату y экземпляра DisplayObject, связанную с локальными координатами родительского DisplayObjectContainer. | DisplayObject | |
| z : Number
Указывает положение по оси z экземпляра DisplayObject относительно трехмерного родительского контейнера. | DisplayObject | |
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | BitmapAsset | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
|
Посылает событие в поток событий. | EventDispatcher | |
|
Возвращает прямоугольник, определяющий область объекта отображения, которая относится к системе координат объекта targetCoordinateSpace. | DisplayObject | |
|
Возвращает прямоугольник, определяющий границу объекта отображения по системе координат, определенной параметром targetCoordinateSpace за исключением линий фигур. | DisplayObject | |
|
Преобразует объект Point из координат рабочей области (глобальных) в координаты отображаемого объекта (локальные). | DisplayObject | |
|
Преобразует двумерный объект Point из координат рабочей области (глобальных) в координаты экранного трехмерного объекта (локальные). | DisplayObject | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Вычисляет ограничительную рамку экранного объекта, чтобы определить, не перекрывает и не пересекает ли она ограничительную рамку экранного объекта obj. | DisplayObject | |
|
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее. | DisplayObject | |
Элемент должен вызывать этот метод при изменении своего layoutDirection или при изменении своего вышестоящего layoutDirection. | BitmapAsset | ||
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Преобразует трехмерный объект point из координат трехмерного экранного объекта (локальных) в двухмерный объект point с координатами рабочей области (глобальными). | DisplayObject | |
|
Преобразует объект Point из координат экранного объекта (локальных) в координаты рабочей области (глобальные). | DisplayObject | |
Перемещает этот объект по указанным координатам осей x и y. | BitmapAsset | ||
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
Устанавливает фактический размер для этого объекта. | BitmapAsset | ||
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
| [переопределить]
Возвращает строку, указывающую расположение этого объекта в иерархии объектов DisplayObject в приложении. | FlexBitmap | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
layoutDirection | свойство |
layoutDirection:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.1 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Определяет требуемое направление макета для элемента: один из LayoutDirection.LTR (слева направо), LayoutDirection.RTL (справа налево) или null (наследование). Это свойство обычно основано на стиле наследования. Если null, то для стиля layoutDirection устанавливается значение undefined. Классы, например GraphicElement, которые реализуют ILayoutDirectionElement, но не поддерживают стили, должны дополнительно поддерживать значение null для этого свойства, т. е. layoutDirection должен быть унаследован из своего вышестоящего элемента.
Реализация
public function get layoutDirection():String public function set layoutDirection(value:String):voidmeasuredHeight | свойство |
measuredHeight:Number [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Рассчитанная высота этого объекта.
Как правило, для графических тем оформления выполняется жесткая кодировка, так как это число представляет собой всего лишь число пикселей в графике. Для тем оформления кода также может использоваться жесткая кодировка для выполнения рисунка определенного размера. При изменении размера в зависимости от свойств, возможно, потребуется использование ILayoutManagerClient, что приведет к вызову метода measure() в нужное время и позволит вычислить measuredHeight.
Реализация
public function get measuredHeight():NumbermeasuredWidth | свойство |
measuredWidth:Number [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Измеренная ширина этого объекта.
Как правило, для графических тем оформления выполняется жесткая кодировка, так как это число представляет собой всего лишь число пикселей в графике. Для тем оформления кода также может использоваться жесткая кодировка для выполнения рисунка определенного размера. При изменении размера в зависимости от свойств, возможно, потребуется использование ILayoutManagerClient, что приведет к вызову метода measure() в нужное время и позволит вычислить measuredHeight.
Реализация
public function get measuredWidth():NumberBitmapAsset | () | Конструктор |
public function BitmapAsset(bitmapData:BitmapData = null, pixelSnapping:String = "auto", smoothing:Boolean = false)| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конструктор.
ПараметрыbitmapData:BitmapData (default = null) | |
pixelSnapping:String (default = "auto") | |
smoothing:Boolean (default = false) |
invalidateLayoutDirection | () | метод |
public function invalidateLayoutDirection():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.1 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Элемент должен вызывать этот метод при изменении своего layoutDirection или при изменении своего вышестоящего layoutDirection. Если они различаются, этот метод отвечает за зеркальное отображение содержимого элемента и за обновление преобразования элемента после создания макета, чтобы нижестоящие элементы могли наследовать отображенную зеркально систему координат. Объекты IVisualElements обычно реализуют зеркальное отображение с помощью свойства postLayoutTransformOffsets, которое масштабирует ось X на -1 и изменяет координату x начальной позиции по ширине элемента. Фактическим результатом такого зеркального преобразования является то, что направление, в котором повышается значение оси Х, меняется на обратное без изменения местоположения объекта относительно начальной позиции вышестоящего элемента.
move | () | метод |
public function move(x:Number, y:Number):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Перемещает этот объект по указанным координатам осей x и y.
Параметры
x:Number — Новая позиция по оси x для этого объекта.
| |
y:Number — Новая позиция по оси y для этого объекта.
|
setActualSize | () | метод |
public function setActualSize(newWidth:Number, newHeight:Number):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Устанавливает фактический размер для этого объекта.
Этот метод главным образом используется в реализации метода updateDisplayList(), в котором вы вычисляете фактический размер этого объекта, основанный на его явном размере, размере по отношению к вышестоящему элементу (процент от его размера), а также измеренный размер. Далее путем вызова метода setActualSize() вы применяете этот фактический размер к объекту.
В других ситуациях вместо вызова этого метода требуется установка свойств, например width, height, percentWidth или percentHeight.
Параметры
newWidth:Number — Новая ширина для этого объекта.
| |
newHeight:Number — Новая высота для этого объекта.
|
Tue Jun 12 2018, 11:34 AM Z