_X
Синтаксис
instancename._x
instancename._x = integer
Аргументы
integer Локальная x-координата клипа.
instancename Имя экземпляра клипа.
Описание
Свойство; устанавливает x-координату клипа относительно локальных координат родительского клипа. Если клип расположен на главной монтажной линейке, то начало его системы координат (0, 0), находится в верхнем левом углу рабочего окна. Если клип вложен внутрь другого трансформированного клипа, он находится в локальной системе координат родительского клипа. Таким образом, после поворота родительского клипа на 90° против часовой стрелки, его дочерние клипы унаследуют систему координат, повернутую на 90° против часовой стрелки. Координаты клипа относятся к его точке отсчета (registration point).
Player
Flash 3 или выше.
Смотрите также
_y
_xscale
XML.appendChild
Синтаксис
myXML.appendChild(childNode);
Аргументы
childNode Дочерний узел, добавляемый в список дочерних объектов указанного XML объекта.
Описание
Метод; добавляет указанный дочерний узел в список объекта XML. Добавляемый дочерний узел будет размещен в древовидной структуре и удален из существующего родительского узла, если такой существует.
Player
Flash 5 или выше.
Пример
Следующий пример клонирует последний узел из doc1 и добавляет его в doc2:
doc1 = new XML(src1); doc2 = new XML(); node = doc1.lastChild.cloneNode(true); doc2.appendChild(node);
XML.attributes
Синтаксис
myXML.attributes;
Аргументы
Нет.
Описание
Совокупность (чтение - запись); возвращает ассоциативный массив, содержащий все атрибуты указанного XML объекта.
Player
Flash 5 или выше.
Пример
Следующий пример записывает, имена XML атрибутов в Окно вывода:
str = "<mytag name=\"Val\"> intem </mytage>"; doc = new XML(str); y = doc.fristChild.attributes.name; trace (y); doc.firstChild.attributes.order = "first"; z = doc.firstChild.attributes.order trace(z);
В окне Output будет показан следующий результат:
Val First
XML.childNodes
Синтаксис
myXML.childNodes;
Аргументы
Нет.
Описание
Совокупность (только для чтения); возвращает массив указанных дочерних записей объекта XML. Каждый элемент в массиве есть ссылка на объект XML, который представляет дочернюю вершину. Это свойство только для чтения и не может использоваться для управления дочерними вершинами. Чтобы управлять ими, используйте методы appendChild, insertBefore и removeNode.
Эта совокупность неопределена для текстовых узлов (nodeType == 3).
Player
Flash 5 или выше.
XML.cloneNode
Синтаксис
myXML.cloneNode(deep);
Аргументы
deep Булево значение, определяющее, клонируются ли дочерние записи указанного объекта XML рекурсивно.
Описание
Метод; создает и возвращает новый узел XML того же самого типа, имени, значения и атрибутов, как указанный объект XML. Если deep установлен в true, все дочерние вершины рекурсивно клонируются, создавая точную копию дерева документов первоначального объекта
Player
Flash 5 или выше.
XML.createElement
Синтаксис
myXML.createElement(name);
Аргументы
name Тег (tag) имени создаваемого элемента XML.
Описание
Метод; создает новый XML элемент с именем, указанным в параметре. Новый элемент первоначально не имеет никакого родителя и никаких дочерних записей. Метод возвращает ссылку на недавно созданный объект XML, представляющий элемент. Этот метод и createTextNode - методы конструктора для создания узлов для объекта XML.
Player
Flash 5 или выше.
XML.createTextNode
Синтаксис
myXML.createTextNode(text);
Аргументы
text Текст, используемый для создания нового текстового узла.
Описание
Метод; создает новый текстовый узел XML с указанным текстом. Новый узел первоначально не имеет никакого родителя и текстовые узлы не могут иметь дочерние записи. Этот метод возвращает ссылку на объект XML, представляющий новый текстовый узел. Этот метод и createElement - методы конструктора для создания узлов для объекта XML.
Player
Flash 5 или выше.
XML.docTypeDecl
Синтаксис
myXML.XMLdocTypeDecl;
Аргументы
Нет.
Описание
Свойство; устанавливает и возвращает информацию об объявлении DOCTYPE документа XML. После анализа текста XML в объекте XML, свойство XML.docTypeDecl объекта XML устанавливается в текст объявления DOCTYPE документа XML. Например,
<!DOCTYPE greeting SYSTEM hello.dtd">.
Это свойство установлено используя текстовое представление объявления DOCTYPE, не является узлом объекта XML.
Синтаксический анализатор ActionScript XML не является анализатором достоверности. Объявление DOCTYPE читается синтаксическим анализатором и сохраняется в свойсте docTypeDecl, но никакая проверка правильности DTD не выполняется.
Если в течение операции синтаксического анализа не попалось никакого объявления DOCTYPE, XML.docTypeDecl устанавливается в неопределенный. XML.toString выводит содержимое XML.docTypeDecl немедленно после XML объявления, сохраненного в XML.xmlDecl и перед любым другим текстом в объекте XML. Если XML.docTypeDecl неопределен, никакое DOCTYPE объявление не выводится.
Player
Flash 5 или выше.
Пример
Следующий пример использует XML.docTypeDecl, чтобы установить DOCTYPE объявление для объекта XML.
myXML.docTypeDecl = "<!DOCTYPE greeting SYSTEM \"hello.dtd\">";
Смотрите также
XML.toString
XML.xmlDecl
XML.firstChild
Синтаксис
myXML.firstChild;
Аргументы
Нет.
Описание
Свойство (только чтение); определяет заданный XML объект и указывает на первый объект в списке подчиненных объектов родительского узла. Это свойство принимает значение null, если родительский узел не имеет подчиненных объектов. Это свойство неопределенно, если узел является текстовым узлом. Это свойство только для чтения, поэтому оно не может применяться для управления подчиненными объектами, используйте для этих целей методы appendChild, insertBefore и removeNode.
Player
Flash 5 или выше.
Смотрите также
XML.appendChild
XML.insertBefore
XML.removeNode
XML.haschildNodes
Синтаксис
myXML.hasChildNodes();
Аргументы
Нет.
Описание
Метод; определяет указанный объект XML и возвращает true, если существуют подчиненные объекты, иначе возвращает false.
Player
Flash 5 или выше.
Пример
Следующий пример использует информацию из объекта XML в определенной пользователем функции:
if (rootNode.hasChildNodes()) { myfunc (rootNode.firstChild); }
XML.insertBefore
Синтаксис
myXML.insertBefore(childNode, beforeNode);
Аргументы
childNode Вставляемый узел.
beforeNode Узел, перед которым будет вставлен childNode.
Описание
Метод; вставляет новый подчиненный узел в список подчиненных узлов объекта XML, перед beforeNode.
Player
Flash 5 или выше.
XML.lastChild
Синтаксис
myXML.lastChild;
Аргументы
Нет.
Описание
Свойство (только чтение); определяет заданный XML объект и указывает на последний объект в списке подчиненных объектов родительского узла. Это свойство принимает значение null, если родительский узел не имеет подчиненных объектов. Это свойство только для чтения, поэтому оно не может применяться для управления подчиненными объектами, используйте для этих целей методы appendChild, insertBefore и removeNode.
Player
Flash 5 или выше.
Смотрите также
XML.appendChild
XML.insertBefore
XML.removeNode
XML.load
Синтаксис
myXML.load(url);
Аргументы
url URL (ссылка) XML документа, который нужно загрузить. URL должен быть в том же поддомене, в котором находится текущий клип.
Описание
Метод; загружает XML документ с определенного адреса и замещает содержимое указанного объекта XML новыми загруженными данными XML. Процесс загрузки является асинхронным, он не заканчивается сразу после выполнения метода load. Когда метод load выполнен, свойство loaded объекта XML устанавливается в false. По окончании загрузки данных XML, свойство loaded устанавливается в true и выполняется метод onLoad. Данные XML не анализируются, пока они полностью не загружены. Если объект XML содержал любую древовидную структуру XML, она будет удалена.
Можно определить вашу собственную функцию повторного вызова на месте метода onLoad.
Player
Flash 5 или выше.
Пример
Ниже приведен простой пример, использующий XML.load:
doc = new XML();
doc.load ("theFile.xml");
Смотрите также
XML.onLoad
XML.loaded
XML.loaded
Синтаксис
myXML.loaded;
Аргументы
Нет.
Описание
Свойство (только чтение); определяет, завершен ли процесс загрузки документа, инициализированный запросом XML.load. Если процесс загрузки завершен полностью, метод возвращает true, в противном случае - false.
Player
Flash 5 или выше.
Пример
Следующий пример использует XML.loaded в простой команде.
if (doc.loaded) { gotoAndPlay(4) }
XML.nextSibling
Синтаксис
myXML.nextSibling;
Аргументы
Нет.
Описание
Свойство (только для чтения); оценивает объект XML и ссылки следующего брата в дочернем списке родительского узла. Этот метод возвращает null, если узел не имеет следующего братского узла. Это свойство только для чтения и не может использоваться для управления дочерними вершинами. Используйте методы appendChild, insertBefore и removeNode для управления дочерними узлами.
Player
Flash 5 или выше.
Смотрите также
XML.appendChild
XML.insertBefore
XML.removeNode
XML.nodeName
Синтаксис
myXML.nodeName;
Аргументы
Нет.
Описание
Свойство; получает или возвращает имя узла объекта XML. Если объект XML есть XML элемент (nodeType == 1), nodeName это имя тега, представляющего узел в файле XML. Например, TITLE является nodeName HTML-тега TITLE. Если объект XML является текстовым узлом (nodeType == 3), nodeName принимает значение null.
Player
Flash 5 или выше.
Смотрите также
XML.nodeType
XML.nodeType
Синтаксис
myXML.nodeType;
Аргументы
Нет.
Описание
Свойство (только чтение); получает или возвращает значение nodeType, где 1 - элемент XML и 3 - текстовый узел.
Player
Flash 5 или выше.
Смотрите также
XML.nodeValue
XML.nodeValue
Синтаксис
myXML.nodeValue;
Аргументы
Нет.
Описание
Свойство; возвращает значение узла объекта XML. Если объект XML является текстовым узлом, nodeType имеет значение 3, а nodeValue принимает значение текста узла. Если объект XML является элементом XML, он имеет null nodeValue и свойство используется только для чтения.
Player
Flash 5 или выше.
Смотрите также
XML.nodeType
XML (object)
Используйте методы и свойства объекта XML, чтобы загружать, анализировать, посылать, формировать и управлять XML деревьями документов.
Вы должны использовать конструктор new XML(), чтобы создать экземпляр объекта XML перед вызовом любого из методов объекта XML.
XML поддерживается Flash Player версии Flash 5 или выше.
Список методов для объекта XML Метод Описание
appendChild
Список свойств объекта XML Описание
Свойство
docTypeDecl
attributes
Синтаксис
new XML(); new XML(source);
Аргументы
source Анализируемый документ XML для создания нового объекта XML.
Описание
Конструктор; создает новый объект XML. Вы должны использовать конструктор для создания экземпляра объекта XML перед вызовом его любых методов.
Первый синтаксис создает новый, пустой объект XML. | |
Второй синтаксис создает новый объект XML, анализируя XML документ, указанный в source параметре и заполняет созданный объект XML деревом XML документа. | |
![]() |
Player
Flash 5 или выше.
Пример
Следующий пример создает новый пустой объект XML:
myXML = new XML();
Смотрите также
XML.createTextNode
XML.createElement
XML.onLoad
Синтаксис
myXML.onLoad(success);
Аргументы
success Булево значение, указывающее, был ли объект XML успешно загружен операцией XML.load или XML.sendAndLoad.
Описание
Метод; вызывается Flash Player'ом, когда XML документ загружен с сервера. Если документ XML загружен успешно, аргумент success принимает значение true. Если документ не загружен или произошла ошибка подключения к серверу, аргумент success принимает значение false. Заданная по умолчанию реализация этого метода не активна. Чтобы отменить действие по умолчанию, Вы должны назначить функцию, содержащую ваши собственные команды.
Player
Flash 5 или выше.
Пример
Следующий пример создает простой клип для простого приложения веб-магазина. Мы используем метод sendAndLoad для передачи XML элемента, содержащего имя пользователя и пароль, и устанавливаем обработчик onLoad, чтобы проверить ответ от сервера.
var myLoginReply = new XML(); myLoginReply.onLoad = myOnLoad; myXML.sendAndLoad("http://www.samplestore.com/login.cgi", myLoginReply); function myOnLoad(success) { if (success) { if (e.firstChild.nodeName == "LOGINREPLY" && e.firstChild.attributes.status == "OK") { gotoAndPlay("loggedIn") } else { gotoAndStop("loginFailed") } } else { gotoAndStop("connectionFailed") } }
Смотрите также
function
XML.load
XML.sendAndLoad
XML.parentNode
Синтаксис
myXML.parentNode;
Аргументы
Нет.
Описание
Свойство (только чтение); ссылается на родительский узел указанного объекта XML или возвращает null, если у узла нет родителя. Это свойство только для чтения и оно не может быть использовано для управления подчиненными узлами, для этих целей используйте методы appendChild, insertBefore и removeNode.
Player
Flash 5 или выше.
XML.parseXML
Синтаксис
myXML.parseXML(source);
Аргументы
source XML текст, который нужно проанализировать и передать определенному XML объекту.
Описание
Метод; анализирует текст XML, указанный в аргументе source и вставляет указанный объект XML в XML дерево. Любые существующие деревья в объекте XML будут отвергнуты.
Player
Flash 5 или выше
XML.previousSibling
Синтаксис
myXML.previousSibling;
Описание
Свойство (только для чтения); оценивает объект XML и ссылки на предыдущего брата в дочернем списке родительского узла. Возвращает null, если узел не имеет предыдущего братского узла. Это свойство только для чтения и не может быть использовано, чтобы управлять дочерними узлами, используйте методы appendChild, insertBefore и removeNode для управления дочерними узлами.
Player
Flash 5 или выше.
XML.removeNode
Синтаксис
myXML.removeNode();
Аргументы
Нет.
Описание
Метод; удаляет указанный объект XML из его родителя.
Player
Flash 5 или выше.
XML.send
Синтаксис
myXML.send(url);
myXML.send(url, window);
Аргументы
url Адрес URL для указанного объекта XML.
window Окно броузера для отображения данных, возвращенных сервером: _self указывает на текущий фрейм текущего окна, _blank указывает новое окно, _parent указывает на родителя текущего фрейма и _top указывает на фрейм верхнего уровня текущего окна. | |
![]() |
Описание
Метод; кодирует указанный объект XML в документ XML и посылает его на указанный адрес URL, используя метод POST.
Player
Flash 5 или выше.
XML.sendAndLoad
Синтаксис
myXML.sendAndLoad(url,targetXMLobject);
Аргументы
url Адресат URL для указанного объекта XML. URL должен быть в том же поддомене, что и URL, откуда был загружен клип.
targetXMLobject Объект XML, созданный конструктивным методом XML, который будет принимать и отправлять информацию на(с) сервер(а).
Описание
Метод; Кодирует указанный объект XML в документ XML, посылает его на указанный URL, используя метод POST, загружает ответ сервера и тогда передает его в targetXMLobject, указанный в аргументе. Ответ сервера загружается тем же самым способом, который используется в методе load.
Player
Flash 5 или выше.
Смотрите также
XML.load
XML.status
Синтаксис
myXML.status;
Аргументы
Нет.
Описание
Свойство; автоматически устанавливает и возвращает числовое значение, указывающее, успешно ли был проведен синтаксический анализ документа XML в объекте XML. Ниже приведен список числовых кодов состояния и описание каждого:
![]() |
0 Нет ошибок; Синтаксический анализ закончен успешно |
![]() |
-2 Раздел CDATA не был закончен должным образом. |
![]() |
-3 Объявление XML не было закончено должным образом. |
![]() |
-4 Объявление DOCTYPE не было закончено должным образом. |
![]() |
-5 Комментарий не был закончен должным образом. |
![]() |
-6 XML элемент неверен. |
![]() |
-7 Не хватает памяти. |
![]() |
-8 Значение атрибута не было закончено должным образом. |
![]() |
-9 Тег начала не был согласован с конечным тегом. |
![]() |
-10 Конечный тег указан без соответствующего начального тега. |
Player
Flash 5 или выше.
XML.toString
Синтаксис
myXML.toString();
Аргументы
Нет.
Описание
Метод; оценивает указанный объект XML, строит тестовое представление структуры XML включая узел, дочерние записи и атрибуты, и возвращает результат как строку.
Для объектов XML верхнего уровня (созданных конструктором), XML.toString выводит объявление документа XML (сохраненное в XML.xmlDecl), объявление DOCTYPE (сохраненное в XML.docTypeDecl) и текстовое представление всех XML узлов в объекте. XML объявление не выводится, если XML.xmlDecl неопределен. DOCTYPE объявление не выводится, если XML.docTypeDecl неопределен.
Player
Flash 5 или выше.
Пример
Следующий код является примером использования метода XML.toString:
node = new XML("<h1>test</h1>");
trace(node.toString());
sends
<H1>test</H1>
to the output window
Смотрите также
XML.xmlDecl
XML.docTypeDecl
XML.xmlDecl
Синтаксис
myXML.xmlDecl;
Аргументы
Нет.
Описание
Свойство; устанавливает и возвращает информацию относительно XML объявления. После того, как документ XML проанализирован в объекте XML, это свойство устанавливается, используя объявление документа XML. Это свойство устанавливается в строковое представление объявления XML, а не в объект узла XML. Если во время операции синтаксического анализа не было никаких объявлений XML, свойство неопределено. XML.toString выводит содержимое XML.xmlDecl перед любым другим текстом в объекте XML. Если XML.xmlDecl содержит тип undefined (неопределенный), никакое объявление XML не выводится.
Player
Flash 5 или выше.
Пример
Следующий пример использует XML.xmlDecl для того, чтобы установить объявление документа XML для XML объекта:
myXML.xmlDecl = "<?xml version=\"1.0\" ?>";
Смотрите также
XML.toString
XML.docTypeDecl
XMLSocket.close
Синтаксис
myXMLSocket.close();
Аргументы
Нет.
Описание
Метод; закрывает связь, указанную объектом XMLSocket.
Player
Flash 5 или выше.
Смотрите также
XMLSocket.connect
XMLSocket.connect
Синтаксис
myXMLSocket.connect(host, port);
Аргументы
host Полностью квалифицированное имя домена DNS или адрес IP в виде aaa.bbb.ccc.ddd. Вы также можете указать null, чтобы связаться с сервером, на котором размещен клип.
port Номер TCP порта главного компьютера для установления связи. Номер порта должен быть равен 1024 или выше.
Описание
Метод; устанавливает подключение к указанному хосту Internet, используя указанный порт TCP (должен быть 1024 или выше) и возвращает true или false, в зависимости от того, установилось ли соединение. Если Вы не знаете номер порта Вашего Internet хоста, свяжитесь с Вашим сетевым администратором. Если используется Flash Netscape плагин или ActiveX компонент, хост указанный в аргументе должен иметь тот же поддомен, что и хост, с которого загружен клип.
Если Вы укажете null для аргумента host, произойдет связь с хостом, в котором находиться клип, вызвавший XMLSocket.connect. Например, если клип загружен с http://www.yoursite.com, указать null аргументу host тоже самое, что и ввести IP адрес www.yoursite.com.
Если XMLSocket.connect возвращает значение true, значит начальная стадия процесса подключения прошла успешно, потом метод XMLSocket.onConnect вызывается для того, чтобы определить, успешно ли прошло соединение. Если XMLSocket.connect возвращает false, значит соединение не удалось.
Player
Flash 5 или выше.
Пример
Следующий пример использует XMLSocket.connect для соединения с хостом, на котором он размещен и trace для вывода значения, показывающего успешно ли прошло соединение:
function myOnConnect(success) { if (success) { trace ("Connection succeeded!") } else { trace ("Connection failed!") } } socket = new XMLSocket() socket.onConnect = myOnConnect if (!socket.connect(null, 2000)) { trace ("Connection failed!") }
Смотрите также
function
XMLSocket.onConnect
XMLSocket (object)
Объект XMLSocket осуществляет связь компьютера, на котором запущен Flash Player, с сервером, идентифицируя его по IP адресу или по доменному имени.
Использование объекта XMLSocket
Чтобы использовать объект XMLSocket, компьютер-сервер должен запустить "daemon", который понимает протокол объекта XMLSocket. Протоколы следующие:
![]() |
XML сообщение передается через полное дуплексное потоковое TCP/IP соединение. |
![]() |
Каждое сообщение XML является законченным документом XML, заканчивающееся нулевым байтом. |
![]() |
Неограниченное количество сообщений XML может быть передано и принято за одно соединение XMLSocket. |
Объект XMLSocket полезен для клиент-серверных приложений, которые требуют малого времени ожидания, типа чат-систем реального времени. Традиционные чат-системы, основанные на HTTP, часто опрашивают сервер и загружают с него новые сообщения, используя HTTP запрос. Напротив, чат-системы основанные на XMLSocket, поддерживают открытое подключение к серверу, которое позволяет серверу немедленно посылать входящие сообщения без запроса от клиента.
Установка сервера на постоянную связь с объектом XMLSocket может быть нежелательна. Если Ваше приложение не требует интерактивности в реальном времени, используйте loadVariables или XML связь с сервером, основанную на HTTP (XML.load, XML.sendAndLoad, XML.send), вместо объекта XMLSocket.
Для использования методов объекта XMLSocket, сначала необходимо использовать конструктор new XMLSocket, чтобы создать новый объект XMLSocket.
XMLSocket и безопасность
Поскольку объект XMLSocket устанавливает и поддерживает открытое подключение к серверу, из соображений безопасности в объект XMLSocket были помещены следующие ограничения:
![]() |
Метод XMLSocket.connect может соединиться только с TCP портами, номера которых больше или равны 1024. Одно последствие этого ограничения - то, что серверный "daemons", который связывается с объектом XMLSocket, должен также быть назначен на порт больше или равный 1024. Порты номерами ниже 1024 часто используются системными сервисами, такими как FTP, Telnet и HTTP, поэтому объект XMLSocket не допускается к этим портам. Ограничение номеров портов ограничивает возможность того, что к этим ресурсам будут неуместно обращаться и неправильно эксплуатировать. |
![]() |
Метод XMLSocket.connect может соединиться только с компьютером в том-же поддомене, где расположен файл SWF (клип). Это ограничение не применяется к клипам, выполняемым на локальном диске. (Это ограничение идентично правилам безопасности для loadVariables, XML.sendAndLoad и XML.load.) |
Список методов для объекта XMLSocket
close
Синтаксис
new XMLSocket();
Аргументы
Нет.
Описание
Конструктор; создает новый объект XMLSocket. Объект XMLSocket первоначально не связан ни с каким сервером. Вы должны вызвать метод XMLSocket.connect, чтобы связать объект с сервером.
Player
Flash 5 или выше.
Пример
myXMLSocket = new XMLSocket();
Смотрите также
XMLSocket.connect
XMLSocket.onClose
Синтаксис
myXMLSocket.onClose();
Аргументы
Нет.
Описание
Метод; возвращающая функция, которая вызывается только в том случае, если связь закрыта сервером. Заданная по умолчанию реализация этого метода не выполняет никаких действий. Чтобы отменить заданное по умолчанию выполнение, Вы должны назначить функцию, содержащую ваши собственные действия.
Player
Flash 5 или выше.
Смотрите также
function
XMLSocket.onConnect
XMLSocket.onConnect
Синтаксис
myXMLSocket.onConnect(success);
Аргументы
success Булево значение, указывающее, было ли подключение установлено успешно (true или false).
Описание
Метод; возвращающая функция, вызываемая Flash Player, когда запрос подключения, инициализированный через метод XMLSocket.connect удался или потерпел неудачу. Если связь удалась, аргумент success принимает значение true, иначе аргумент success принимает значение false.
Заданная по умолчанию реализация этого метода не выполняет никаких действий. Чтобы отменить заданное по умолчанию выполнение, Вы должны назначить функцию, содержащую ваши собственные действия.
Player
Flash 5 или выше.
Пример
Следующий пример иллюстрирует процесс определения функции замены для метода onConnect в простом чат-приложении.
Функция контролирует, какой экран показать пользователю в зависимости от того, успешно ли прошло подключение. Если соединение состоялось, пользователь получает основной экран чата в кадре с меткой startChat. Если соединение не состоялось, пользователь переходит на экран с информацией о проблеме связи в кадре с меткой connectionFailed.
function myOnConnect(success) {
if (success) {
gotoAndPlay("startChat")
} else {
gotoAndStop("connectionFailed")
}
}
После создания объекта XMLSocket с помощью конструктивного метода, скрипт инициализирует метод onConnect с помощью оператора присвоения:
socket = new XMLSocket()
socket.onConnect = myOnConnect
Наконец, подключение инициализировано. Если connect возвращает false, клип направляется прямо на кадр c меткой connectionFailed и onConnect не вызывается. Если connect возвращает true, клип переходит на кадр с меткой waitForConnection, в котором размещен экран "Пожалуйста подождите". Клип остается на кадре waitForConnection, пока не сработает обработчик onConnect, что может произойти через некоторое время, в зависимости от скорости сети.
if (!socket.connect(null, 2000)) { gotoAndStop("connectionFailed") } else { gotoAndStop("waitForConnection") }
Смотрите также
XMLSocket.connect
function
XMLSocket.onXML
Синтаксис
myXMLSocket.onXML(object);
Аргументы
object Экземпляр XML объекта, содержащий анализируемый документ XML, принятый с сервера.
Описание
Метод; возвращающая функция, которая вызывается Flash Player, когда указанный объект XML, содержащий XML документ прибывает через открытую XMLSocket связь. Связь XMLSocket может быть использована для передачи неограниченного числа документов XML между клиентом и сервером. Каждый документ заканчивается нулевым байтом. Когда Flash Player принимает нулевой байт, он анализирует все принятые XML с последнего нулевого байта или с тех пор, как состоялось соединение, если принято первое сообщение. Каждый пакет анализируемого XML обрабатывается, как одиночный документ XML и передается методу onXML.
Заданная по умолчанию реализация этого метода не выполняет никаких действий. Чтобы отменить заданное по умолчанию выполнение, Вы должны назначить функцию, содержащую действия, которые Вы определяете.
Player
Flash 5 или выше.
Пример
Следующая функция отменяет заданное по умолчанию выполнение метода onXML в простом чат-приложении. Функция myOnXML указывает чат-приложению распознавать одиночный элемент XML, MESSAGE, в следующем формате:
<MESSAGE USER="John" TEXT="Hello, my name is John!" />.
Обработчик onXML должен сначала быть установлен в объекте XMLSocket следующим образом:
socket.onXML = myOnXML;
Функция displayMessage применена, чтобы быть определяемой пользователем функцией, которая отображает сообщение, полученное пользователем.
function myOnXML(doc) { var e = doc.firstChild; if (e != null && e.nodeName == "MESSAGE") { displayMessage(e.attributes.user, e.attributes.text); } }
Смотрите также
function
XMLSocket.send
Синтаксис
myXMLSocket.send(object);
Аргументы
object Объект XML или другие данные, которые нужно передать на сервер.
Описание
Метод; Преобразует объект XML или данные, указанные в аргументе object в строку и передает это на сервер, сопровождая нулевым байтом. Если object объект XML, строка является текстовым представлением объекта XML. Посылающая операция асинхронная, она возвращается немедленно, но данные могут быть переданы в более позднее время. Метод XMLSocket.send не возвращает значение, указывающее, были ли данные успешно переданы.
Если myXMLSocket не связан с сервером (используя XMLSocket.connect), операция XMLSocket.send не выполнится.
Player
Flash 5 или выше.
Пример
Следующий пример иллюстрирует, как Вы могли определить имя пользователя и пароль, чтобы послать XML объект myXML серверу:
var myXML = new XML();
var myLogin = myXML.createElement("login");
myLogin.attributes.username = usernameTextField;
myLogin.attributes.password = passwordTextField;
myXML.appendChild(myLogin);
myXMLSocket.send(myXML);
Смотрите также
XMLSocket.connect
_Xmouse
Синтаксис
instancename._xmouse
Аргументы
instancename Имя экземпляра клипа.
Описание
Свойство (только чтение); возвращает координату x указателя мыши.
Player
Flash 5 или выше.
Смотрите также
Mouse (object)
_ymouse
_Xscale
Синтаксис
instancename._xscale
instancename._xscale = percentage;
Аргументы
percentage Процентное значение, определяющее процент для горизонтального масштабирования клипа. Значение по умолчанию - 100.
instancename Имя экземпляра клипа.
Описание
Свойство; определяет горизонтальный масштаб (percentage) клипа, принятый от точки отсчета клипа. По умолчанию точка отсчета есть (0,0).
Масштабирование локальной системы координат воздействует на установки свойств _x и _y, которые определены в пикселах. Например, если родительский клип масштабируется на 50%, установка свойства клипа _x передвинет объект в клипе на половину числа пикселов, как если бы клип был 100%.
Player
Flash 4 или выше.
Смотрите также
_xscale
_Y
Синтаксис
instancename._y
instancename._y = integer;
Аргументы
integer Локальная y-координата клипа.
instancename Имя экземпляра клипа.
Описание
Свойство; устанавливает y-координату клипа относительно локальных координат родительского клипа. Если клип расположен на главной монтажной линейке, то начало его системы координат (0, 0), находится в верхнем левом углу рабочего окна. Если клип вложен внутрь другого трансформированного клипа, он находится в локальной системе координат родительского клипа. Таким образом, после поворота родительского клипа на 90° против часовой стрелки, его дочерние клипы унаследуют систему координат, повернутую на 90° против часовой стрелки. Координаты клипа относятся к его точке отсчета (registration point).
Player
Flash 3 или выше.
Смотрите также
_yscale
_Ymouse
Синтаксис
instancename._ymouse
Аргументы
instancename Имя экземпляра клипа.
Описание
Свойство (только чтение); Указывает y-координату позиции мыши.
Player
Flash 5 или выше.
Смотрите также
Mouse (object)
_xmouse
_Yscale
Синтаксис
instancename._yscale instancename._yscale = percentage;
Аргументы
percentage Процентное значение, определяющее процент для вертикального масштабирования клипа. Значение по умолчанию - 100.
instancename Имя экземпляра клипа.
Описание
Свойство; определяет вертикальный масштаб (percentage) клипа, принятый от точки отсчета клипа. По умолчанию точка отсчета есть (0,0).
Масштабирование локальной системы координат воздействует на установки свойств _x и _y, которые определены в пикселах. Например, если родительский клип масштабируется на 50%, установка свойства клипа _y передвинет объект в клипе на половину числа пикселов, как если бы клип был 100%.
Player
Flash 4 или выше.
Смотрите также
_x
_y