BitmapImage

Пакет	spark.primitives
Класс	public class BitmapImage
Наследование	BitmapImage GraphicElement EventDispatcher Object

Язык версии:

ActionScript 3.0

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

Flex 4.0

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

Flash Player 10, AIR 2.0

Элемент BitmapImage определяет регион прямоугольной формы в координатном пространстве своего вышестоящего элемента, заполненный растровыми данными из исходного файла или исходного URL-адреса.

Посмотреть примеры

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		alpha : Number Уровень прозрачности графического элемента.	GraphicElement
		alwaysCreateDisplayObject : Boolean Указывает, что этот GraphicElement необходимо связать и визуализировать с помощью собственного DisplayObject.	GraphicElement
		baseline : Object Вертикальное смещение в пикселях от целевого объекта привязки к положению базовой линии элемента управления.	GraphicElement
		baselinePosition : Number [только для чтения] Координата Y базовой линии первой строки текста компонента.	GraphicElement
		bitmapData : BitmapData [только для чтения] Возвращает копию объекта BitmapData, представляющего загруженное в настоящий момент содержимое изображения (немасштабируемое).	BitmapImage
		blendMode : String Значение класса BlendMode, задающее режим наложения.	GraphicElement
		bottom : Object Вертикальное смещение в пикселях от нижнего края компонента к нижнему краю целевого объекта привязки.	GraphicElement
		bytesLoaded : Number [только для чтения] Количество байтов загруженного изображения.	BitmapImage
		bytesTotal : Number [только для чтения] Общее количество данных изображения, которые загружены или находятся в ожидании загрузки, в байтах.	BitmapImage
		clearOnLoad : Boolean Обозначает, следует ли удалить предыдущее содержимое изображения до загрузки нового содержимого.	BitmapImage
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		contentLoader : IContentLoader Дополнительный пользовательский загрузчик изображений (например,	BitmapImage
		contentLoaderGrouping : String Дополнительный идентификатор группировки содержимого для передачи в метод load() связанного экземпляра IContentLoader.	BitmapImage
		depth : Number Определяет порядок отображения элементов внутри контейнеров.	GraphicElement
		designLayer : DesignLayer Определяет дополнительный экземпляр DesignLayer, связанный с этим визуальным элементом.	GraphicElement
		displayObject : DisplayObject [только для чтения] Совместно используемый DisplayObject, в котором отображается этот IGraphicElement.	GraphicElement
		displayObjectSharingMode : String Указывает связь между этим IGraphicElement и его экранными объектами.	GraphicElement
		explicitHeight : Number Число, указывающее явную высоту компонента в пикселях в виде координат компонента.	GraphicElement
		explicitMaxHeight : Number Рекомендованная максимальная высота компонента, принимаемая вышестоящим элементом при создании макета.	GraphicElement
		explicitMaxWidth : Number Рекомендованная максимальная ширина компонента, принимаемая вышестоящим элементом при создании макета.	GraphicElement
		explicitMinHeight : Number Рекомендованная минимальная высота компонента, принимаемая вышестоящим элементом при создании макета.	GraphicElement
		explicitMinWidth : Number Рекомендованная минимальная ширина компонента, принимаемая вышестоящим элементом при создании макета.	GraphicElement
		explicitWidth : Number Число, указывающее явную ширину компонента в пикселях в виде координат компонента.	GraphicElement
		fillMode : String Определяет, каким образом растровое изображение заполняет область определенного размера.	BitmapImage
		filters : Array Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с данным графическим элементом.	GraphicElement
		hasLayoutMatrix3D : Boolean [только для чтения] Содержит true, если элемент имеет трехмерную матрицу.	GraphicElement
		height : Number Высота графического элемента.	GraphicElement
		horizontalAlign : String Выравнивание содержимого по горизонтали, если отсутствуют однозначные пропорции и для scaleMode установлено значение mx.graphics.BitmapScaleMode.LETTERBOX.	BitmapImage
		horizontalCenter : Object Горизонтальное смещение в пикселях от центра компонента к центру области содержимого целевого объекта привязки.	GraphicElement
		id : String Идентификатор компонента.	GraphicElement
		includeInLayout : Boolean Указывает, включен ли этот элемент в макет вышестоящего элемента.	GraphicElement
		is3D : Boolean [только для чтения] Содержит true, если элемент представлен в трехмерной графике.	GraphicElement
		layoutDirection : String Определяет требуемое направление макета для элемента: один из LayoutDirection.LTR (слева направо), LayoutDirection.RTL (справа налево) или null (наследование).	GraphicElement
		left : Object Горизонтальное смещение в пикселях от левого края компонента к левому краю целевого объекта привязки.	GraphicElement
		luminosityClip : Boolean Свойство, управляющее тем, будет ли маска свечения отсекать маскируемое содержимое.	GraphicElement
		luminosityInvert : Boolean Свойство, управляющее вычислением значения цветов RGB графического элемента, использующего маску свечения.	GraphicElement
		mask : DisplayObject Вызывающий экранный объект маскируется заданным объектом mask.	GraphicElement
		maskType : String Определяет, как маска применяется к GraphicElement. Возможными значениями являются MaskType.CLIP, MaskType.ALPHA и MaskType.LUMINOSITY. Обрезка по маске. Если маскирование находится в режиме обрезки, обрезочные маски уменьшаются до однобитовых.	GraphicElement
		maxHeight : Number Рекомендованная максимальная высота компонента, принимаемая вышестоящим элементом при создании макета.	GraphicElement
		maxWidth : Number Рекомендованная максимальная ширина компонента, принимаемая вышестоящим элементом при создании макета.	GraphicElement
		measuredHeight : Number Высота компонента в пикселях по умолчанию.	GraphicElement
		measuredWidth : Number Ширина компонента в пикселях по умолчанию.	GraphicElement
		measuredX : Number Размеры границ по умолчанию верхнего левого угла относительно начального положения объекта.	GraphicElement
		measuredY : Number Размеры границ по умолчанию верхнего левого угла относительно начального положения объекта.	GraphicElement
		minHeight : Number Рекомендованная минимальная высота компонента, принимаемая вышестоящим элементом при создании макета.	GraphicElement
		minWidth : Number Рекомендованная минимальная ширина компонента, принимаемая вышестоящим элементом при создании макета.	GraphicElement
		owner : DisplayObjectContainer Владелец этого объекта IVisualElement.	GraphicElement
		parent : DisplayObjectContainer [только для чтения] Вышестоящий контейнер или компонент данного компонента.	GraphicElement
		percentHeight : Number Указывает высоту компонента в виде процента от размера вышестоящего элемента.	GraphicElement
		percentWidth : Number Указывает ширину компонента в виде процента от размера вышестоящего элемента.	GraphicElement
		postLayoutTransformOffsets : mx.geom:TransformOffsets Определяет ряд настроек, применяемых для преобразования объекта способом, не отображающимся в макете вышестоящего элемента объекта.	GraphicElement
		preliminaryHeight : Number Обеспечивает оценку высоты, когда для макета требуются измеренные границы изображения, но загрузка данных изображения еще не завершена.	BitmapImage
		preliminaryWidth : Number Обеспечивает оценку ширины, когда для макета требуются измеренные границы изображения, но загрузка данных изображения еще не завершена.	BitmapImage
		right : Object Горизонтальное смещение в пикселях от правого края компонента к правому краю целевого объекта привязки.	GraphicElement
		rotation : Number Указывает поворот элемента относительно его исходной ориентации, в градусах.	GraphicElement
		rotationX : Number Обозначает поворот в градусах по оси x экземпляра элемента относительно исходной ориентации по трехмерному вышестоящему контейнеру.	GraphicElement
		rotationY : Number Обозначает угол поворота в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру.	GraphicElement
		rotationZ : Number Указывает поворот элемента относительно его исходной ориентации, в градусах.	GraphicElement
		scaleMode : String Определяет способ изменения масштаба изображения, если для fillMode указано значение mx.graphics.BitmapFillMode.SCALE.	BitmapImage
		scaleX : Number Горизонтальное масштабирование элемента от точки преобразования (в процентах).	GraphicElement
		scaleY : Number Вертикальное масштабирование элемента от точки преобразования (в процентах).	GraphicElement
		scaleZ : Number Масштабирование элемента по оси z от точки преобразования (в процентах).	GraphicElement
		smooth : Boolean Указывает, применять ли алгоритм смягчения к растровому изображению.	BitmapImage
		smoothingQuality : String Определяет способ уменьшения масштаба изображения.	BitmapImage
		source : Object Источник, используемый для растровой заливки.	BitmapImage
		sourceHeight : Number [только для чтения] Предоставляет немасштабируемую высоту данных исходного изображения.	BitmapImage
		sourceWidth : Number [только для чтения] Предоставляет немасштабируемую ширину данных исходного изображения.	BitmapImage
		top : Object Вертикальное смещение в пикселях от верхнего края компонента к верхнему краю целевого объекта привязки.	GraphicElement
		transform : flash.geom:Transform Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта.	GraphicElement
		transformX : Number Положение точки преобразования элемента по оси x.	GraphicElement
		transformY : Number Положение точки преобразования элемента по оси у.	GraphicElement
		transformZ : Number Положение точки преобразования элемента по оси z.	GraphicElement
		trustedSource : Boolean [только для чтения] Флаг только для чтения, обозначающий, считается ли текущее содержимое загруженным из источника, политика безопасности которого разрешает междоменный доступ к изображениям.	BitmapImage
		verticalAlign : String Выравнивание содержимого по вертикали, если отсутствуют однозначные пропорции и для scaleMode установлено значение mx.graphics.BitmapScaleMode.LETTERBOX.	BitmapImage
		verticalCenter : Object Вертикальное смещение в пикселях от центра компонента к центру области содержимого целевого объекта привязки.	GraphicElement
		visible : Boolean Управляет видимостью данного визуального элемента.	GraphicElement
		width : Number Ширина графического элемента.	GraphicElement
		x : Number Положение графического элемента по оси x.	GraphicElement
		y : Number Положение графического элемента по оси y.	GraphicElement
		z : Number Положение графического элемента по оси z.	GraphicElement

Защищенные свойства

Скрыть унаследованные защищенные свойства

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

	Свойство		Определено
		drawnDisplayObject : DisplayObject [только для чтения] Фактический DisplayObject, имеющийся в GraphicElement.	GraphicElement
		drawX : Number [только для чтения] Положение отображения элемента по оси x.	GraphicElement
		drawY : Number [только для чтения] Положение отображения элемента по оси y.	GraphicElement
		hasComplexLayoutMatrix : Boolean [только для чтения] Возвращает значение true, если GraphicElement имеет какое-либо свойство transform, отличное от перемещения (x, y)	GraphicElement
		layoutFeatures : AdvancedLayoutFeatures Содержит всю подробную информацию о реализации преобразования с помощью GraphicElement и о поддержке слоев.	GraphicElement
		needsDisplayObject : Boolean [только для чтения] True, если элементу требуется эксклюзивный DisplayObject.	GraphicElement

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		BitmapImage() Конструктор.	BitmapImage
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	EventDispatcher
		canShareWithNext(element:IGraphicElement):Boolean Возвращает значение true, если этот IGraphicElement совместим со следующим IGraphicElement в последовательности и может использовать экранные объекты совместно с этим элементом.	GraphicElement
		canShareWithPrevious(element:IGraphicElement):Boolean Возвращает значение true, если этот IGraphicElement совместим с предыдущим IGraphicElement в последовательности и может использовать экранные объекты совместно с этим элементом.	GraphicElement
		createDisplayObject():DisplayObject Создает новый DisplayObject, в котором отображается этот IGraphicElement.	GraphicElement
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	EventDispatcher
		getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Возвращает координату Х границ элемента для указанного размера элемента.	GraphicElement
		getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Возвращает координату Y границ элемента при указанном размере элемента.	GraphicElement
		getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number Возвращает высоту макета элемента.	GraphicElement
		getLayoutBoundsWidth(postLayoutTransform:Boolean = true):Number Возвращает ширину макета элемента.	GraphicElement
		getLayoutBoundsX(postLayoutTransform:Boolean = true):Number Возвращает координату Х, используемую элементом для отображения на экране.	GraphicElement
		getLayoutBoundsY(postLayoutTransform:Boolean = true):Number Возвращает координату Y, используемую элементом для отображения на экране.	GraphicElement
		getLayoutMatrix():Matrix Возвращает матрицу преобразования, используемую для определения макета компонента относительно соответствующих элементов одного уровня.	GraphicElement
		getLayoutMatrix3D():Matrix3D Возвращает преобразование макета Matrix3D для этого элемента.	GraphicElement
		getMaxBoundsHeight(postLayoutTransform:Boolean = true):Number Возвращает максимальную высоту элемента.	GraphicElement
		getMaxBoundsWidth(postLayoutTransform:Boolean = true):Number Возвращает максимальную ширину элемента.	GraphicElement
		getMinBoundsHeight(postLayoutTransform:Boolean = true):Number Возвращает минимальную высоту элемента.	GraphicElement
		getMinBoundsWidth(postLayoutTransform:Boolean = true):Number Возвращает минимальную ширину элемента.	GraphicElement
		getPreferredBoundsHeight(postLayoutTransform:Boolean = true):Number Возвращает предпочтительную высоту элемента.	GraphicElement
		getPreferredBoundsWidth(postLayoutTransform:Boolean = true):Number Возвращает предпочтительную ширину элемента.	GraphicElement
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	EventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		initialized(document:Object, id:String):void Вызывается автоматически компилятором MXML при создании GraphicElement с помощью тега MXML.	GraphicElement
		invalidateDisplayList():void Вызов метода приводит к вызову метода validateDisplayList() элементов перед визуализацией списка отображения.	GraphicElement
		invalidateLayoutDirection():void Элемент должен вызывать этот метод при изменении своего layoutDirection или при изменении своего вышестоящего layoutDirection.	GraphicElement
		invalidateProperties():void Выполнение вызова этого метода приводит к вызову метода validateProperties() элементов перед визуализацией списка отображения.	GraphicElement
		invalidateSize():void Вызов этого метода приводит к вызову метода validateSize() элементов перед визуализацией списка отображения.	GraphicElement
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		localToGlobal(point:Point):Point Преобразует объект point из координат объекта (локальных) в координаты рабочей области (глобальные).	GraphicElement
		parentChanged(value:IGraphicElementContainer):void Вызывается с помощью IGraphicElementContainer при добавлении или удалении IGraphicElement из компонента хоста.	GraphicElement
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		setLayoutBoundsPosition(newBoundsX:Number, newBoundsY:Number, postLayoutTransform:Boolean = true):void Устанавливает координаты, используемые элементом для отображения на экране.	GraphicElement
		setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void Устанавливает размер макета элемента.	GraphicElement
		setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void Устанавливает матрицу преобразования, используемую для определения размера макета компонента и его позиции относительно соответствующих элементов одного уровня.	GraphicElement
		setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void Устанавливает трехмерную матрицу преобразования, используемую для определения размера макета компонента и его позиции относительно соответствующих элементов одного уровня.	GraphicElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		setSharedDisplayObject(sharedDisplayObject:DisplayObject):Boolean Определяет, может ли этот элемент отображаться в объекте sharedDisplayObject последовательности.	GraphicElement
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void Служебный метод для обновления вращения, масштабирования и перемещения преобразования при сохранении определенной точки, указанной в собственной области координат компонента, зафиксированной в области координат вышестоящего элемента.	GraphicElement
		transformPointToParent(localPosition:Vector3D, position:Vector3D, postLayoutPosition:Vector3D):void Служебный метод для преобразования точки, указанной в локальных координатах этого объекта, к ее местоположению в координатах вышестоящего узла объекта.	GraphicElement
		validateDisplayList():void Вызывается IGraphicElementContainer для повторного отображения этого элемента в его свойстве displayObject.	GraphicElement
		validateNow():void Проверяет и обновляет свойства и макет этого объекта посредством немедленного вызова методов validateProperties(), validateSize() и validateDisplayList(), если необходимо.	GraphicElement
		validateProperties():void Используется в логике макета для проверки свойств компонента посредством вызова метода commitProperties().	GraphicElement
		validateSize():void Вызывается IGraphicElementContainer для проверки правильности размера этого элемента.	GraphicElement
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

Защищенные методы

Скрыть унаследованные защищенные методы

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

	Метод		Определено
		canSkipMeasurement():Boolean Определяет, может ли быть пропущен вызов метода measure().	GraphicElement
		commitProperties():void [переопределить] Обрабатывает свойства, установленные для элемента.	BitmapImage
		getStrokeExtents(postLayoutTransform:Boolean = true):Rectangle Возвращает количество пикселов, занятых обводкой на каждой стороне границ элемента.	GraphicElement
		invalidateDisplayObjectSharing():void Служебный метод, сообщающий хосту об изменениях элемента и необходимости в обновлении его слоя.	GraphicElement
		invalidateParentSizeAndDisplayList():void Вспомогательный метод, делающий недействительными размер и список отображения вышестоящего элемента, если этот объект оказывает влияние на соответствующий макет (значение includeInLayout равно true).	GraphicElement
		measure():void [переопределить] Вычисляет размер элемента по умолчанию.	BitmapImage
		preferredHeightPreTransform():Number Возвращает явную измеренную высоту перед преобразованием при использовании для реализации интерфейса ILayoutElement.	GraphicElement
		preferredWidthPreTransform():Number Возвращает явную измеренную ширину перед преобразованием при использовании для реализации интерфейса ILayoutElement.	GraphicElement
		transformHeightForLayout(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Преобразуйте размер элемента.	GraphicElement
		transformWidthForLayout(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Преобразуйте размер элемента.	GraphicElement
		updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void [переопределить] Обеспечивает отображение элемента и/или определение размеров и положения его содержимого.	BitmapImage

События

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

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

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

	Сводка	Определено
activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.	EventDispatcher
complete	Передается после завершения загрузки содержимого.	BitmapImage
deactivate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.	EventDispatcher
httpStatus	Передается при сетевом запросе по HTTP, если Flash Player или AIR могут определить код состояния HTTP.	BitmapImage
ioError	Передается при возникновении ошибки ввода/вывода.	BitmapImage
progress	Передается во время загрузки содержимого.	BitmapImage
ready	Передается после завершения загрузки содержимого.	BitmapImage
securityError	Передается при возникновении ошибки системы безопасности.	BitmapImage

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

bitmapData

свойство

bitmapData:BitmapData [только для чтения]

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10, AIR 2.0

Возвращает копию объекта BitmapData, представляющего загруженное в настоящий момент содержимое изображения (немасштабируемое). Это свойство имеет значение null для ненадежного междоменного содержимого.

Значением по умолчанию является null.

Реализация
public function get bitmapData():BitmapData

bytesLoaded

свойство

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

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10, AIR 2.0

Количество байтов загруженного изображения. Относится только к изображениям, загруженным URL-адресом запроса.

Значением по умолчанию является NaN.

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

bytesTotal

свойство

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

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10, AIR 2.0

Общее количество данных изображения, которые загружены или находятся в ожидании загрузки, в байтах. Относится только к изображениям, загруженным URL-адресом запроса.

Значением по умолчанию является NaN.

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

clearOnLoad

свойство

clearOnLoad:Boolean

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10, AIR 2.0

Обозначает, следует ли удалить предыдущее содержимое изображения до загрузки нового содержимого.

Значением по умолчанию является true.

Реализация
public function get clearOnLoad():Boolean
public function set clearOnLoad(value:Boolean):void

contentLoader

свойство

contentLoader:IContentLoader

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10, AIR 1.5

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

Значением по умолчанию является null.

Реализация
public function get contentLoader():IContentLoader
public function set contentLoader(value:IContentLoader):void

contentLoaderGrouping

свойство

contentLoaderGrouping:String

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10, AIR 1.5

Дополнительный идентификатор группировки содержимого для передачи в метод load() связанного экземпляра IContentLoader. Это свойство рассматривается только в том случае, если назначен правильный contentLoader.

Реализация
public function get contentLoaderGrouping():String
public function set contentLoaderGrouping(value:String):void

fillMode

свойство

fillMode:String

Язык версии:

ActionScript 3.0

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

Flex 4

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

Flash Player 10, AIR 1.5

Определяет, каким образом растровое изображение заполняет область определенного размера. При установке значения этого свойства в теге необходимо использовать строку (например, repeat). Если значение этого свойства установлено в ActionScript, то необходимо использовать константу (например, mx.graphics.BitmapFillMode.CLIP).

Если установлено значение BitmapFillMode.CLIP ("clip"), то растровое изображение ограничивается пределами области.

Если установлено значение BitmapFillMode.REPEAT ("repeat"), то растровое изображение копируется для заполнения области.

Если установлено значение BitmapFillMode.SCALE ("scale"), растровое изображение растягивается для заполнения области.

Значением по умолчанию является BitmapFillMode.SCALE.

Реализация
public function get fillMode():String
public function set fillMode(value:String):void

Связанные элементы API

mx.graphics.BitmapFillMode

horizontalAlign

свойство

horizontalAlign:String

Язык версии:

ActionScript 3.0

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

Flex 4

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

Flash Player 10, AIR 1.5

Выравнивание содержимого по горизонтали, если отсутствуют однозначные пропорции и для scaleMode установлено значение mx.graphics.BitmapScaleMode.LETTERBOX.

Допустимые значения: HorizontalAlign.LEFT ("left"), HorizontalAlign.RIGHT ("right") или HorizontalAlign.CENTER ("center").

Это свойство применяется только в случае, когда для fillMode указано значение mx.graphics.BitmapFillMode.SCALE ("scale").

Значением по умолчанию является HorizontalAlign.CENTER.

Реализация
public function get horizontalAlign():String
public function set horizontalAlign(value:String):void

Связанные элементы API

mx.graphics.BitmapFillMode
mx.graphics.BitmapScaleMode

preliminaryHeight

свойство

preliminaryHeight:Number

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10, AIR 1.5

Обеспечивает оценку высоты, когда для макета требуются измеренные границы изображения, но загрузка данных изображения еще не завершена. Если NaN, то измеренной высотой является 0 до окончания загрузки изображения.

Значением по умолчанию является NaN.

Реализация
public function get preliminaryHeight():Number
public function set preliminaryHeight(value:Number):void

preliminaryWidth

свойство

preliminaryWidth:Number

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10, AIR 1.5

Обеспечивает оценку ширины, когда для макета требуются измеренные границы изображения, но загрузка данных изображения еще не завершена. Если NaN, то измеренной шириной является 0 до окончания загрузки изображения.

Значением по умолчанию является NaN.

Реализация
public function get preliminaryWidth():Number
public function set preliminaryWidth(value:Number):void

scaleMode

свойство

scaleMode:String

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10.1, AIR 2.0

Определяет способ изменения масштаба изображения, если для fillMode указано значение mx.graphics.BitmapFillMode.SCALE.

Если указано mx.graphics.BitmapScaleMode.STRETCH ("stretch"), то изображение растягивается в соответствии с указанными размерами.

Если указано BitmapScaleMode.LETTERBOX ("letterbox"), то масштабирование изображения выполняется с учетом исходных пропорций изображения до масштабирования.

Если указано BitmapScaleMode.ZOOM ("zoom"), то масштабирование изображения выполняется с учетом исходных пропорций изображения до масштабирования. В результате изображение обрезается по одной из осей.

Значением по умолчанию является BitmapScaleMode.STRETCH.

Реализация
public function get scaleMode():String
public function set scaleMode(value:String):void

Связанные элементы API

mx.graphics.BitmapFillMode
mx.graphics.BitmapScaleMode

smooth

свойство

smooth:Boolean

Язык версии:

ActionScript 3.0

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

Flex 4

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

Flash Player 10, AIR 1.5

Указывает, применять ли алгоритм смягчения к растровому изображению.

При выборе значения false визуализируются растровые изображения, увеличенные при помощи алгоритма ближайшего соседнего пикселя, которые могут выглядеть нечетко. При выборе значения true увеличенное растровое изображение визуализируется с помощью билинейного алгоритма. Обычно процедура визуализации с помощью алгоритма ближайшего соседнего пикселя требует меньше времени.

Значением по умолчанию является false.

Реализация
public function get smooth():Boolean
public function set smooth(value:Boolean):void

smoothingQuality

свойство

smoothingQuality:String

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10, AIR 1.5

Определяет способ уменьшения масштаба изображения. При указании значения BitmapSmoothingQuality.HIGHизображение преобразуется (если данные получены из доверенного источника) с целью получения изображения более высокого качества. При установленном BitmapSmoothingQuality.DEFAULT будет использоваться качество рабочей области по умолчанию для масштабируемых заливок растровых изображений.

Значением по умолчанию является BitmapSmoothingQuality.DEFAULT.

Реализация
public function get smoothingQuality():String
public function set smoothingQuality(value:String):void

source

свойство

source:Object

Язык версии:

ActionScript 3.0

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

Flex 4

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

Flash Player 10, AIR 1.5

Источник, используемый для растровой заливки. Заливка может выполняться на основе различных графических источников, включая следующие.

Растровое изображение или экземпляр BitmapData.
Класс, представляющий подкласс DisplayObject. BitmapFill реализует класс и выполняет его растровую визуализацию.
Экземпляр DisplayObject. BitmapFill копирует его в растровое изображение для заливки.
Имя внешнего файла изображения.

В качестве источника может быть файл изображения типа PNG, GIF или JPG.

Для указания источника встроенного изображения можно использовать директиву @Embed, как показано в следующем примере:

      source="@Embed('<i>image_location</i>')"

Местоположением изображения может служить URL-адрес, URLRequest или ссылка на файл. Если это ссылка на файл, ее местоположение определяется местоположением компилируемого файла.

Класс BitmapImage предназначен для работы со встроенными изображениями или с изображениями, загружаемыми во время выполнения.

Если источником является экземпляр Bitmap или BitmapData или внешний графический файл, то вызывающий объект должен удалить источник, как только он не будет требоваться. Если ImageLoader создал экземпляр BitmapData, то затем он удалит BitmapData при первом изменении источника.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие sourceChanged .

Реализация
public function get source():Object
public function set source(value:Object):void

Связанные элементы API

flash.display.Bitmap
flash.display.BitmapData
mx.graphics.BitmapFill

sourceHeight

свойство

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

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10, AIR 1.5

Предоставляет немасштабируемую высоту данных исходного изображения.

Значением по умолчанию является NaN.

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

sourceWidth

свойство

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

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10, AIR 1.5

Предоставляет немасштабируемую ширину данных исходного изображения.

Значением по умолчанию является NaN.

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

trustedSource

свойство

trustedSource:Boolean [только для чтения]

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 9, AIR 1.5

Флаг только для чтения, обозначающий, считается ли текущее содержимое загруженным из источника, политика безопасности которого разрешает междоменный доступ к изображениям. При значении false не разрешены расширенные операции с растровыми объектами, например масштабирование с высоким качеством или создание мозаичных изображений. Этот флаг устанавливается после полной загрузки изображения.

Значением по умолчанию является true.

Реализация
public function get trustedSource():Boolean

verticalAlign

свойство

verticalAlign:String

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10, AIR 1.5

Выравнивание содержимого по вертикали, если отсутствуют однозначные пропорции и для scaleMode установлено значение mx.graphics.BitmapScaleMode.LETTERBOX.

Допустимые значения: VerticalAlign.TOP ("top"), VerticalAlign.BOTTOM ("bottom") или VerticalAlign.MIDDLE ("middle").

Это свойство применяется только в случае, когда для scaleMode указано BitmapFillMode.SCALE ("scale").

Значением по умолчанию является VerticalAlign.MIDDLE.

Реализация
public function get verticalAlign():String
public function set verticalAlign(value:String):void

Связанные элементы API

mx.graphics.BitmapFillMode
mx.graphics.BitmapScaleMode

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

()

Конструктор

public function BitmapImage()

Язык версии:

ActionScript 3.0

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

Flex 4

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

Flash Player 10, AIR 1.5

Конструктор.

Сведения о методе

commitProperties

()

метод

override protected function commitProperties():void

Язык версии:

ActionScript 3.0

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

Flex 4

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

Flash Player 10, AIR 1.5

Обрабатывает свойства, установленные для элемента. Это усовершенствованный метод, который можно отменить при создании какого-либо подкласса.

Этот метод не вызывается напрямую. Метод commitProperties() вызывается программой Flex при использовании метода addElement() для добавления элемента к контейнеру IGraphicElementContainer, например Group, или при вызове метода invalidateProperties() элемента. Вызовы метода commitProperties() осуществляются перед вызовами метода measure(). Это позволяет устанавливать значения свойств, которые могли бы использоваться методом measure().

У некоторых элементов имеются свойства, которые взаимодействуют друг с другом. Зачастую в момент запуска целесообразно обработать все эти свойства сразу и избежать дублирования работы.

measure

()

метод

override protected function measure():void

Язык версии:

ActionScript 3.0

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

Flex 4

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

Flash Player 10, AIR 1.5

Вычисляет размер элемента по умолчанию. Это усовершенствованный метод, который можно отменить при создании подкласса GraphicElement.

Этот метод не вызывается напрямую. Метод measure() вызывается программой Flex при добавлении элемента к контейнеру IGraphicElementContainer, например Group, с использованием метода addElement() и при вызове метода invalidateSize() элемента.

По умолчанию задается явная высота и явная ширина элемента, вызов метода measure() в программе Flex не осуществляется даже в случае явного вызова метода invalidateSize(). Для отмены такого поведения требуется отменить метод skipMeasure().

Для переопределения этого метода необходимо настроить свойства measuredWidth и measuredHeight для определения размера по умолчанию. Можно дополнительно задать свойства measuredX и measuredY для определения по размеров границ по умолчанию верхнего левого угла относительно исходного положения элемента.

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

Объем текста, который должен быть отображен в компоненте.
Размер изображения JPEG, отображаемого в компоненте.

В некоторых случаях встроенный метод для определения значений по умолчанию отсутствует. Например, для простого элемента GreenCircle можно просто установить значение свойств measuredWidth = 100 и measuredHeight = 100 в методе measure() для предоставления приемлемого размера по умолчанию. В других случаях, например для элемента TextArea, соответствующее вычисление (например, поиск требуемого значения ширины и высоты, при которых будет отображен весь текст, а элемент будет иметь соотношение размеров, присущее золотому сечению) может занять слишком много времени и поэтому не является целесообразным.

В реализации метода measure() по умолчанию для свойств measuredWidth, measuredHeight, measuredX и measuredY устанавливается значение, равное 0.

updateDisplayList

()

метод

override protected function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void

Язык версии:

ActionScript 3.0

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

Flex 4

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

Flash Player 10, AIR 1.5

Обеспечивает отображение элемента и/или определение размеров и положения его содержимого. Это усовершенствованный метод, который можно отменить при создании подкласса GraphicElement.

Этот метод не вызывается напрямую. Метод updateDisplayList() вызывается программой Flex при добавлении компонента к контейнеру IGraphicElementContainer, например Group, с использованием метода addElement() и при вызове метода invalidateDisplayList() элемента.

Именно в этом методе необходимо осуществить программируемое отображение с использованием методов элемента displayObject, например graphics.drawRect().

Параметры

	`unscaledWidth:Number` — Указывает ширину компонента в пикселях в координатах компонента вне зависимости от значения свойства `scaleX` компонента.

	`unscaledHeight:Number` — Указывает высоту компонента в пикселях в координатах компонента вне зависимости от значения свойства `scaleY` компонента.

Сведения о событии

complete

Событие

Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.COMPLETE

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10, AIR 2.0

Отправляется после завершения загрузки содержимого. Это событие отправляется только для url-адреса и источников на основе ByteArray, для которых требуется Loader.

Следует учесть, что для содержимого, загруженного с помощью Loader, отправляются события ready и complete.

Для других исходных типов, например встраивания, отправляется только ready.

Константа Event.COMPLETE определяет значение свойства type объекта complete.

Это событие имеет следующие свойства:

Свойство	Значение
`bubbles`	`false`
`cancelable`	`false`; поведение по умолчанию, подлежащее отмене, не определено.
`currentTarget`	Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
`target`	Сетевой объект, который завершил загрузку.

httpStatus

Событие

Тип объекта события: flash.events.HTTPStatusEvent
свойство HTTPStatusEvent.type = flash.events.HTTPStatusEvent.HTTP_STATUS

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10, AIR 2.0

Передается при сетевом запросе по HTTP, если Flash Player или AIR могут определить код состояния HTTP.

Константа HTTPStatusEvent.HTTP_STATUS определяет значение свойства type объекта события httpStatus.

Это событие имеет следующие свойства:

Свойство	Значение
`bubbles`	`false`
`cancelable`	`false`; поведение по умолчанию, подлежащее отмене, не определено.
`currentTarget`	Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
`status`	Код состояния HTTP, возвращенный сервером.
`target`	Сетевой объект, получающий код состояния НТТР.

ioError

Событие

Тип объекта события: flash.events.IOErrorEvent
свойство IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10, AIR 2.0

Передается при возникновении ошибки ввода/вывода.

Задает значение свойства type для объекта события ioError.

Это событие имеет следующие свойства:

Свойство	Значение
`bubbles`	`false`
`cancelable`	`false`; поведение по умолчанию, подлежащее отмене, не определено.
`currentTarget`	Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
`errorID`	Ссылочный номер, связываемый с конкретной ошибкой (только AIR).
`target`	Сетевой объект, с которым произошла ошибка ввода/вывода.
`text`	Текст, отображаемый в качестве сообщения об ошибке.

Связанные элементы API

flash.events.IOErrorEvent

progress

Событие

Тип объекта события: flash.events.ProgressEvent
свойство ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10, AIR 2.0

Передается во время загрузки содержимого.

Примечание. Передача события progress не является обязательной. Событие complete может быть получено без передачи события progress. Это возможно в том случае, если загружаемое содержимое является локальным файлом.

Задает значение свойства type для объекта события progress.

Это событие имеет следующие свойства:

Свойство	Значение
`bubbles`	`false`
`bytesLoaded`	Число элементов или байтов, загруженных на момент обработки события прослушивателем.
`bytesTotal`	Общее число элементов или байтов, которые в итоге будут получены в случае успешного завершения загрузки.
`cancelable`	`false`; поведение по умолчанию, подлежащее отмене, не определено.
`currentTarget`	Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
`target`	Объект, сообщающий сведения о прогрессе.

ready

Событие

Тип объекта события: mx.events.FlexEvent
свойство FlexEvent.type = mx.events.FlexEvent.READY

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10, AIR 2.0

Отправляется после завершения загрузки содержимого. В отличие от события complete, это событие отправляется для всех типов ресурсов.

Следует учесть, что для содержимого, загруженного с помощью Loader, отправляются события ready и complete.

Для других исходных типов, например встраивания, отправляется только ready.

Константа FlexEvent.READY определяет значение свойства type объекта события ready. Это событие отправляется BitmapImage и классами Spark Image для указания того, что назначенный источник изображения полностью загружен.

Свойства объекта события имеют следующие значения:

Свойство	Значение
`bubbles`	false
`cancelable`	false
`returnValue`	null
`currentTarget`	Объект, определяющий прослушиватель события, который выполняет обработку события. Например, при использовании `myImage.addEventListener()` для регистрации прослушивателя события myImage представляет собой значение для `currentTarget`.
`target`	Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство `currentTarget` всегда используется для получения доступа к объекту, прослушивающему событие.
`Тип`	FlexEvent.READY

securityError

Событие

Тип объекта события: flash.events.SecurityErrorEvent
свойство SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Язык версии:

ActionScript 3.0

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

Flex 4.5

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

Flash Player 10, AIR 2.0

Передается при возникновении ошибки системы безопасности.

Константа SecurityErrorEvent.SECURITY_ERROR определяет значение свойства type для объекта события securityError.

Это событие имеет следующие свойства:

Свойство	Значение
`bubbles`	`false`
`cancelable`	`false`; поведение по умолчанию, подлежащее отмене, не определено.
`currentTarget`	Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
`target`	Сетевой объект, сообщающий об ошибке безопасности.
`text`	Текст, отображаемый в качестве сообщения об ошибке.

Связанные элементы API

flash.events.SecurityErrorEvent

Примеры Использование этого примера

BitmapImageExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- BitmapGraphicExample.mxml -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark">

    <s:Panel title="Bitmap Graphic Example"
            width="75%" height="75%"
            horizontalCenter="0" verticalCenter="0">
        <s:Group left="10" right="10" top="10" bottom="10">
            <!-- Single image, not resized, not repeated. -->
            <s:Graphic x="0" y="0">             
                <s:BitmapImage id="bg1" source="@Embed('assets/AirIcon12x12.gif')" fillMode="clip"/>
            </s:Graphic>

            <!-- Single image, scaled to fit specified dimensions. -->
            <s:Graphic x="150" y="0">
                <s:BitmapImage id="bg2" source="@Embed('assets/AirIcon12x12.gif')" width="60" height="60" fillMode="scale"/>
            </s:Graphic>

            <!-- Repeated image to fit specified dimensions. -->
            <s:Graphic x="300" y="0">
                <s:BitmapImage id="bg3" source="@Embed('assets/AirIcon12x12.gif')" width="120" height="120" fillMode="repeat"/>
            </s:Graphic>
        </s:Group>
    </s:Panel>

</s:Application>

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

BitmapImage - AS3 Flex

Классы x

bitmapData

bytesLoaded

bytesTotal

clearOnLoad

contentLoader

contentLoaderGrouping

fillMode

horizontalAlign

preliminaryHeight

preliminaryWidth

scaleMode

smooth

smoothingQuality

source

sourceHeight

sourceWidth

trustedSource

verticalAlign

BitmapImage

commitProperties

measure

updateDisplayList

complete

httpStatus

ioError

progress

ready

securityError