IContainer  - AS3 Flex

Задает режим кнопки данного спрайта. При значении true этот спрайт ведет себя как кнопка, то есть запускает отображение курсора в виде руки, когда над ним проходит указатель, и может получать событие click при нажатии клавиш Enter и «Пробел», когда спрайт находится в фокусе. Можно отменить отображение курсора в виде руки, задав свойству useHandCursor значение false, в этом случае будет отображаться указатель.

В целом, для создания кнопок лучше использовать класс SimpleButton, однако свойство buttonMode можно использовать для придания спрайту некоторых функций кнопок. Чтобы включить спрайт в последовательность перехода посредством клавиши Tab, задайте свойству tabEnabled (унаследованному от класса InteractiveObject и имеющему по умолчанию значение false) значение true. Кроме того, подумайте, должны ли дочерние элементы спрайта реагировать на пользовательский ввод. Большинство кнопок блокируют воздействие пользовательского ввода на дочерние объекты, так как это препятствует нормальному потоку событий. Чтобы отключить воздействие пользовательского ввода на дочерние объекты, необходимо задать свойству mouseChildren (унаследованному от класса DisplayObjectContainer) значение false.

Если свойство buttonMode используется с классом MovieClip (подклассом класса Sprite), кнопка может получить дополнительные функции. Если включить кадры с подписями _up, _over и _down, проигрыватель Flash Player передает автоматические изменения состояния (функция, подобная возможностям фрагментов роликов, используемых в качестве кнопок, в предыдущих версиях ActionScript). Эти автоматические изменения состояния недоступны для спрайтов, так как у них нет временной шкалы и, следовательно, кадров для добавления подписей.

Контейнеры используют внутреннюю область содержимого для управления прокруткой. Для creatingContentPane установлено значение true, если контейнер создает область содержимого, так что некоторые события могут игнорироваться или блокироваться.

Элемент управления Button, определенный в качестве кнопки по умолчанию для контейнера. При фокусе, установленном на элементах управления в контейнере, нажатие клавиши Enter эквивалентно нажатию элемента управления Button

Определяет, получает ли объект события doubleClick. Значение по умолчанию — false: по умолчанию экземпляр InteractiveObject не получает событий doubleClick. Если свойству doubleClickEnabled задано значение true, экземпляр получает события doubleClick в своих границах. Свойство mouseEnabled экземпляра InteractiveObject должно иметь значение true, чтобы объект мог получать события doubleClick.

При настройке данного свойства события не отправляются. Чтобы добавить прослушиватель события doubleClick, необходимо использовать метод addEventListener().

Определяет экранный объект, над которым перетаскивается спрайт либо на котором спрайт был отпущен.

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

Задает отображение прямоугольной рамки индикатора фокуса для данного объекта. Может принимать одно из трех значений true, false или null. Значения true и false дают ожидаемые результаты, определяя, будет ли появляться прямоугольник в фокусе. Значение null указывает, что данный объект подчиняется свойству stageFocusRect рабочей области.

Задает объект Graphics, принадлежащий данному спрайту, в котором могут выполняться команды векторного рисования.

Определяет другой спрайт в качестве области щелчка для спрайта. Если свойство hitArea не существует или ему задано значение null или undefined, то в качестве области щелчка используется сам спрайт. Значение свойства hitArea может быть ссылкой на объект Sprite.

Свойство hitArea можно изменить в любой момент; модифицированный спрайт немедленно начинает использовать новое поведение области щелчка. Спрайт, настроенный в качестве области щелчка не обязательно должен быть видимым; его графическая форма, оставаясь невидимой, все равно обнаруживается в качестве области щелчка.

Примечание. Необходимо задать значение false свойству mouseEnabled спрайта, настроенного в качестве области щелчка. В противном случае кнопка спрайта может не работать, так как спрайт, настроенный в качестве области щелчка, получает события пользовательского ввода вместо кнопки спрайта.

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

Определяет, поддерживают ли дочерние объекты события мыши или других устройств пользовательского ввода. Если объект поддерживает эти события, пользователь может взаимодействовать с ним с помощью мыши или другого устройства ввода. Значение по умолчанию — true.

