| Пакет | spark.components |
| Класс | public class Image |
| Наследование | Image  SkinnableComponent UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
@Embed(source='filename').
Примечание. Flex также включает элемент управления SWFLoader для загрузки приложений Flex. Элемент управления Image обычно используется для загрузки статических графических файлов и файлов SWF, а элемент управления SWFLoader – для загрузки приложений Flex. Элемент управления Image также предназначен для применения в пользовательских средствах визуализации и редакторах элементов.
Примечание. Flex также включает класс BitmapImage. Этот класс используется для внедрения изображений в темы оформления и компоненты FXG.
Встроенные изображения загружаются немедленно, так как они уже являются частью файла Flex SWF. Однако они увеличивают размер приложения и замедляют процесс его инициализации. Встроенные изображения также требуют перекомпиляции приложения при каждом изменении файлов изображения.
Альтернативой встроенному ресурсу является загрузка ресурса во время выполнения. Можно загрузить ресурс из локальной файловой системы, в которой выполняется файл SWF, или обратиться к удаленному ресурсу, обычно через запрос HTTP по сети. Эти изображения являются независимыми от приложения Flex, поэтому их можно изменять, не вызывая операции перекомпиляции при условии, что имена изменяющихся изображений будут сохранены. Вызванные изображения не добавляют дополнительное время ко времени начальной загрузки приложения. Однако может возникнуть задержка при использовании изображений и загрузке их в Flash Player или AIR.
Тема оформления по умолчанию предоставляет тему оформления изображения без дополнительных элементов оформления с предварительным загрузчиком на основе типового индикатора выполнения и значком отсутствия изображения, обозначающим недействительное содержимое.
Чтобы использовать этот компонент в компоненте на основе списка, таком как List или DataGrid, следует создать средство визуализации элементов. Для получения информации о создании средства визуализации элементов см. раздел Пользовательские средства визуализации элементов Spark.
Элемент управления Image имеет следующие характеристики по умолчанию:
| Характеристика | Описание |
|---|---|
| Размер по умолчанию | Достаточно широкий, чтобы поместить связанное содержимое источника |
| Минимальный размер | 0 пикселей в ширину на 0 пикселей в высоту |
| Максимальный размер | 10000 пикселей в ширину и 10000 пикселей в высоту |
| Класс темы оформления по умолчанию | spark.skins.spark.ImageSkin |
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <s:Image> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:Image
Properties
clearOnLoad="true"
contentLoader="null"
contentLoaderGrouping="null"
fillMode="scale"
horizontalAlign="center"
preliminaryHeight="NaN"
preliminaryWidth="NaN"
scaleMode="letterbox"
smooth="false"
source="null
verticalAlign="middle"
Styles
backgroundAlpha="NaN"
backgroundColor="NaN"
enableLoadingState="false"
smoothingQuality="default"
Events
complete="No default"
httpStatus="No default"
ioError="No default"
progress="No default"
ready="No default"
securityError="No default"
/>
Связанные элементы API
Общедоступные свойства
| Свойство | Определено | ||
|---|---|---|---|
 | accessibilityDescription : String
