adobe.utilsXMLUI Класс XMLUI обеспечивает связь с SWF-файлами, которые используются как пользовательские интерфейсы для функций, расширяющих возможности инструмента разработки Flash.XMLUI Object Класс XMLUI обеспечивает связь с SWF-файлами, которые используются как пользовательские интерфейсы для функций, расширяющих возможности инструмента разработки Flash.

Macromedia Flash MX 2004, Macromedia Flash MX Professional 2004 и более поздние версии имеют ряд функций расширения, включая поведения, команды (JavaScript API), эффекты и инструменты. С помощью этих функций опытные пользователи могут расширять или автоматизировать возможности данного инструмента разработки. Модуль преобразования XML в интерфейс взаимодействует с каждой из этих функций расширения, создавая диалоговые окна, которые пользователь видит, если расширение требует или поддерживает параметры. Диалоговые окна можно определить с помощью тегов XML, либо путем создания отображаемого SWF-файла. Объект XMLUI обеспечивает механизм, с помощью которого опытный пользователь может связываться с SWF-файлом, который находит данное применение.

accept Закрывает текущее диалоговое окно XMLUI с состоянием «принято».XMLUI, XMLUI.accept(), accept() Закрывает текущее диалоговое окно XMLUI с состоянием «принято». Результат идентичен ситуации, возникающей при нажатии пользователем клавиши «ОК». cancel Закрывает текущее диалоговое окно XMLUI с состоянием «отмена».XMLUI, XMLUI.cancel(), cancel() Закрывает текущее диалоговое окно XMLUI с состоянием «отмена». Результат идентичен ситуации, возникающей при нажатии пользователем клавиши Cancel. getProperty Получает значение заданного свойства текущего диалогового окна XMLUI.XMLUI, XMLUI.getProperty(), getProperty() Значение свойства. StringnameStringИмя получаемого свойства XMLUI. Получает значение заданного свойства текущего диалогового окна XMLUI. setProperty Изменяет значение указанного свойства текущего диалогового окна XMLUI.XMLUI, XMLUI.setProperty(), setProperty() nameStringИмя модифицируемого свойства XMLUI. valueStringЗначение, присваиваемое указанному свойству. Изменяет значение указанного свойства текущего диалогового окна XMLUI. CustomActions Методы класса CustomActions позволяет SWF-файлу, воспроизводимому в средстве разработки Flash, управлять любыми пользовательскими действиями, зарегистрированными в средстве разработки.CustomActions object, CustomActions, built-in class Object Методы класса CustomActions позволяет SWF-файлу, воспроизводимому в средстве разработки Flash, управлять любыми пользовательскими действиями, зарегистрированными в средстве разработки. SWF-файл может устанавливать и удалять пользовательские действия, получать определение пользовательского действия в формате XML и список зарегистрированных пользовательских действий.

Эти методы можно применять для создания SWF-файлов, которые являются расширениями инструмента разработки Flash. В подобном расширении для перехода к хранилищу универсального описания, поиска и взаимодействия (UDDI) и загрузки веб-служб в набор инструментов «Действия» может использоваться Flash Application Protocol.

getActions Считывает содержимое XML-файла определения пользовательских действий с именем name.CustomActions.getActions, CustomActions, getActions Если определение пользовательского действия в формате XML найдено, возвращается строка; в противном случае возвращается значение undefined. StringnameStringИмя получаемого определения пользовательского действия. Считывает содержимое файла определения в формате XML с именем name.

Имя файла описания должно быть простым именем файла без расширения файла .xml и без разделителей между каталогами («:», «/» или «\»).

Если файл определения, указанный с помощью параметра name не удается найти, возвращается значение undefined. Если определение пользовательского действия в формате XML, заданное параметром name найдено, оно целиком считывается и возвращается в виде строки.

installActions Устанавливает новый XML-файл определения пользовательских действий, заданный параметром name. Если во время установки возникает ошибка, возвращается логическое значение false; в противном случае возвращается значение true, указывающее на успешную установку пользовательского действия. nameStringИмя устанавливаемого определения пользовательского действия. dataStringТекст устанавливаемого определения XML. Устанавливает новый XML-файл с определением пользовательского действия, который определяется параметром name. Содержимое файла указывается строкой data.

Если файл пользовательских действий уже существует под именем name, он перезаписывается.

Если каталог Configuration/ActionsPanel/CustomActions не существует во время вызова этого метода, он создается.

uninstallActions Удаляет XML-файл определения пользовательских действий с именем name.CustomActions.uninstallActions, CustomActions, uninstallActions nameStringИмя удаляемого определения пользовательского действия. Удаляет XML-файл с определением пользовательских действий под именем name.

actionsList Возвращает объект Array с именами всех пользовательских действий, зарегистрированных в инструменте разработки Flash.CustomActions.listActions, CustomActions, listActions Array Возвращает объект Array с именами всех пользовательских действий, зарегистрированных в инструменте разработки Flash. Элементам массива присваиваются простые имена без расширения файла .xml и без разделителей между каталогами (например, «:», «/» или «\»). Если зарегистрированные пользовательские действия отсутствуют, actionsList() возвращает массив нулевой длины. При возникновении ошибки actionsList() возвращает значение undefined. MMEndCommand Оповещает приложение, размещающее команду SWF, о том, что команда выполнена, и предписывает приложению принять или отклонить изменения, переданные командой MMExecute().endStatusBoolean Логическое значение; значение true используется для применения изменений, в противном случае присваивается значение false. Если выбрано значение false, любые предложенные изменения игнорируются. notifyStringString Строка, содержащая сообщение об ошибке или причину отмены изменений. Если параметру endStatus присвоено значение true, в качестве значения параметра notifyString используется пустая строка. Оповещает приложение, размещающее команду SWF, о том, что команда выполнена, и предписывает приложению принять или отклонить изменения, переданные командой MMExecute(). MMExecute Позволяет вызывать команды Flash JavaScript API (JSAPI) с помощью ActionScript.Строковое представление возможного результата, отправленное инструкцией JavaScript. StringnameString Строка, переданная функции MMExecute(). Функция MMExecute() используется для разбора строки и выполнения команд JavaScript. Строке можно присвоить переменную, а затем передать эту переменную методу MMExecute(). Кроме того, можно разделить функцию JavaScript на строки меньшей длины; функция MMExecute() возвращает при этом значение последней вызванной функции. Позволяет вызывать команды Flash JavaScript API (JSAPI) с помощью ActionScript. Во Flash Professional функция MMExecute() может вызываться только роликом, который используется в качестве панели Flash, диалоговым окном XMLtoUI или пользовательским интерфейсом компонента. Команды JSAPI не действуют за рамками среды разработки.

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

Как правило, пользователь выполняет сценарий JSAPI, выбрав в меню «Команды» > «Выполнить команду». Однако, эту функцию можно использовать в сценарии ActionScript для вызова команды JSAPI напрямую. Если функция MMExecute() используется в сценарии по отношению к 1 кадру вашего файла, эта команда выполняется при вызове SWF-файла.

Дополнительную информацию о JSAPI см. в руководстве пользователя «Extending Flash» на странице http://www.adobe.com/go/jsapi_info_ru.