Это свойство удобно использовать, когда кнопка создается с помощью экземпляра класса Sprite (а не класса SimpleButton). Когда для создания кнопки используется экземпляр Sprite, при желании можно украсить кнопку с помощью метода addChild(), добавив дополнительные экземпляры Sprite. Этот процесс может вызывать непредвиденное поведение событий мыши, так как целевым объектом события мыши вместо родительского экземпляра могут стать экземпляры Sprite, добавленные в качестве дочерних. Чтобы родительский экземпляр гарантированно был целевым объектом событий мыши, можно задать его свойству mouseChildren значение false.

При настройке данного свойства события не отправляются. Чтобы создать интерактивные функции, необходимо использовать метод addEventListener().

Определяет, получает ли этот объект события мыши или другого пользовательского ввода. Значение по умолчанию — true, которое указывает, что по умолчанию любой экземпляр InteractiveObject в списке отображения получает события мыши или других устройств пользовательского ввода. Если свойство mouseEnabled имеет значение false, экземпляр не получает событий мыши (или события другого пользовательского ввода, например клавиатуры). Эта настройка не затрагивает дочерние элементы данного экземпляра в списке отображения. Чтобы изменить поведение mouseEnabled для всех дочерних элементов объекта в списке отображения, используйте flash.display.DisplayObjectContainer.mouseChildren.

При настройке данного свойства события не отправляются. Чтобы создать интерактивные функции, необходимо использовать метод addEventListener().

Возвращает число дочерних элементов данного объекта.

Управляет звуком в данном спрайте.

Примечание. Это свойство не затрагивает содержимое HTML объекта HTMLControl (в Adobe AIR).

Определяет, включен ли переход между нижестоящими элементами объекта с помощью клавиши Tab.

Примечание. Это свойство не следует использовать с Flex. Вместо этого следует использовать свойство UIComponent.hasFocusableChildren.

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

Определяет, включен ли переход к этому объекту с помощью клавиши Tab. Если объект включен в последовательность перехода с помощью клавиши Tab, значение — true; в противном случае — false. По умолчанию используется значение false, за исключением следующих случаев.

• Для объекта SimpleButton используется значение true.
• Для объекта TextField с type = "input" используется значение true.
• Для объекта Sprite или MovieClip с buttonMode = true используется значение true.

Задает последовательность перехода между объектами в SWF-файле. Свойство tabIndex по умолчанию имеет значение -1, то есть для объекта не задан индекс при переходе с помощью клавиши Tab.

Если какой-либо отображаемый в данный момент объект в SWF-файле имеет свойство tabIndex, автоматическая последовательность перехода с помощью клавиши Tab отключается, и последовательность перехода вычисляется по свойствам tabIndex объектов SWF-файла. Пользовательская последовательность перехода с помощью клавиши Tab включает только объекты, имеющие свойство tabIndex.

Свойство tabIndex может быть выражено неотрицательным числом. Последовательность перехода определяется в соответствии со свойствами tabIndex объектов в восходящем порядке. Объект со значением 1 свойства tabIndex предшествует объекту со значением 2 свойства tabIndex. Нельзя использовать одинаковое значение tabIndex для нескольких объектов.

Пользовательская последовательность перехода с помощью клавиши Tab, определяемая свойством tabIndex, является линейной. Это значит, что иерархические отношения объектов в SWF-файле не учитываются. Все объекты в SWF-файле со свойствами tabIndex помещаются в последовательность перехода с помощью клавиши Tab, которая определяется последовательностью значений tabIndex.

Примечание. Чтобы установить порядок табуляции для экземпляров TLFTextField, передайте дочерний объект экранного объекта TLFTextField как InteractiveObject, затем задайте свойство tabIndex. Например:

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

Возвращает объект TextSnapshot для данного экземпляра DisplayObjectContainer.

Логическое значение, определяющее, должен ли отображаться курсор в виде руки при наведении указателя мыши на спрайт, в котором свойство buttonMode имеет значение true. Свойство useHandCursor по умолчанию имеет значение true. Когда useHandCursor имеет значение true, курсор в виде руки, используемый для кнопок, появляется при наведении указателя на спрайт-кнопку. Если же useHandCursor имеет значение false, используется указатель «стрелка».

