| Пакет | mx.charts.chartClasses |
| Класс | public class DataTransform |
| Наследование | DataTransform  EventDispatcher Object |
| Подклассы | CartesianTransform, PolarTransform |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Теоретически диаграмма может содержать несколько перекрывающихся объектов DataTransform. Это позволяет отображать диаграмму с несколькими наборами данных, визуализация которых выполнена в той же самой области, но с другими диапазонами. Например, требуется показать годовые доходы в сравнении с числом проданных единиц. Если бы годовой доход был в миллионах, а единицы в тысячах, то визуализацию этих данных было бы сложно выполнить в одном диапазоне. Наложение их в разных объектах DataTransform позволяет конечному пользователю сравнивать изменения в значениях при выполнении визуализации с различными диапазонами.
Диаграммы могут содержать только один набор DataTransform.
В основном используется объект ChartBase, скрывающий существование объекта DataTransform между диаграммой с содержащимися в ней объектами глифов и осей. При создании собственных объектов ChartElement для правильной реализации их элемента необходимо понимать методы класса DataTransform.
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
| axes : Object [только для чтения]
Набор осей, связанных с этим преобразованием. | DataTransform | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| elements : Array
Элементы, связанные с этим преобразованием. | DataTransform | ||
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | DataTransform | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
Предоставляет объекту DataTransform информацию об изменении основных данных, представленных в диаграмме. | DataTransform | ||
Собирает важные отображаемые значения для всех элементов, связанных с преобразованием этих данных. | DataTransform | ||
|
Посылает событие в поток событий. | EventDispatcher | |
Извлекает экземпляр оси, отвечающий за преобразование измерения данных, указанное параметром dimension. | DataTransform | ||
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
Преобразует координаты x и y относительно системы координат DataTransform в двухмерное значение в области данных. | DataTransform | ||
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
Назначает экземпляр оси для определенного измерения преобразования. | DataTransform | ||
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
transformCache(cache:Array, xField:String, xConvertedField:String, yField:String, yConvertedField:String):void
Отображает набор числовых значений, представляющих данные экранных координат. | DataTransform | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | ||
| Передается при изменении преобразования из области данных в область экрана, как правило, из-за того, что оси, составляющие преобразование, каким-либо образом изменились или само преобразование данных имеет размер. | DataTransform | |||
axes | свойство |
elements | свойство |
elements:Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Элементы, связанные с этим преобразованием. В этот массив входит фон, серия и перекрывающиеся элементы, связанные с этим преобразованием. Это значение назначено объектом диаграммы с вложением.
Реализация
public function get elements():Array public function set elements(value:Array):voidDataTransform | () | Конструктор |
public function DataTransform()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конструктор.
dataChanged | () | метод |
public function dataChanged():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Предоставляет объекту DataTransform информацию об изменении основных данных, представленных в диаграмме. Как правило, DataTransform не имеет информации об источнике основных данных, представляемых диаграммой. Таким образом, глифы должны выполнить вызов информации при изменении данных для получения возможности повторного вычисления шкал диапазона, основанного на их данных с помощью свойства DataTransform. Это не делает свойство DataTransform недействительным, так как нет гарантии, что данные изменились. Объекты оси (или объекты диапазона) должны инициировать событие снятия действительности.
describeData | () | метод |
public function describeData(dimension:String, requiredFields:uint):Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Собирает важные отображаемые значения для всех элементов, связанных с преобразованием этих данных. Экземпляры оси выполняют вызов этого метода с целью сбора значений, требуемых для определения момента, когда автоматическое создание назначается для диапазонов. Этот метод возвращает массив объектов BoundedValue.
Для сбора важных значений для горизонтальной оси CartesianTransform необходимо передать 0. Для сбора значений для вертикальной оси необходимо передать 1.
Параметры
dimension:String — Измерение, для которого требуется собрать значения.
| |
requiredFields:uint — Определяет данные, требуемые преобразованием.
|
Array — Массив объектов BoundedValue.
|
getAxis | () | метод |
public function getAxis(dimension:String):IAxis| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Извлекает экземпляр оси, отвечающий за преобразование измерения данных, указанное параметром dimension. При отсутствии предварительно назначенных осей создается ось по умолчанию. Осью по умолчанию для всех измерений является LinearAxis со свойством autoAdjust, установленным в значение false.
Параметры
dimension:String — Измерение, ось которого отвечает за преобразование данных.
|
IAxis — Экземпляр оси.
|
Связанные элементы API
invertTransform | () | метод |
public function invertTransform(... values):Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Преобразует координаты x и y относительно системы координат DataTransform в двухмерное значение в области данных.
Параметры
... values — Позиции X и Y (в этом порядке).
|
Array — Массив, содержащий преобразованные значения.
|
setAxis | () | метод |
public function setAxis(dimension:String, v:IAxis):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Назначает экземпляр оси для определенного измерения преобразования. Объекты Axis назначены объектом диаграммы с вложением.
Параметры
dimension:String — Измерение преобразования.
| |
v:IAxis — Целевой экземпляр оси.
|
transformCache | () | метод |
public function transformCache(cache:Array, xField:String, xConvertedField:String, yField:String, yConvertedField:String):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Отображает набор числовых значений, представляющих данные экранных координат. Этот метод предполагает, что все значения являются числами, так что все нечисловые значения должны быть предварительно преобразованы при помощи метода mapCache().
Параметры
cache:Array — Массив объектов, содержащих значения данные в полях. Также здесь хранятся преобразованные числовые значения функции.
| |
xField:String — Поле, в котором возможно обнаружение значений данных оси X.
| |
xConvertedField:String — Поле для сохранения отображаемой экранной координаты X.
| |
yField:String — Поле, в котором возможно обнаружение значений данных оси Y.
| |
yConvertedField:String — Поле для сохранения отображаемой экранной координаты Y.
|
transformChange | Событие |
mx.events.FlexEventсвойство FlexEvent.type =
mx.events.FlexEvent.TRANSFORM_CHANGE| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Передается при изменении преобразования из области данных в область экрана, как правило, из-за того, что оси, составляющие преобразование, каким-либо образом изменились или само преобразование данных имеет размер.
КонстантаFlexEvent.TRANSFORM_CHANGE определяет значение свойства type объекта события transformChange.
Свойства объекта события имеют следующие значения:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
Tue Jun 12 2018, 11:34 AM Z