DataTransform

Пакет	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. Это позволяет отображать диаграмму с несколькими наборами данных, визуализация которых выполнена в той же самой области, но с другими диапазонами. Например, требуется показать годовые доходы в сравнении с числом проданных единиц. Если бы годовой доход был в миллионах, а единицы в тысячах, то визуализацию этих данных было бы сложно выполнить в одном диапазоне. Наложение их в разных объектах DataTransform позволяет конечному пользователю сравнивать изменения в значениях при выполнении визуализации с различными диапазонами.

Диаграммы могут содержать только один набор DataTransform.

В основном используется объект ChartBase, скрывающий существование объекта DataTransform между диаграммой с содержащимися в ней объектами глифов и осей. При создании собственных объектов ChartElement для правильной реализации их элемента необходимо понимать методы класса DataTransform.

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

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

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

	Свойство		Определено
		axes : Object [только для чтения] Набор осей, связанных с этим преобразованием.	DataTransform
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		elements : Array Элементы, связанные с этим преобразованием.	DataTransform

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

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

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

	Метод		Определено
		DataTransform() Конструктор.	DataTransform
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	EventDispatcher
		dataChanged():void Предоставляет объекту DataTransform информацию об изменении основных данных, представленных в диаграмме.	DataTransform
		describeData(dimension:String, requiredFields:uint):Array Собирает важные отображаемые значения для всех элементов, связанных с преобразованием этих данных.	DataTransform
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	EventDispatcher
		getAxis(dimension:String):IAxis Извлекает экземпляр оси, отвечающий за преобразование измерения данных, указанное параметром dimension.	DataTransform
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	EventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		invertTransform(... values):Array Преобразует координаты x и y относительно системы координат DataTransform в двухмерное значение в области данных.	DataTransform
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		setAxis(dimension:String, v:IAxis):void Назначает экземпляр оси для определенного измерения преобразования.	DataTransform
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		transformCache(cache:Array, xField:String, xConvertedField:String, yField:String, yConvertedField:String):void Отображает набор числовых значений, представляющих данные экранных координат.	DataTransform
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

События

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

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

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

	Сводка	Определено
activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.	EventDispatcher
deactivate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.	EventDispatcher
transformChange	Передается при изменении преобразования из области данных в область экрана, как правило, из-за того, что оси, составляющие преобразование, каким-либо образом изменились или само преобразование данных имеет размер.	DataTransform

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

axes

свойство

axes:Object [только для чтения]

Язык версии:

ActionScript 3.0

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

Flex 3

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

Flash Player 9, AIR 1.1

Набор осей, связанных с этим преобразованием.

Реализация
public function get axes():Object

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

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

()

Конструктор

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

mx.charts.LinearAxis

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` всегда используется для получения доступа к объекту, прослушивающему событие.

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

DataTransform - AS3 Flex

Пакетыx

Элементы языка

Приложения

Пакет mx.charts.chartClasses

axes

elements

DataTransform

dataChanged

describeData

getAxis

invertTransform

setAxis

transformCache

transformChange