Свойство useHandCursor можно изменить в любое время; модифицированный спрайт немедленно принимает новый вид курсора.

Примечание. Если во Flex или Flash Builder спрайт имеет дочерние спрайты, может потребоваться задание для свойства mouseChildren значения false. Например, если необходимо, чтобы курсор в виде руки отображался над элементом управления Flex <mx:Label>, задайте для свойств useHandCursor и buttonMode значение true, а для свойства mouseChildren значение false.

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

Возвращает объект, имеющий четыре свойства: left, top, right и bottom. Значение каждого свойства равно толщине хрома (визуальные элементы) вокруг границы контейнера.

Хром включает толщину границ. Если свойство horizontalScrollPolicy или verticalScrollPolicy имеют значение ScrollPolicy.ON, хром также включает толщину соответствующей полосы прокрутки. Если стратегия прокрутки имеет значение ScrollPolicy.AUTO, измерение хрома не включает толщину полосы прокрутки даже в случае ее отображения.

Подклассы контейнера должны переопределять этот метод так, чтобы они могли учитывать другой хром при расположении нижестоящих элементов контейнера. Например, свойствоviewMetrics для класса Panel должно возвращать объект, свойство top которого включает толщину строки заголовка контейнера Panel.

Добавляет экземпляр дочернего элемента DisplayObject к экземпляру DisplayObjectContainer. Дочерний элемент добавляется перед (сверху) всеми остальными дочерними элементами в данном экземпляре DisplayObjectContainer. (Чтобы добавить дочерний элемент в конкретную позицию в индексе, используйте метод addChildAt().)

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

Примечание. Команда stage.addChild() может вызвать проблемы с опубликованным SWF-файлом, включая проблемы безопасности и конфликты с другими загруженными SWF-файлами. В экземпляре среды выполнения Flash есть только одна рабочая область независимо от числа загружаемых SWF-файлов. Так, как правило, объекты совсем не следует добавлять в рабочую область напрямую. Рабочая область должна содержать только корневой объект. Создайте объект DisplayObjectContainer, который будет содержать все элементы списка отображения. Затем, при необходимости, добавьте этот экземпляр DisplayObjectContainer в рабочую область.

Параметры

Добавляет экземпляр дочернего элемента DisplayObject к экземпляру DisplayObjectContainer. Дочерний элемент добавляется к указанной позиции индекса. Индекс 0 представляет собой заднюю (нижнюю) часть списка отображения для объекта DisplayObjectContainer.

Так, в следующем примере представлено три объекта отображения с метками а, b и c в позициях индекса 0, 1 и 2 соответственно.

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

Параметры

Показывает, могут ли ограничения безопасности привести к пропуску каких-либо экранных объектов в списке, возвращаемом в результате вызова метода DisplayObjectContainer.getObjectsUnderPoint() с заданной точкой point. По умолчанию содержимое из одного домена не имеет доступ к объектам из другого домена, если это не разрешено посредством вызова метода Security.allowDomain(). Дополнительные сведения о безопасности см. в разделе центра разработчиков Flash Player Безопасность.

Параметр point находится в координатной плоскости рабочей области, которая может отличаться от координатной плоскости контейнера объектов отображения (если это не рабочая область). Можно использовать методы globalToLocal() и localToGlobal() для преобразования точек между этими координатными плоскостями.

Параметры

Определяет, является ли указанный объект отображения дочерним объектом экземпляра DisplayObjectContainer или самим экземпляром. Область поиска охватывает весь список отображения, включая данный экземпляр DisplayObjectContainer. Нижестоящие элементы второго, третьего и последующих уровней возвращают значение true.

Параметры

Возвращает экземпляр дочернего экранного объекта, существующий в заданной позиции индекса.

Параметры

Возвращает экземпляр дочернего экранного объекта с заданным именем. Если заданное имя соответствует нескольким дочерним экранным объектам, метод возвращает первый из списка.

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

Параметры

Возвращает позицию индекса для экземпляра DisplayObject child.

Параметры