Вспомогательное средство доступа для свойства description в объекте accessibilityProperties этого UIComponent. | UIComponent | |
| accessibilityEnabled : Boolean
Вспомогательное средство доступа для свойства silent в объекте accessibilityProperties этого UIComponent. | UIComponent | |
| accessibilityImplementation : AccessibilityImplementation
Текущая реализация специальных возможностей (AccessibilityImplementation) для данного экземпляра InteractiveObject. | InteractiveObject | |
| accessibilityName : String
Вспомогательное средство доступа для свойства name в объекте accessibilityProperties этого UIComponent. | UIComponent | |
| accessibilityProperties : AccessibilityProperties
Текущие параметры специальных возможностей для данного экранного объекта. | DisplayObject | |
| accessibilityShortcut : String
Вспомогательное средство доступа для свойства shortcut в объекте accessibilityProperties этого UIComponent. | UIComponent | |
| activeEffects : Array [только для чтения]
Список эффектов, в настоящее время воспроизводимых в компоненте, например массив экземпляров EffectInstance. | UIComponent | |
| alpha : Number
Указывает значение альфа-прозрачности заданного объекта. | DisplayObject | |
| automationDelegate : Object
Объект-делегат, выполняющий обработку функций, связанных с автоматизацией. | UIComponent | |
| automationEnabled : Boolean [только для чтения]
Значение true, если этот компонент доступен для автоматизации; в противном случае – false. | UIComponent | |
| automationName : String
Имя, которое можно использовать в качестве идентификатора этого объекта. | UIComponent | |
| automationOwner : DisplayObjectContainer [только для чтения]
Владелец этого компонента в целях автоматизации. | UIComponent | |
| automationParent : DisplayObjectContainer [только для чтения]
Вышестоящий элемент этого компонента в целях автоматизации. | UIComponent | |
| automationTabularData : Object [только для чтения]
Реализация интерфейса IAutomationTabularData, который можно использовать для извлечения данных. | UIComponent | |
| automationValue : Array [только для чтения]
Это значение, как правило, соответствует отображению объекта и может быть удобным для соотнесения идентификатора с объектом, поскольку отображено в приложении. | UIComponent | |
| automationVisible : Boolean [только для чтения]
Значение true, если этот компонент является видимым для автоматизации; в противном случае – false. | UIComponent | |
| baseline : Object
Для компонентов это свойство ограничения макета является фасадом поверх стиля с аналогичным именем. | UIComponent | |
| baselinePosition : Number [переопределить] [только для чтения]
Координата Y базовой линии первой строки текста компонента. | SkinnableComponent | |
| bitmapData : BitmapData [только для чтения]
Возвращает копию объекта BitmapData, представляющего загруженное в настоящий момент содержимое изображения (немасштабируемое). | Image | ||
| blendMode : String
Значение класса BlendMode, задающее режим наложения. | DisplayObject | |
| blendShader : Shader [только для записи]
Задает затенение, используемое при наложении переднего плана на фон. | DisplayObject | |
| bottom : Object
Для компонентов это свойство ограничения макета является фасадом поверх стиля с аналогичным именем. | UIComponent | |
| buttonMode : Boolean
Задает режим кнопки данного спрайта. | Sprite | |
| bytesLoaded : Number [только для чтения]
Количество байтов загруженного изображения. | Image | ||
| bytesTotal : Number [только для чтения]
Общее количество данных изображения, которые загружены или находятся в ожидании загрузки, в байтах. | Image | ||
| cacheAsBitmap : Boolean
При значении true среда выполнения Flash кэширует внутреннее растровое представление экранного объекта. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
Если задано ненулевое значение, данный объект Matrix определяет способ визуализации экранного объекта, когда свойство cacheAsBitmap имеет значение true. | DisplayObject | |
| cacheHeuristic : Boolean [только для записи]
Используется в Flex для предложения кэширования растровых изображений объекта. | UIComponent | |
| cachePolicy : String
Определяет политику кэширования растровых изображений для этого объекта. | UIComponent | |
| className : String [только для чтения]
Имя класса этого экземпляра, например Button. | UIComponent | |
| clearOnLoad : Boolean
Обозначает, следует ли удалить предыдущее содержимое изображения до загрузки нового содержимого. | Image | ||
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| contentLoader : IContentLoader
Дополнительный пользовательский загрузчик изображений (например, | Image | ||
| contentLoaderGrouping : String
Дополнительный идентификатор группировки содержимого для передачи в метод load() связанного экземпляра IContentLoader. | Image | ||
| contentMouseX : Number [только для чтения]
Возвращает координату x положения курсора мыши в текущей системе координат. | UIComponent | |
| contentMouseY : Number [только для чтения]
Возвращает координату y положения курсора мыши в текущей системе координат. | UIComponent | |
| contextMenu : NativeMenu
Определяет контекстное меню, связанное с данным объектом. | InteractiveObject | |
| currentState : String
Текущее состояние представления компонента. | UIComponent | |
| cursorManager : ICursorManager [только для чтения]
Получает FocusManager, управляющий курсором для этого компонента и компонентов, находящихся на том же уровне иерархии. | UIComponent | |
| depth : Number
Определяет порядок отображения элементов внутри контейнеров. | UIComponent | |
| descriptor : UIComponentDescriptor
Ссылка на UIComponentDescriptor (при его наличии), использованный методом createComponentFromDescriptor() для создания этого экземпляра UIComponent. | UIComponent | |
| designLayer : DesignLayer
Определяет дополнительный экземпляр DesignLayer, связанный с этим визуальным элементом. | UIComponent | |
| document : Object
Ссылка на объект документа, связанный с этим UIComponent. | UIComponent | |
| doubleClickEnabled : Boolean [переопределить]
Определяет, получает ли объект UIComponent события doubleClick. | UIComponent | |
| dropTarget : DisplayObject [только для чтения]
Определяет экранный объект, над которым перетаскивается спрайт либо на котором спрайт был отпущен. | Sprite | |
| enabled : Boolean
Возможность использования компонента пользователем. | UIComponent | |
| errorString : String
Текст, отображаемый рекомендацией ошибки компонента при контроле компонента классом Validator и сбое проверки. | UIComponent | |
| explicitHeight : Number
Число, указывающее явную высоту компонента в пикселях в виде координат компонента. | UIComponent | |
| explicitMaxHeight : Number
Рекомендованная максимальная высота компонента, принимаемая вышестоящим элементом при создании макета. | UIComponent | |
| explicitMaxWidth : Number
Рекомендованная максимальная ширина компонента, принимаемая вышестоящим элементом при создании макета. | UIComponent | |
| explicitMinHeight : Number
Рекомендованная минимальная высота компонента, принимаемая вышестоящим элементом при создании макета. | UIComponent | |
| explicitMinWidth : Number
Рекомендованная минимальная ширина компонента, принимаемая вышестоящим элементом при создании макета. | UIComponent | |
| explicitWidth : Number
Число, указывающее явную ширину компонента в пикселях в виде координат компонента. | UIComponent | |
| fillMode : String
Определяет, каким образом растровое изображение заполняет область определенного размера. | Image | ||
| filters : Array
Индексированный массив, который содержит все объекты filter, связанные в настоящий момент с экранным объектом. | DisplayObject | |
| flexContextMenu : IFlexContextMenu
Контекстное меню для этого UIComponent. | UIComponent | |
| focusEnabled : Boolean
Указывает, может ли компонент получить фокус при выборе вкладки с ним. | UIComponent | |
| focusManager : IFocusManager
Получает FocusManager, управляющий фокусом для этого компонента и компонентов, находящихся на том же уровне иерархии. | UIComponent | |
| focusPane : Sprite
Область фокусировки, связанная с этим объектом | UIComponent | |
| focusRect : Object
Задает отображение прямоугольной рамки индикатора фокуса для данного объекта. | InteractiveObject | |
| graphics : Graphics [только для чтения]
Задает объект Graphics, принадлежащий данному спрайту, в котором могут выполняться команды векторного рисования. | Sprite | |
| hasFocusableChildren : Boolean
Флаг, который указывает, могут ли нижестоящие объекты получить фокус. | UIComponent | |
| hasLayoutMatrix3D : Boolean [только для чтения]
Содержит true, если элемент имеет трехмерную матрицу. | UIComponent | |
| height : Number [переопределить]
Число, указывающее высоту компонента в координатах вышестоящего контейнера в пикселях. | UIComponent | |
| hitArea : Sprite
Определяет другой спрайт в качестве области щелчка для спрайта. | Sprite | |
| horizontalAlign : String
Выравнивание содержимого по горизонтали, если отсутствуют однозначные пропорции и для scaleMode установлено значение mx.graphics.BitmapScaleMode.LETTERBOX. | Image | ||
| horizontalCenter : Object
Для компонентов это свойство ограничения макета является фасадом поверх стиля с аналогичным именем. | UIComponent | |
| id : String
Идентификатор компонента. | UIComponent | |
| includeInLayout : Boolean
Указывает, включается ли этот компонент в макет вышестоящего контейнера. | UIComponent | |
| inheritingStyles : Object
Начало этой цепочки компонентов с ненаследуемыми стилями. | UIComponent | |
| initialized : Boolean
Флаг, определяющий, прошел ли объект все три фазы создания макета: обязательство, измерение и создание макета (при условии, что все они требовались). | UIComponent | |
| instanceIndex : int [только для чтения]
Индекс повторяемого компонента. | UIComponent | |
| instanceIndices : Array
Массив, содержащий индексы, требуемые для создания ссылки на этот UIComponent из собственного документа. | UIComponent | |
| is3D : Boolean [только для чтения]
Содержит true, если элемент представлен в трехмерной графике. | UIComponent | |
| isDocument : Boolean [только для чтения]
Содержит true, если этот экземпляр UIComponent является объектом документа. | UIComponent | |
| isPopUp : Boolean
Установите значение true в PopUpManager для указания того, что компонент имеет всплывающую подсказку. | UIComponent | |
| layoutMatrix3D : Matrix3D [только для записи]
Матрица преобразования, которая используется для вычисления макета компонента относительно соответствующих элементов одного уровня. | UIComponent | |
| left : Object
Для компонентов это свойство ограничения макета является фасадом поверх стиля с аналогичным именем. | UIComponent | |
| loaderInfo : LoaderInfo [только для чтения]
Возвращает объект LoaderInfo, содержащий сведения о загрузке файла, к которому принадлежит этот экранный объект. | DisplayObject | |
| maintainProjectionCenter : Boolean
При значении true компонент будет сохранять свою матрицу проекции выровненной по центру своей ограничительной рамки. | UIComponent | |
| mask : DisplayObject
Вызывающий экранный объект маскируется заданным объектом mask. | DisplayObject | |
| maxHeight : Number
Рекомендованная максимальная высота компонента, принимаемая вышестоящим элементом при создании макета. | UIComponent | |
| maxWidth : Number
Рекомендованная максимальная ширина компонента, принимаемая вышестоящим элементом при создании макета. | UIComponent | |
| measuredHeight : Number
Высота компонента в пикселях по умолчанию. | UIComponent | |
| measuredMinHeight : Number
Минимальная высота компонента по умолчанию в пикселях. | UIComponent | |
| measuredMinWidth : Number
Минимальная ширина компонента по умолчанию в пикселях. | UIComponent | |
| measuredWidth : Number
Ширина компонента в пикселях по умолчанию. | UIComponent | |
| metaData : Object
Получает объект метаданных экземпляра DisplayObject, если метаданные хранились вместе с экземпляром этого DisplayObject в SWF-файле через тег PlaceObject4. | DisplayObject | |
| minHeight : Number
Рекомендованная минимальная высота компонента, принимаемая вышестоящим элементом при создании макета. | UIComponent | |
| minWidth : Number
Рекомендованная минимальная ширина компонента, принимаемая вышестоящим элементом при создании макета. | UIComponent | |
| moduleFactory : IFlexModuleFactory
Фабрика модулей применяется в качестве контекста для использования встроенных шрифтов и для поиска менеджера стиля, который управляет стилями этого компонента. | UIComponent | |
| mouseChildren : Boolean
Определяет, поддерживают ли дочерние объекты события мыши или других устройств пользовательского ввода. | DisplayObjectContainer | |
| mouseEnabled : Boolean
Определяет, получает ли этот объект события мыши или другого пользовательского ввода. | InteractiveObject | |
| mouseFocusEnabled : Boolean
Можно ли получить фокус при нажатии элемента. | UIComponent | |
| mouseX : Number [только для чтения]
Указывает координату x мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | |
| mouseY : Number [только для чтения]
Указывает координату y мыши или курсора пользовательского ввода (в пикселях). | DisplayObject | |
| name : String
Указывает имя экземпляра DisplayObject. | DisplayObject | |
| needsSoftKeyboard : Boolean
Определяет, должна ли отображаться виртуальная клавиатура (программная экранная клавиатура), когда этот экземпляр InteractiveObject получает фокус. | InteractiveObject | |
| nestLevel : int
Глубина этого объекта в иерархии включения. | UIComponent | |
| nonInheritingStyles : Object
Начало цепочки этого компонента с ненаследуемыми стилями. | UIComponent | |
| numAutomationChildren : int [только для чтения]
Число нижестоящих элементов автоматизации, содержащихся в этом контейнере. | UIComponent | |
| opaqueBackground : Object
Определяет, является ли экранный объект непрозрачным с определенным цветом фона. | DisplayObject | |
| owner : DisplayObjectContainer
Владелец этого объекта IVisualElement. | UIComponent | |
| parent : DisplayObjectContainer [переопределить] [только для чтения]
Вышестоящий контейнер или компонент данного компонента. | UIComponent | |
| parentApplication : Object [только для чтения]
Ссылка на объект приложения, содержащего этот экземпляр UIComponent. | UIComponent | |
| parentDocument : Object [только для чтения]
Ссылка на вышестоящий объект документа для этого UIComponent. | UIComponent | |
| percentHeight : Number
Указывает высоту компонента в виде процента от размера вышестоящего элемента. | UIComponent | |
| percentWidth : Number
Указывает ширину компонента в виде процента от размера вышестоящего элемента. | UIComponent | |
| postLayoutTransformOffsets : mx.geom:TransformOffsets
Определяет ряд настроек, применяемых для преобразования объекта способом, не отображающимся в макете вышестоящего элемента объекта. | UIComponent | |
| preliminaryHeight : Number
Обеспечивает оценку высоты, когда для макета требуются измеренные границы изображения, но загрузка данных изображения еще не завершена. | Image | ||
| preliminaryWidth : Number
Обеспечивает оценку ширины, когда для макета требуются измеренные границы изображения, но загрузка данных изображения еще не завершена. | Image | ||
| processedDescriptors : Boolean
Установлено на true после немедленного или отложенного создания нижестоящих элементов в зависимости от выполняемого действия. | UIComponent | |
| repeater : IRepeater [только для чтения]
Ссылка на объект Repeater в вышестоящем документе, создающем этот UIComponent. | UIComponent | |
| repeaterIndex : int [только для чтения]
Индекс элемента в поставщике данных Repeater, создавшего этот UIComponent. | UIComponent | |
| repeaterIndices : Array
Массив, содержащий индексы элементов в поставщике данных Repeater в вышестоящем документе, создавшем этот UIComponent. | UIComponent | |
| repeaters : Array
Массив, содержащий ссылки на объекты Repeater в вышестоящем документе, создавшем этот UIComponent. | UIComponent | |
| right : Object
Для компонентов это свойство ограничения макета является фасадом поверх стиля с аналогичным именем. | UIComponent | |
| root : DisplayObject [только для чтения]
В случае с экранным объектом в загруженном SWF-файле свойством root является самый верхний экранный объект в части структуры дерева списка отображения, представленной этим SWF-файлом. | DisplayObject | |
| rotation : Number [переопределить]
Указывает поворот экземпляра DisplayObject относительно его исходной ориентации (в градусах). | UIComponent | |
| rotationX : Number [переопределить]
Обозначает поворот в градусах по оси x экземпляра DisplayObject относительно исходной ориентации по трехмерному вышестоящему контейнеру. | UIComponent | |
| rotationY : Number [переопределить]
Обозначает угол поворота в градусах по оси у экземпляра DisplayObject относительно исходной ориентации по трехмерному родительскому контейнеру. | UIComponent | |
| rotationZ : Number [переопределить]
Обозначает поворот в градусах по оси z экземпляра DisplayObject от исходной ориентации относительно трехмерного родительского контейнера. | UIComponent | |
| scale9Grid : Rectangle
Текущая активная сетка масштабирования. | DisplayObject | |
| scaleMode : String
Определяет способ изменения масштаба изображения, если для fillMode указано значение mx.graphics.BitmapFillMode.SCALE. | Image | ||
| scaleX : Number [переопределить]
Число, определяющее коэффициент горизонтального масштабирования. | UIComponent | |
| scaleY : Number [переопределить]
Число, определяющее коэффициент вертикального масштабирования. | UIComponent | |
| scaleZ : Number [переопределить]
Число, определяющее коэффициент масштабирования по оси Z. | UIComponent | |
| screen : Rectangle [только для чтения]
Возвращает объект, который содержит размер и позицию основной поверхности изображения для этого объекта. | UIComponent | |
| scrollRect : Rectangle
Прямоугольная область прокрутки экранного объекта. | DisplayObject | |
| showInAutomationHierarchy : Boolean
Флаг, который определяет, показан ли объект автоматизации в иерархии автоматизации. | UIComponent | |
| skin : UIComponent [только для чтения]
Экземпляр класса тем оформления для этого экземпляра компонента. | SkinnableComponent | |
| smooth : Boolean
Указывает, применять ли алгоритм смягчения к растровому изображению. | Image | ||
| softKeyboard : String
Управляет внешним видом программной клавиатуры. | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
Определяет область, которая должна оставаться на экране при отображении программной клавиатуры (недоступна в iOS). | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
Управляет звуком в данном спрайте. | Sprite | |
| source : Object
Источник, используемый для растровой заливки. | Image | ||
| sourceHeight : Number [только для чтения]
Предоставляет немасштабируемую высоту данных исходного изображения. | Image | ||
| sourceWidth : Number [только для чтения]
Предоставляет немасштабируемую ширину данных исходного изображения. | Image | ||
| stage : Stage [только для чтения]
Класс Stage экранного объекта. | DisplayObject | |
| states : Array
Состояния представления, представленные для этого компонента. | UIComponent | |
| styleDeclaration : CSSStyleDeclaration
Обеспечивает хранение встроенных наследуемых стилей этого объекта. | UIComponent | |
| styleManager : IStyleManager2 [только для чтения]
Возвращает экземпляр StyleManager, используемый этим компонентом. | UIComponent | |
| styleName : Object
Стиль класса, используемый этим компонентом. | UIComponent | |
| styleParent : IAdvancedStyleClient
Вышестоящий узел компонента используется для анализа нижестоящих селекторов. | UIComponent | |
| suggestedFocusSkinExclusions : Array [только для чтения]
Перечисляет компоненты темы оформления, исключенные из растровых объектов, захваченных и используемых для отображения фокуса. | SkinnableComponent | |
| systemManager : ISystemManager
Возвращает объект SystemManager, используемый этим компонентом. | UIComponent | |
| tabChildren : Boolean
Определяет, включен ли переход между нижестоящими элементами объекта с помощью клавиши Tab. | DisplayObjectContainer | |
| tabEnabled : Boolean
Определяет, включен ли переход к этому объекту с помощью клавиши Tab. | InteractiveObject | |
| tabFocusEnabled : Boolean
Флаг, который указывает, может ли этот объект получить фокус при использовании клавиши TAB. Это аналогично свойству tabEnabled, используемому в Flash Player. Обычно это значение – true для компонентов обработки ввода с клавиатуры, но некоторые компоненты панелей управления установлены на значение false, потому что они не должны забирать на себя фокус другого компонента, например редактора. | UIComponent | |
| tabIndex : int
Задает последовательность перехода между объектами в SWF-файле. | InteractiveObject | |
| textSnapshot : flash.text:TextSnapshot [только для чтения]
Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
| toolTip : String
Текст, отображаемый в ToolTip. | UIComponent | |
| top : Object
Для компонентов это свойство ограничения макета является фасадом поверх стиля с аналогичным именем. | UIComponent | |
| transform : flash.geom:Transform [переопределить]
Объект со свойствами, относящимися к матрице, преобразованию цвета и пиксельным границам экранного объекта. | UIComponent | |
| transformX : Number
Устанавливает координату x для центра преобразования компонента. | UIComponent | |
| transformY : Number
Устанавливает координату y для центра преобразования компонента. | UIComponent | |
| transformZ : Number
Устанавливает координату z для центра преобразования компонента. | UIComponent | |
| transitions : Array
Array объектов Transition, где каждый объект Transition определяет ряд эффектов для установки эффектов, воспроизводимых при изменении состояния. | UIComponent | |
| trustedSource : Boolean [только для чтения]
Флаг только для чтения, обозначающий, считается ли текущее содержимое загруженным из источника, политика безопасности которого разрешает междоменный доступ к изображениям. | Image | ||
| tweeningProperties : Array
Массив свойств, анимация которых выполняется в данный момент на этом объекте. | UIComponent | |
| uid : String
Уникальный идентификатор для объекта. | UIComponent | |
| updateCompletePendingFlag : Boolean
Флаг, определяющий, прошел ли объект все три фазы проверки макета (при условии, что все они требовались). | UIComponent | |
| useHandCursor : Boolean
Логическое значение, определяющее, должен ли отображаться курсор в виде руки при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true. | Sprite | |
| validationSubField : String
Используется средством проверки для связывания подчиненного поля с этим компонентом. | UIComponent | |
| verticalAlign : String
Выравнивание содержимого по вертикали, если отсутствуют однозначные пропорции и для scaleMode установлено значение mx.graphics.BitmapScaleMode.LETTERBOX. | Image | ||
| verticalCenter : Object
Для компонентов это свойство ограничения макета является фасадом поверх стиля с аналогичным именем. | UIComponent | |
| visible : Boolean [переопределить]
Определяет видимость экранного объекта. | UIComponent | |
| width : Number [переопределить]
Число, указывающее ширину компонента в координатах вышестоящего контейнера в пикселях. | UIComponent | |
| x : Number [переопределить]
Число, указывающее горизонтальную позицию компонента в пикселях внутри его вышестоящего контейнера. | UIComponent | |
| y : Number [переопределить]
Число, указывающее вертикальную позицию компонента в пикселях внутри его вышестоящего контейнера. | UIComponent | |
| z : Number [переопределить]
Указывает положение по оси z экземпляра DisplayObject относительно трехмерного вышестоящего контейнера. | UIComponent | |
Защищенные свойства
Общедоступные методы
| Метод | Определено | ||
|---|---|---|---|
Image()
Конструктор. | Image | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
|
Добавляет клиент с невизуальным стилем в экземпляр компонента. | UIComponent | |
|
Показывает, могут ли ограничения безопасности привести к пропуску каких-либо экранных объектов в списке, возвращаемом в результате вызова метода DisplayObjectContainer.getObjectsUnderPoint() с заданной точкой point. | DisplayObjectContainer | |
|
Ставит в очередь функцию для последующего вызова. | UIComponent | |
|
Удаляет свойство style для экземпляра компонента. | UIComponent | |
|
Определяет, является ли указанный объект отображения дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром. | DisplayObjectContainer | |
|
Преобразует объект Point из координат содержимого в глобальные координаты. | UIComponent | |
|
Преобразует объект Point из координат содержимого в локальные координаты. | UIComponent | |
|
Возвращает набор свойств, которые идентифицируют нижестоящий элемент в рамках этого контейнера. | UIComponent | |
|
Возвращает набор свойств, которые идентифицируют нижестоящий элемент в рамках этого контейнера. | UIComponent | |
|
Создает ссылку на id этого объекта IUIComponent в вышестоящем объекте документа. | UIComponent | |
|
Удаляет ссылку на id этого объекта IUIComponent в вышестоящем объекте документа. | UIComponent | |
|
Возвращается к объекту UITextFormat, соответствующему текстовым стилям для этого UIComponent. | UIComponent | |
| [переопределить]
Посылает событие в поток событий. | UIComponent | |
|
Отображает или скрывает индикатор фокуса вокруг этого компонента. | UIComponent | |
| drawRoundRect(x:Number, y:Number, w:Number, h:Number, r:Object = null, c:Object = null, alpha:Object = null, rot:Object = null, gradient:String = null, ratios:Array = null, hole:Object = null):void
Обеспечивает отображение прямоугольника в объекте Graphics указанной темы оформления программным способом. | UIComponent | |
|
Вызывается экземпляром эффекта по завершении воспроизведения эффекта в компоненте. | UIComponent | |
|
Вызывается экземпляром эффекта при запуске воспроизведения эффекта в компоненте. | UIComponent | |
|
Завершает все воспроизводимые в настоящее время эффекты на компоненте. | UIComponent | |
|
Выполняет все привязки, для которых объект UIComponent является адресом назначения. | UIComponent | |
|
Вызывается после завершения печати. | UIComponent | |
|
Предоставляет объект автоматизации с указанным индексом. | UIComponent | |
|
Обеспечивает список объектов автоматизации. | UIComponent | |
|
Возвращает прямоугольник, определяющий область объекта отображения, которая относится к системе координат объекта targetCoordinateSpace. | DisplayObject | |
|
Возвращает координату Х границ элемента для указанного размера элемента. | UIComponent | |
|
Возвращает координату Y границ элемента при указанном размере элемента. | UIComponent | |
|
Возвращает экземпляр дочернего экранного объекта с заданным именем. | DisplayObjectContainer | |
|
Выполняет поиск селекторов типа для этого экземпляра UIComponent. | UIComponent | |
|
Возвращает значение ограничения макета, идентичное значению получения стиля ограничения для этого компонента. | UIComponent | |
|
Стандартный метод, позволяющий определить, использовать ли явную или измеренную высоту
| UIComponent | |
|
Стандартный метод, позволяющий определить, использовать ли явную или измеренную ширину
| UIComponent | |
|
Получает объект, который в настоящее время имеет фокус. | UIComponent | |
|
Возвращает высоту макета элемента. | UIComponent | |
|
Возвращает ширину макета элемента. | UIComponent | |
|
Возвращает координату Х, используемую элементом для отображения на экране. | UIComponent | |
|
Возвращает координату Y, используемую элементом для отображения на экране. | UIComponent | |
|
Возвращает матрицу преобразования, используемую для определения макета компонента относительно соответствующих элементов одного уровня. | UIComponent | |
|
Возвращает преобразование макета Matrix3D для этого элемента. | UIComponent | |
|
Возвращает максимальную высоту элемента. | UIComponent | |
|
Возвращает максимальную ширину элемента. | UIComponent | |
|
Возвращает минимальную высоту элемента. | UIComponent | |
|
Возвращает минимальную ширину элемента. | UIComponent | |
|
Возвращает массив объектов, расположенных ниже указанной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
|
Возвращает предпочтительную высоту элемента. | UIComponent | |
|
Возвращает предпочтительную ширину элемента. | UIComponent | |
|
Возвращает прямоугольник, определяющий границу объекта отображения по системе координат, определенной параметром targetCoordinateSpace за исключением линий фигур. | DisplayObject | |
|
Возвращает элемент в dataProvider, использованный указанным Repeater для создания этого Repeater, или null, если повторение этого Repeater не выполнено. | UIComponent | |
|
Получает свойство style, которое было установлено в любом месте в пределах цепочки поиска стиля этого компонента. | UIComponent | |
|
Преобразует объект Point из глобальных координат в координаты содержимого. | UIComponent | |
|
Преобразует объект Point из координат рабочей области (глобальных) в координаты отображаемого объекта (локальные). | DisplayObject | |
|
Преобразует двумерный объект Point из координат рабочей области (глобальных) в координаты экранного трехмерного объекта (локальные). | DisplayObject | |
|
Возвращает true, если для currentCSSState не указано значение null. | UIComponent | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Определяет, было ли указанное состояние задано в данном UIComponent. | UIComponent | |
|
Вычисляет ограничительную рамку экранного объекта, чтобы определить, не перекрывает и не пересекает ли она ограничительную рамку экранного объекта obj. | DisplayObject | |
|
Вычисляет экранный объект, чтобы определить, перекрывает ли он точку, заданную координатами x и y, или пересекает ее. | DisplayObject | |
|
Возвращает матрицу прямоугольника, которая может быть передана в метод drawRoundRect() метод как параметр rot при рисовании горизонтального градиента. | UIComponent | |
|
Инициализирует внутреннюю структуру этого компонента. | UIComponent | |
|
Инициализирует разные свойства, которые отслеживают повторенные экземпляры этого компонента. | UIComponent | |
|
Отмечает компонент с целью вызова его метода updateDisplayList() во время последующего обновления экрана. | UIComponent | |
|
Вызывается элементами компонента для указания, что свойство depth было изменено. | UIComponent | |
|
Элемент должен вызывать этот метод при изменении своего layoutDirection или при изменении своего вышестоящего layoutDirection. | UIComponent | |
|
Отмечает компонент с целью вызова его метода commitProperties() во время последующего обновления экрана. | UIComponent | |
|
Отмечает компонент с целью вызова его метода measure() во время последующего обновления экрана. | UIComponent | |
|
Отмечает компонент с целью установки нового состояния темы оформления во время последующего обновления экрана. | SkinnableComponent | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Преобразует трехмерный объект point из координат трехмерного экранного объекта (локальных) в двухмерный объект point с координатами рабочей области (глобальными). | DisplayObject | |
|
Преобразует объект Point из координат содержимого в локальные координаты. | UIComponent | |
|
Преобразует объект Point из координат экранного объекта (локальных) в координаты рабочей области (глобальные). | DisplayObject | |
|
Возвращает значение true, если cssState совпадает с currentCSSState. | UIComponent | |
|
Определяет, совпадает ли этот экземпляр с данным типом (или является его подклассом). | UIComponent | |
|
Выполняет измерения для указанного текста HTML, который может содержать HTML-теги, например <font> и <b>. При этом предполагается, что текст отображается в однострочном поле UITextField при помощи объекта UITextFormat, определяемого стилями этого UIComponent. | UIComponent | |
|
Выполняет измерения для указанного текста. При этом предполагается, что текст отображается в однострочном поле UITextField (или UIFTETextField) при помощи объекта UITextFormat, определяемого стилями этого UIComponent. | UIComponent | |
|
Перемещает компонент в указанное положение в пределах его вышестоящего элемента. | UIComponent | |
|
Обеспечивает распространение изменений стиля для нижестоящих элементов. | UIComponent | |
|
Возвращает значение true, если цепочка свойств owner направлена от child к этому UIComponent. | UIComponent | |
|
Вызывается Flex при добавлении или удалении объекта UIComponent из вышестоящего элемента. | UIComponent | |
|
Готовит IFlexDisplayObject к печати. | UIComponent | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Создает или восстанавливает кэш стиля CSS для этого компонента и, если параметр recursive является true, также для всех нижестоящих элементов этого компонента. | UIComponent | |
|
Обеспечить регистрацию EffectManager в качестве одного из прослушивателей события для каждого события эффекта. | UIComponent | |
|
Удаляет все дочерние экземпляры DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer. | DisplayObjectContainer | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
|
Удаляет клиент с невизуальным стилем из экземпляра компонента. | UIComponent | |
|
Воспроизводит указанное событие. | UIComponent | |
|
Вызывает виртуальную клавиатуру. | InteractiveObject | |
|
Определяет нижестоящий элемент с помощью предоставленного идентификатора. | UIComponent | |
| [статические]
Возобновляет фоновую обработку методов, поставленных в очередь callLater() после вызова suspendBackgroundProcessing(). | UIComponent | |
|
Размеры объекта. | UIComponent | |
|
Устанавливает значение ограничения макета, совпадающее со значением стиля ограничения для этого компонента. | UIComponent | |
|
Установить текущее состояние. | UIComponent | |
|
Задает фокус на этот компонент. | UIComponent | |
|
Устанавливает координаты, используемые элементом для отображения на экране. | UIComponent | |
|
Устанавливает размер макета элемента. | UIComponent | |
|
Устанавливает матрицу преобразования, используемую для определения размера макета компонента и его позиции относительно соответствующих элементов одного уровня. | UIComponent | |
|
Устанавливает трехмерную матрицу преобразования, используемую для определения размера макета компонента и его позиции относительно соответствующих элементов одного уровня. | UIComponent | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Задает свойство style для экземпляра компонента. | UIComponent | |
|
Вызывается при изменении свойства visible. | UIComponent | |
|
Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану). | Sprite | |
|
Позволяет перетаскивать указанный спрайт на устройстве с сенсорным экраном. | Sprite | |
|
Рекурсивно останавливает выполнение временной шкалы всех фрагментов MovieClip, размещенных в корне этого объекта. | DisplayObjectContainer | |
|
Завершает метод startDrag(). | Sprite | |
|
Завершает выполнение метода startTouchDrag(), используется для устройств с сенсорным экраном. | Sprite | |
|
Обеспечивает обнаружение изменений в свойствах стиля. | UIComponent | |
|
Метод stylesInitialized() вызывается программой Flex при первой инициализации стиля компонента. | UIComponent | |
| [статические]
Блокирует фоновую обработку методов, поставленных в очередь callLater() до вызова resumeBackgroundProcessing(). | UIComponent | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
| [переопределить]
Возвращает строку, указывающую расположение этого объекта в иерархии объектов DisplayObject в приложении. | FlexSprite | |
| 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
Служебный метод для обновления вращения, масштабирования и перемещения преобразования при сохранении определенной точки, указанной в собственной области координат компонента, зафиксированной в области координат вышестоящего элемента. | UIComponent | |
|
Служебный метод для преобразования точки, указанной в локальных координатах этого объекта, к ее местоположению в координатах вышестоящего узла объекта. | UIComponent | |
|
Проверяет правильность расположения и размера нижестоящих элементов и отображает различные визуальные эффекты. | UIComponent | |
|
Проверяет и обновляет свойства и макет этого объекта, а также перерисовывает его в случае необходимости. | UIComponent | |
|
Используется в логике макета для проверки свойств компонента посредством вызова метода commitProperties(). | UIComponent | |
|
Проверяет правильность измеренного размера компонента. Если совместно с данным IlayoutManagerClient вызван метод LayoutManager.invalidateSize(), то при измерении будет вызван метод validateSize(). | UIComponent | |
|
Обрабатывает события valid и invalid из средства проверки, назначенного этому компоненту. | UIComponent | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Возвращает матрицу прямоугольника, которая может быть передана передать в drawRoundRect() как параметр rot при рисовании вертикального градиента. | UIComponent | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
События
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
| Передается при добавлении компонента к контейнеру как нижестоящего элемента содержимого с помощью метода addChild(), addChildAt(), addElement() или addElementAt(). | UIComponent | ||
| Отправляется, когда экранный объект добавляется в список отображения. | DisplayObject | ||
| Отправляется, когда экранный объект добавляется к списку отображения на монтажном столе либо непосредственно, либо путем добавления поддерева, содержащего экранный объект. | DisplayObject | ||
| Отправляется, когда пользователь выбирает команду «Удалить» из контекстного меню текста. | InteractiveObject | ||
| Отправляется, когда пользователь нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject. | InteractiveObject | ||
| Передается после завершения загрузки содержимого. | Image | |||
| Отправляется, когда жест пользователя вызывает контекстное меню, связанное с данным интерактивным объектом в приложении AIR. | InteractiveObject | ||
| Отправляется, когда пользователь активирует комбинацию клавиш быстрого вызова, используемую на данной платформе для операции «Копировать», или выбирает команду «Копировать» из контекстного меню. | InteractiveObject | ||
| Отправляется по завершении создания компонента, и обработки, измерения, размещения и отображения свойств. | UIComponent | ||
| Передается после изменения состояния представления. | UIComponent | ||
| Передается после изменения свойства currentState, но перед изменением состояния представления. | UIComponent | ||
| Отправляется, когда пользователь активирует комбинацию клавиш быстрого вызова, используемую на данной платформе для операции «Вырезать», или выбирает команду «Вырезать» из контекстного меню. | InteractiveObject | ||
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | ||
| Отправляется, когда пользователь дважды нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject, а флаг doubleClickEnabled для этого объекта имеет значение true. | InteractiveObject | ||
| Передается инициатором перетаскивания (компонентом, который является источником перетаскиваемых данных) по завершении операции перетаскивания, либо после опускания перетаскиваемых данных на целевой объект, либо по завершении операции перетаскивания без опускания данных. | UIComponent | ||
| Передается целевым объектом перетаскивания, когда пользователь отпускает на нем кнопку мыши. | UIComponent | ||
| Передается компонентом при перемещении пользователем курсора мыши над компонентом в процессе операции перетаскивания. | UIComponent | ||
| Передается компонентом, когда пользователь перетаскивает данные за пределы компонента, но не опускает их на целевой объект. | UIComponent | ||
| Передается компонентом при перемещении пользователем курсора мыши при нахождении над компонентом в процессе операции перетаскивания. | UIComponent | ||
| Отправляется инициатором перетаскивания после начала операции перетаскивания. | UIComponent | ||
| Отправляется по завершении эффекта. | UIComponent | ||
| Отправляется непосредственно перед запуском эффекта. | UIComponent | ||
| Отправляется после завершения эффекта, которое выполняется только после вызова метода stop(). | UIComponent | ||
| [многоадресное событие] Отправляется, когда точка воспроизведения переходит в новый кадр. | DisplayObject | ||
| Отправляется после входа компонента в состояние представления. | UIComponent | ||
| [многоадресное событие] Отправляется, когда точка воспроизведения покидает текущий кадр. | DisplayObject | ||
| Отправляется непосредственно перед выходом компонента из состояния представления. | UIComponent | ||
| Отправляется после того, как экранный объект перемещается в фокус. | InteractiveObject | ||
| Отправляется после того, как экранный объект теряет фокус. | InteractiveObject | ||
| [многоадресное событие] Отправляется после завершения работы конструкторов экранных объектов кадра до выполнения сценариев кадра. | DisplayObject | ||
| Отправляется, когда пользователь создает точку контакта вдоль края сенсорной поверхности с помощью экземпляра InteractiveObject (например, нажатие по краю сенсорной поверхности на пульте Siri Remote для Apple TV). Некоторые устройства также могут интерпретировать этот контакт как комбинацию нескольких событий касания. | InteractiveObject | ||
| Отправляется, когда пользователь наживает две точки контакта над одним экземпляром InteractiveObject на устройстве с сенсорным экраном (например, двумя пальцами нажимает точки над экранным объектом и отпускает их при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь перемещает точку контакта с экземпляром InteractiveObject на устройстве с сенсорным экраном (например, касается пальцем и проводит им слева направо над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь выполняет жест поворота в точке контакта с экземпляром InteractiveObject (например, касание двумя пальцами и их вращение над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь выполняет жест выделения в точке контакта с экземпляром InteractiveObject (например, касание экрана тремя пальцами и их параллельное перемещение над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь создает точку контакта с экземпляром InteractiveObject, а затем касается сенсорного экрана (например, касается экранного объекта несколькими пальцами, чтобы открыть меню, а затем касается одним пальцем для выбора нужного элемента меню при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь выполняет жест увеличения в точке контакта с экземпляром InteractiveObject (например, касание экрана двумя пальцами и их быстрое разведение в стороны над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Возникает при изменении состояния объекта с «Видимый» на «Невидимый». | UIComponent | ||
| Передается при сетевом запросе по HTTP, если Flash Player или AIR могут определить код состояния HTTP. | Image | |||
| Это событие отправляется любой клиентской программе, которая поддерживает линейный ввод с помощью IME. | InteractiveObject | ||
| Передается по окончании создания компонента и установки всех свойств инициализации. | UIComponent | ||
| Отправляется, когда компонент контролируется средством проверки, и при проверке произошел сбой. | UIComponent | ||
| Отправляется при возникновении ошибки ввода-вывода. | Image | |||
| Отправляется, когда пользователь нажимает клавишу. | InteractiveObject | ||
| Отправляется, когда пользователь пытается изменить фокус с помощью клавиатуры. | InteractiveObject | ||
| Отправляется, когда пользователь отпускает клавишу. | InteractiveObject | ||
| Отправляется, когда пользователь нажимает и отпускает среднюю кнопку указывающего устройства над одним и тем же объектом InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь нажимает среднюю кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь нажимает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | ||
| Передается из компонента, открытого с использованием PopUpManager, когда пользователь щелкает кнопкой мыши вне его пределов. | UIComponent | ||
| Отправляется, когда пользователь пытается изменить фокус с помощью указывающего устройства. | InteractiveObject | ||
| Отправляется, когда пользователь перемещает указывающее устройство в момент, когда курсор находится над объектом InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь перемещает указатель с экземпляра InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | ||
| Отправляется при прокрутке колеса мыши над экземпляром InteractiveObject. | InteractiveObject | ||
| Передается из компонента, открытого с помощью PopUpManager, при прокручивании пользователем колеса мыши вне его пределов. | UIComponent | ||
| Передается при перемещении объекта. | UIComponent | ||
| Отправляется инициатором перетаскивания InteractiveObject, когда пользователь завершает жест перетаскивания. | InteractiveObject | ||
| Отправляется целевым объектом InteractiveObject при принятии перетаскиваемого объекта вызовом метода DragManager.acceptDragDrop(). | InteractiveObject | ||
| Отправляется объектом InteractiveObject, когда жест перетаскивания входит в его границы. | InteractiveObject | ||
| Отправляется объектом InteractiveObject, когда жест перетаскивания выходит за границы этого объекта. | InteractiveObject | ||
| Постоянно отправляется объектом InteractiveObject, пока жест перетаскивания остается в пределах его границ. | InteractiveObject | ||
| Отправляется в начале операции перетаскивания объектом InteractiveObject, заданным в качестве инициатора перетаскивания в вызове метода DragManager.doDrag(). | InteractiveObject | ||
| Отправляется во время операции перетаскивания объектом InteractiveObject, заданным в качестве инициатора перетаскивания в вызове метода DragManager.doDrag(). | InteractiveObject | ||
| Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции «Вставить», или выбирает команду «Вставить» из контекстного меню. | InteractiveObject | ||
| Передается в начале последовательности инициализации компонента. | UIComponent | ||
| Передается во время загрузки содержимого. | Image | |||
| Отправляется, когда пользователь опускает активное перо ниже установленного для экрана порога обнаружения приближения. | InteractiveObject | ||
| Отправляется, когда пользователь поднимает активное перо, превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | ||
| Отправляется, когда пользователь наводит активное перо на экран, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | ||
| Отправляется, когда пользователь переводит активное перо от этого объекта InteractiveObject, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | ||
| Отправляется, когда пользователь наводит активное перо непосредственно на этот объект InteractiveObject, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | ||
| Отправляется, когда пользователь перемещает активное перо от этого объекта InteractiveObject и любого из его дочерних объектов, не превышая установленный для экрана порог обнаружения приближения. | InteractiveObject | ||
| Отправляется, когда пользователь переводит активное перо на этот объект InteractiveObject из внешней части дерева потомков в списке отображения (не превышая установленный для экрана порог обнаружения близости). | InteractiveObject | ||
| Передается после завершения загрузки содержимого. | Image | |||
| Отправляется, когда пользователь отпускает кнопку позиционирующего устройства после ее нажатия над экземпляром InteractiveObject и последующего перемещения позиционирующего устройства с экземпляра InteractiveObject. | InteractiveObject | ||
| Передается при удалении компонента из контейнера как нижестоящего элемента содержимого с помощью метода removeChild(), removeChildAt(), removeElement() или removeElementAt(). | UIComponent | ||
| Отправляется перед удалением экранного объекта из списка отображения. | DisplayObject | ||
| Отправляется перед удалением экранного объекта из списка отображения либо напрямую, либо путем удаления поддерева, содержащего экранный объект. | DisplayObject | ||
| [многоадресное событие] Отправляется перед обновлением и визуализацией списка отображения. | DisplayObject | ||
| Отправляется при изменении размеров компонента. | UIComponent | ||
| Отправляется, когда пользователь нажимает и отпускает правую кнопку указывающего устройства над одним и тем же объектом InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь нажимает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь перемещает указатель с экземпляра InteractiveObject. | InteractiveObject | ||
| Отправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject. | InteractiveObject | ||
| Передается при возникновении ошибки системы безопасности. | Image | |||
| Отправляется, когда пользователь активирует комбинацию клавиш ускорения, используемую на данной платформе для операции «Выделить все», или выбирает команду «Выделить все» из контекстного меню. | InteractiveObject | ||
| Передается при изменении состояния объекта с «Невидимый» на «Видимый». | UIComponent | ||
| Отправляется сразу после того, как программная клавиатура вызывается. | InteractiveObject | ||
| Передается немедленно перед тем, как программная клавиатура появляется на экране. | InteractiveObject | ||
| Передается немедленно после того, как программная клавиатура убирается с экрана. | InteractiveObject | ||
| Отправляется после перехода компонента в новое состояние и завершения воспроизведения анимации перехода в это состояние. | UIComponent | ||
| Отправляется, когда компонент прерывает переход в текущее состояние для переключения в новое состояние. | UIComponent | ||
| Отправляется, когда изменяется значение свойства tabChildren объекта. | InteractiveObject | ||
| Отправляется при изменении флага tabEnabled объекта. | InteractiveObject | ||
| Отправляется, когда изменяется значение свойства tabIndex объекта. | InteractiveObject | ||
| Передается, если пользователь вводит один или несколько символов текста. | InteractiveObject | ||
| Передается компонентом перед созданием ToolTip. | UIComponent | ||
| Передается компонентом, когда ToolTip скрывается и вскоре будет удален. | UIComponent | ||
| Передается компонентом перед скрытием ToolTip. | UIComponent | ||
| Передается компонентом перед отображением ToolTip. | UIComponent | ||
| Передается компонентом при отображении ToolTip. | UIComponent | ||
| Передается компонентом с установленным свойством toolTip при наведении пользователем курсора мыши. | UIComponent | ||
| Отправляется, когда пользователь впервые создает точку контакта с сенсорным экраном устройства (например, касается сенсорного экрана мобильного телефона или планшетного компьютера). | InteractiveObject | ||
| Отправляется, когда пользователь убирает точку контакта с сенсорным экраном устройства (например, поднимает палец с сенсорного экрана мобильного телефона или планшетного компьютера). | InteractiveObject | ||
| Неотменяемое событие, которое отправляется компонентом при завершении реагирования на касание пользователя | UIComponent | ||
| Неотменяемое событие, которое отправляется компонентом в начале реагирования на касание пользователя | UIComponent | ||
| Отменяемое событие, которое отправляется компонентом при попытке реагирования на касание пользователя | UIComponent | ||
| Отправляется, когда пользователь касается устройства, и продолжает отправляться до тех пор, пока точка контакта не будет удалена. | InteractiveObject | ||
| Отправляется, когда пользователь перемещает точку контакта от экземпляра InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с одного экранного объекта на другой при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь перемещает точку контакта над экземпляром InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с точки за пределами экранного объекта в точку над ним при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь удаляет точку контакта из экземпляра InteractiveObject на сенсорном устройстве (например, переводит палец из положения над экранным объектом в точку за пределами экранного объекта на мобильном телефоне или планшете с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь перемещает точку контакта над экземпляром InteractiveObject на устройстве с сенсорным экраном (например, перетаскивает палец с точки за пределами экранного объекта в точку над ним при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется, когда пользователь поднимает точку контакта над тем же экземпляром InteractiveObject, с которым был установлен первичный контакт на сенсорном экране (например, нажимает точку на экранном объекте и поднимает палец с той же точки при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). | InteractiveObject | ||
| Отправляется при вызове объектом методов commitProperties(), measure() и updateDisplayList() (при необходимости). | UIComponent | ||
| Отправляется, когда компонент контролируется средством проверки, и проверка успешно выполнена. | UIComponent | ||
| Отправляется при изменении значений программным способом или в результате действий пользователя. | UIComponent | ||
Стили
Стили являются либо общими, либо связанными с определенной темой. Если стиль общий, он может использоваться с любой темой. Если стиль связан с определенной темой, он может использоваться, только если ваше приложение использует ее.
Общие стили
| Стиль | Описание | Определено | ||
|---|---|---|---|---|
| Тип: String Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Расстояние по вертикали от верхнего края области содержимого до положения базовой линии элемента управления в пикселях. | UIComponent | ||
| Тип: String Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Расстояние по вертикали от нижнего края компонента до нижнего края области содержимого его вышестоящего контейнера в пикселях. | UIComponent | ||
enableLoadingState | Тип: Boolean Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 4.5 Версии среды выполнения: Flash9, AIR 1.1 Если true, включает состояние loading темы оформления.
Значением по умолчанию является false. | Image | ||
| Тип: uint Формат: Color Наследование CSS: Да Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Цвет выделения компонента при неудачном выполнении проверки. | UIComponent | ||
| Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Имя класса темы оформления, используемое для этого компонента при возникновении ошибки проверки. | SkinnableComponent | ||
| Тип: String Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Режим наложения, используемый прямоугольником фокусировки. | UIComponent | ||
| Тип: Class Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Тема оформления для рисования прямоугольника фокусировки. | UIComponent | ||
| Тип: Number Формат: Length Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Толщина контура прямоугольника фокусировки в пикселях. | UIComponent | ||
| Тип: String Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Горизонтальное расстояние в пикселях от центра области содержимого компонента до центра компонента. | UIComponent | ||
| Тип: String Наследование CSS: Да Язык версии: ActionScript 3.0 Версия продукта: Flex 4.5 Версии среды выполнения: Flash10, AIR 2.5 Первичный режим взаимодействия для этого компонента. | UIComponent | ||
| Тип: String Наследование CSS: Да Язык версии: ActionScript 3.0 Версия продукта: Flex 4.1 Версии среды выполнения: Flash10, AIR 1.5 Указывает требуемое направление макета компонента. | UIComponent | ||
| Тип: String Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Расстояние по горизонтали от левого края компонента до левого края области содержимого его вышестоящего контейнера в пикселях. | UIComponent | ||
| Тип: String Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Расстояние по горизонтали от правого края компонента до правого края области содержимого его вышестоящего контейнера в пикселях. | UIComponent | ||
| Тип: Boolean Наследование CSS: Да Язык версии: ActionScript 3.0 Версия продукта: Flex 4.5 Версии среды выполнения: Flash10, AIR 1.5 Отображение рамки или темы ошибки, когда этот компонент недействителен | UIComponent | ||
| Тип: Boolean Наследование CSS: Да Язык версии: ActionScript 3.0 Версия продукта: Flex 4.5 Версии среды выполнения: Flash10, AIR 1.5 Отображение подсказки об ошибке, когда этот компонент недействителен и пользователь наводит на него курсор мыши | UIComponent | ||
| Тип: Class Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Имя класса тем оформления, используемого для этого компонента. | SkinnableComponent | ||
smoothingQuality | Тип: String Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 4.5 Версии среды выполнения: Flash9, AIR 1.1 Стиль, эквивалентный свойству smoothingQuality для BitmapImage. При указании значения BitmapSmoothingQuality.BEST изображение преобразуется (если данные получены из доверенного источника) с целью получения изображения более высокого качества. При установленном BitmapSmoothingQuality.DEFAULT будет использоваться качество рабочей области по умолчанию для масштабируемых заливок растровых изображений.
Значением по умолчанию является . | Image | ||
| Тип: String Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Расстояние по вертикали от верхнего края компонента до верхнего края области содержимого его вышестоящего контейнера в пикселях. | UIComponent | ||
| Тип: String Наследование CSS: Нет Язык версии: ActionScript 3.0 Версия продукта: Flex 3 Версии среды выполнения: Flash9, AIR 1.1 Расстояние по вертикали в пикселях от центра области содержимого компонента до центра компонента. | UIComponent | ||
Стили тем Spark
| Стиль | Описание | Определено | ||
|---|---|---|---|---|
backgroundAlpha | Тип: Number Наследование CSS: Нет Тема: spark, mobile Язык версии: ActionScript 3.0 Версия продукта: Flex 4.5 Версии среды выполнения: Flash10, AIR 2.5 Значение альфа-канала фона для данного компонента. Значением по умолчанию является NaN. | Image | ||
backgroundColor | Тип: uint Формат: Color Наследование CSS: Нет Тема: spark, mobile Язык версии: ActionScript 3.0 Версия продукта: Flex 4.5 Версии среды выполнения: Flash10, AIR 2.5 Цвет фона для этого компонента. Значением по умолчанию является NaN. | Image | ||
| Тип: uint Формат: Color Наследование CSS: Да Тема: spark, mobile Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Основной цвет компонента. | SkinnableComponent | ||
Mobile Theme Стили
| Стиль | Описание | Определено | ||
|---|---|---|---|---|
backgroundAlpha | Тип: Number Наследование CSS: Нет Тема: spark, mobile Язык версии: ActionScript 3.0 Версия продукта: Flex 4.5 Версии среды выполнения: Flash10, AIR 2.5 Значение альфа-канала фона для данного компонента. Значением по умолчанию является NaN. | Image | ||
backgroundColor | Тип: uint Формат: Color Наследование CSS: Нет Тема: spark, mobile Язык версии: ActionScript 3.0 Версия продукта: Flex 4.5 Версии среды выполнения: Flash10, AIR 2.5 Цвет фона для этого компонента. Значением по умолчанию является NaN. | Image | ||
| Тип: uint Формат: Color Наследование CSS: Да Тема: spark, mobile Язык версии: ActionScript 3.0 Версия продукта: Flex 4 Версии среды выполнения: Flash10, AIR 1.5 Основной цвет компонента. | SkinnableComponent | ||
Компоненты темы оформления
В этом компоненте используются темы оформления, состоящие из компонентов тем оформления. Непосредственную установку элементов темы оформления выполнять не требуется. Элементы темы оформления устанавливаются темой оформления компонента.
| Компонент темы оформления | Описание | Определено | ||
|---|---|---|---|---|
imageDisplay:BitmapImage | Обязательное: true Тип компонента: Статический Язык версии: ActionScript 3.0 Версия продукта: Flex 4.5 Версии среды выполнения: Flash10, AIR 2.5 Необходимый элемент темы оформления, определяющий содержимое изображения. | Image | ||
progressIndicator:Range | Обязательное: false Тип компонента: Статический Язык версии: ActionScript 3.0 Версия продукта: Flex 4.5 Версии среды выполнения: Flash10, AIR 2.5 Дополнительный элемент темы оформления, отображающий текущее выполнение загрузки. В целях удобства значение progressIndicator автоматически обновляется и отображает ход выполнения в виде процентов во время загрузки. | Image | ||
Состояния тем оформления
Для установки темы оформления компонента реализуйте тему оформления, которая определяет следующие состояния. Несмотря на необходимость реализации всех состояний темы оформления, состояние темы оформления может быть пустым. Пустое состояние темы оформления указывает на отсутствие изменений темы оформления по умолчанию.
Эффекты
Общедоступные константы
Сведения о свойстве
bitmapData | свойство |
bitmapData:BitmapData [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Возвращает копию объекта BitmapData, представляющего загруженное в настоящий момент содержимое изображения (немасштабируемое). Это свойство имеет значение null для ненадежного междоменного содержимого.
Значением по умолчанию является null.
Реализация
public function get bitmapData():BitmapDatabytesLoaded | свойство |
bytesLoaded:Number [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Количество байтов загруженного изображения. Относится только к изображениям, загруженным URL-адресом запроса.
Значением по умолчанию является NaN.
Реализация
public function get bytesLoaded():NumberbytesTotal | свойство |
bytesTotal:Number [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Общее количество данных изображения, которые загружены или находятся в ожидании загрузки, в байтах. Относится только к изображениям, загруженным URL-адресом запроса.
Значением по умолчанию является NaN.
Реализация
public function get bytesTotal():NumberclearOnLoad | свойство |
clearOnLoad:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Обозначает, следует ли удалить предыдущее содержимое изображения до загрузки нового содержимого.
Значением по умолчанию является true.
Реализация
public function get clearOnLoad():Boolean public function set clearOnLoad(value:Boolean):voidcontentLoader | свойство |
contentLoader:IContentLoader| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Дополнительный пользовательский загрузчик изображений (например, кэш или очередь изображений) для связи с клиентом загрузчика содержимого.
Значением по умолчанию является null.
Реализация
public function get contentLoader():IContentLoader public function set contentLoader(value:IContentLoader):voidcontentLoaderGrouping | свойство |
contentLoaderGrouping:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Дополнительный идентификатор группировки содержимого для передачи в метод load() связанного экземпляра IContentLoader. Это свойство рассматривается только в том случае, если назначен правильный contentLoader.
Значением по умолчанию является null.
Реализация
public function get contentLoaderGrouping():String public function set contentLoaderGrouping(value:String):voidfillMode | свойство |
fillMode:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.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
horizontalAlign | свойство |
horizontalAlign:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.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):voidpreliminaryHeight | свойство |
preliminaryHeight:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Обеспечивает оценку высоты, когда для макета требуются измеренные границы изображения, но загрузка данных изображения еще не завершена. Если NaN, то измеренной высотой является 0 до окончания загрузки изображения.
Значением по умолчанию является NaN.
Реализация
public function get preliminaryHeight():Number public function set preliminaryHeight(value:Number):voidpreliminaryWidth | свойство |
preliminaryWidth:Number| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Обеспечивает оценку ширины, когда для макета требуются измеренные границы изображения, но загрузка данных изображения еще не завершена. Если NaN, то измеренной шириной является 0 до окончания загрузки изображения.
Значением по умолчанию является NaN.
Реализация
public function get preliminaryWidth():Number public function set preliminaryWidth(value:Number):voidscaleMode | свойство |
scaleMode:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Определяет способ изменения масштаба изображения, если для fillMode указано значение mx.graphics.BitmapFillMode.SCALE.
Если указано mx.graphics.BitmapScaleMode.STRETCH ("stretch"), то изображение растягивается в соответствии с указанными размерами.
Если указано BitmapScaleMode.LETTERBOX ("letterbox"), то масштабирование изображения выполняется с учетом исходных пропорций изображения до масштабирования.
Если указано BitmapScaleMode.ZOOM ("zoom"), то масштабирование изображения выполняется с учетом исходных пропорций изображения до масштабирования. В результате изображение обрезается по одной из осей.
Значением по умолчанию является BitmapScaleMode.LETTERBOX.
Реализация
public function get scaleMode():String public function set scaleMode(value:String):voidСвязанные элементы API
smooth | свойство |
smooth:Boolean| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Указывает, применять ли алгоритм смягчения к растровому изображению.
При выборе значения false визуализируются растровые изображения, увеличенные при помощи алгоритма ближайшего соседнего пикселя, которые могут выглядеть нечетко. При выборе значения true увеличенное растровое изображение визуализируется с помощью билинейного алгоритма. Обычно процедура визуализации с помощью алгоритма ближайшего соседнего пикселя требует меньше времени.
Значением по умолчанию является false.
Реализация
public function get smooth():Boolean public function set smooth(value:Boolean):voidsource | свойство |
source:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Источник, используемый для растровой заливки. Заливка может выполняться на основе различных графических источников, включая следующие.
- Растровое изображение или экземпляр BitmapData.
- Класс, представляющий подкласс DisplayObject. BitmapFill реализует класс и выполняет его растровую визуализацию.
- Экземпляр DisplayObject. BitmapFill копирует его в растровое изображение для заливки.
- Имя внешнего файла изображения.
В качестве источника может быть файл изображения типа PNG, GIF или JPG.
Для указания источника встроенного изображения можно использовать директиву @Embed, как показано в следующем примере:
source="@Embed('<i>image_location</i>')"
Местоположением изображения может служить URL-адрес, URLRequest или ссылка на файл. Если это ссылка на файл, ее местоположение определяется местоположением компилируемого файла.
Класс BitmapImage предназначен для работы со встроенными изображениями или с изображениями, загружаемыми во время выполнения.
Если источником является экземпляр Bitmap или BitmapData или внешний графический файл, то вызывающий объект должен удалить источник, как только он не будет требоваться. Если ImageLoader создал экземпляр BitmapData, то затем он удалит BitmapData при первом изменении источника.
Реализация
public function get source():Object public function set source(value:Object):voidsourceHeight | свойство |
sourceHeight:Number [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Предоставляет немасштабируемую высоту данных исходного изображения.
Значением по умолчанию является NaN.
Реализация
public function get sourceHeight():NumbersourceWidth | свойство |
trustedSource | свойство |
trustedSource:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Флаг только для чтения, обозначающий, считается ли текущее содержимое загруженным из источника, политика безопасности которого разрешает междоменный доступ к изображениям. При значении false не разрешены расширенные операции с растровыми объектами, например масштабирование с высоким качеством или создание мозаичных изображений. Этот флаг устанавливается после полной загрузки изображения.
Значением по умолчанию является true.
Реализация
public function get trustedSource():BooleanverticalAlign | свойство |
verticalAlign:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Выравнивание содержимого по вертикали, если отсутствуют однозначные пропорции и для scaleMode установлено значение mx.graphics.BitmapScaleMode.LETTERBOX.
Допустимые значения: VerticalAlign.TOP ("top"), VerticalAlign.BOTTOM ("bottom") или VerticalAlign.MIDDLE ("middle").
Это свойство применяется только в случае, когда для scaleMode указано BitmapFillMode.SCALE ("scale").
Значением по умолчанию является HorizontalAlign.MIDDLE.
Реализация
public function get verticalAlign():String public function set verticalAlign(value:String):voidСведения о конструкторе
Image | () | Конструктор |
public function Image()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Конструктор.
Сведения о событии
complete | Событие |
Тип объекта события:
свойство Event.type =
flash.events.Eventсвойство Event.type =
flash.events.Event.COMPLETE| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Отправляется после завершения загрузки содержимого. Это событие отправляется только для url-адреса и источников на основе ByteArray, для которых требуется Loader.
Обратите внимание, что для содержимого, загруженного с помощью Loader, отправляются события ready и complete.
ready.
Константа Event.COMPLETE определяет значение свойства type объекта complete.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Сетевой объект, который завершил загрузку. |
httpStatus | Событие |
Тип объекта события:
свойство HTTPStatusEvent.type =
flash.events.HTTPStatusEventсвойство HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_STATUS| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Передается при сетевом запросе по HTTP, если Flash Player или AIR могут определить код состояния HTTP.
КонстантаHTTPStatusEvent.HTTP_STATUS определяет значение свойства type объекта события httpStatus.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
status | Код состояния HTTP, возвращенный сервером. |
target | Сетевой объект, получающий код состояния НТТР. |
ioError | Событие |
Тип объекта события:
свойство IOErrorEvent.type =
flash.events.IOErrorEventсвойство IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Отправляется при возникновении ошибки ввода-вывода.
Задает значение свойстваtype для объекта события ioError.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
errorID | Ссылочный номер, связываемый с конкретной ошибкой (только AIR). |
target | Сетевой объект, с которым произошла ошибка ввода/вывода. |
text | Текст, отображаемый в качестве сообщения об ошибке. |
Связанные элементы API
progress | Событие |
Тип объекта события:
свойство ProgressEvent.type =
flash.events.ProgressEventсвойство ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Передается во время загрузки содержимого.
Примечание. Передача события progress не является обязательной. Событие complete может быть получено без передачи события progress. Это возможно в том случае, если загружаемое содержимое является локальным файлом.
type для объекта события progress.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
bytesLoaded | Число элементов или байтов, загруженных на момент обработки события прослушивателем. |
bytesTotal | Общее число элементов или байтов, которые в итоге будут получены в случае успешного завершения загрузки. |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект, сообщающий сведения о прогрессе. |
ready | Событие |
Тип объекта события:
свойство FlexEvent.type =
mx.events.FlexEventсвойство FlexEvent.type =
mx.events.FlexEvent.READY| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Отправляется после завершения загрузки содержимого. В отличие от события 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 | Событие |
Тип объекта события:
свойство SecurityErrorEvent.type =
flash.events.SecurityErrorEventсвойство SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10, AIR 2.5 |
Передается при возникновении ошибки системы безопасности.
КонстантаSecurityErrorEvent.SECURITY_ERROR определяет значение свойства type для объекта события securityError.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Сетевой объект, сообщающий об ошибке безопасности. |
text | Текст, отображаемый в качестве сообщения об ошибке. |
Связанные элементы API
Tue Jun 12 2018, 11:34 AM Z