BitmapAsset

Пакет	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

BitmapAsset является подклассом класса flash.display.Bitmap, представляющего растровые изображения, встраиваемые в приложение Flex. Он реализует интерфейс IFlexDisplayObject, который позволяет встроенному растровому изображению отображаться в элементе управления Image или использоваться в качестве фона контейнера или темы оформления компонента.

Встраиваемое растровое изображение может быть расположено в файле 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(bitmapData:BitmapData = null, pixelSnapping:String = "auto", smoothing:Boolean = false) Конструктор.	BitmapAsset
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	EventDispatcher
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	EventDispatcher
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle Возвращает прямоугольник, определяющий область объекта отображения, которая относится к системе координат объекта targetCoordinateSpace.	DisplayObject
		getRect(targetCoordinateSpace:DisplayObject):Rectangle Возвращает прямоугольник, определяющий границу объекта отображения по системе координат, определенной параметром targetCoordinateSpace за исключением линий фигур.	DisplayObject
		globalToLocal(point:Point):Point Преобразует объект Point из координат рабочей области (глобальных) в координаты отображаемого объекта (локальные).	DisplayObject
		globalToLocal3D(point:Point):Vector3D Преобразует двумерный объект Point из координат рабочей области (глобальных) в координаты экранного трехмерного объекта (локальные).	DisplayObject
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	EventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		hitTestObject(obj:DisplayObject):Boolean Вычисляет ограничительную рамку экранного объекта, чтобы определить, не перекрывает и не пересекает ли она ограничительную рамку экранного объекта obj.	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее.	DisplayObject
		invalidateLayoutDirection():void Элемент должен вызывать этот метод при изменении своего layoutDirection или при изменении своего вышестоящего layoutDirection.	BitmapAsset
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		local3DToGlobal(point3d:Vector3D):Point Преобразует трехмерный объект point из координат трехмерного экранного объекта (локальных) в двухмерный объект point с координатами рабочей области (глобальными).	DisplayObject
		localToGlobal(point:Point):Point Преобразует объект Point из координат экранного объекта (локальных) в координаты рабочей области (глобальные).	DisplayObject
		move(x:Number, y:Number):void Перемещает этот объект по указанным координатам осей x и y.	BitmapAsset
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		setActualSize(newWidth:Number, newHeight:Number):void Устанавливает фактический размер для этого объекта.	BitmapAsset
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String [переопределить] Возвращает строку, указывающую расположение этого объекта в иерархии объектов DisplayObject в приложении.	FlexBitmap
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

События

Дополнительные сведения о событиях

Скрыть унаследованные события

Показать унаследованные события

	Сводка	Определено
activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.	EventDispatcher
added	Отправляется, когда экранный объект добавляется в список отображения.	DisplayObject
addedToStage	Отправляется, когда экранный объект добавляется к списку отображения на монтажном столе либо непосредственно, либо путем добавления поддерева, содержащего экранный объект.	DisplayObject
deactivate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.	EventDispatcher
enterFrame	[многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр.	DisplayObject
exitFrame	[многоадресное событие] Отправляется, когда точка воспроизведения покидает текущий кадр.	DisplayObject
frameConstructed	[многоадресное событие] Отправляется после завершения работы конструкторов экранных объектов кадра до выполнения сценариев кадра.	DisplayObject
removed	Отправляется перед удалением экранного объекта из списка отображения.	DisplayObject
removedFromStage	Отправляется перед удалением экранного объекта из списка отображения либо напрямую, либо путем удаления поддерева, содержащего экранный объект.	DisplayObject
render	[многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения.	DisplayObject

Сведения о свойстве

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):void

measuredHeight

свойство

measuredHeight:Number [только для чтения]

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Рассчитанная высота этого объекта.

Как правило, для графических тем оформления выполняется жесткая кодировка, так как это число представляет собой всего лишь число пикселей в графике. Для тем оформления кода также может использоваться жесткая кодировка для выполнения рисунка определенного размера. При изменении размера в зависимости от свойств, возможно, потребуется использование ILayoutManagerClient, что приведет к вызову метода measure() в нужное время и позволит вычислить measuredHeight.

Реализация
public function get measuredHeight():Number

measuredWidth

свойство

measuredWidth:Number [только для чтения]

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Измеренная ширина этого объекта.

Реализация
public function get measuredWidth():Number

Сведения о конструкторе

()

Конструктор

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` — Новая высота для этого объекта.

Юридическая информация | Политика конфиденциальности онлайн

BitmapAsset - AS3 Flex

Классы x

layoutDirection

measuredHeight

measuredWidth

BitmapAsset

invalidateLayoutDirection

move

setActualSize