Возвращает массив объектов, расположенных ниже указанной позиции и являющихся дочерними объектами любого уровня для данного экземпляра DisplayObjectContainer. Дочерние объекты, недоступные по соображениям безопасности, опускаются из возвращенного массива. Чтобы определить, затрагивается ли возвращенный массив ограничением с целью обеспечения безопасности, вызовите метод areInaccessibleObjectsUnderPoint().

Параметр point находится в координатной плоскости рабочей области, которая может отличаться от координатной плоскости контейнера объектов отображения (если это не рабочая область). Можно использовать методы globalToLocal() и localToGlobal() для преобразования точек между этими координатными плоскостями.

Параметры

Удаляет заданный объект child DisplayObject из списка дочерних элементов экземпляра DisplayObjectContainer. Свойство parent удаленного дочернего элемента получает значение null, а сам объект утилизуется в ходе «сборки мусора», если отсутствуют другие ссылки на дочерний элемент. Позиции индекса экранных объектов, расположенных над дочерним элементом в DisplayObjectContainer уменьшаются на 1.

Сборщик мусора перераспределяет неиспользуемый объем памяти. Когда на переменную или объект больше нет ссылок или он хранится в другом месте, сборщик мусора очищает и утилизирует память, которую он занимал, при условии отсутствия ссылок

Параметры

Удаляет дочерний DisplayObject из заданной позиции index в списке дочерних объектов DisplayObjectContainer. Свойство parent удаленного дочернего элемента получает значение null, а сам объект очищается, если нет других ссылок на дочерние элементы. Позиции индекса экранных объектов, расположенных над дочерним элементом в DisplayObjectContainer уменьшаются на 1.

Сборщик мусора перераспределяет неиспользуемый объем памяти. Когда на переменную или объект больше нет ссылок или он хранится в другом месте, сборщик мусора очищает и утилизирует память, которую он занимал, при условии отсутствия ссылок

Параметры

Изменяет положение существующего дочернего элемента в DisplayObjectContainer. Это отражается на иерархическом представлении дочерних объектов. Так, в следующем примере показано три разных объекта с именами a, b и c в позициях индекса 0, 1 и 2 соответственно.

Когда используется метод setChildIndex() и указывается уже занятая позиция индекса, меняются только позиции между прежней и новой позицией экранного объекта. Все остальные остаются без изменения. Если дочерний объект перемещается на более НИЗКУЮ позицию, позиции всех дочерних объектов между этими позициями станут на 1 ВЫШЕ. Если дочерний объект перемещается на более ВЫСОКУЮ позицию, позиции всех дочерних объектов между этими позициями станут на 1 НИЖЕ. Например, если контейнер экранных объектов из предыдущего примера имеет имя container, можно поменять позициями экранные объекты с именами a и b, вызвав следующий код:

container.setChildIndex(container.getChildAt(1), 0);

В результате этого объекты выстраиваются следующим образом:

Параметры

Позволяет пользователю перетаскивать заданный спрайт (растровый графический объект, легко перемещаемый по экрану). Спрайт можно перетаскивать до явной остановки через вызов метода Sprite.stopDrag() или до того, как можно будет перетаскивать другой спрайт. Одновременно можно перетаскивать только один спрайт.

Трехмерные объекты отображения управляются указателем, а метод Sprite.startDrag() позволяет перемещать объект в трехмерной плоскости, определенной экранным объектом. Или, если экранный объект является двумерным объектом и дочерним элементом трехмерного объекта, двумерный объект перемещается в трехмерной плоскости, определенной трехмерным родительским объектом.

Параметры

Завершает метод startDrag(). Спрайт, созданный перетаскиваемым с помощью метода startDrag(), остается таковым до добавления метода stopDrag() или до того, как другой спрайт станет перетаскиваемым. Одновременно можно перетаскивать только один спрайт.

Меняет местами (в порядке «от начала к концу») два заданных дочерних объекта. Все остальные дочерние объекты в контейнере экранных объектов остаются на прежних позициях.

Параметры

Меняет местами (в порядке «от начала к концу») дочерние объекты, расположенные в двух заданных позициях индекса в списке дочерних объектов. Все остальные дочерние объекты в контейнере экранных объектов остаются на прежних позициях.

Параметры