_X

Синтаксис

instancename._x

instancename._x = integer

Аргументы

integer Локальная x-координата клипа.

instancename Имя экземпляра клипа.

Описание

Свойство; устанавливает x-координату клипа относительно локальных координат родительского клипа. Если клип расположен на главной монтажной линейке, то начало его системы координат (0, 0), находится в верхнем левом углу рабочего окна. Если клип вложен внутрь другого трансформированного клипа, он находится в локальной системе координат родительского клипа. Таким образом, после поворота родительского клипа на 90° против часовой стрелки, его дочерние клипы унаследуют систему координат, повернутую на 90° против часовой стрелки. Координаты клипа относятся к его точке отсчета (registration point).

Player

Flash 3 или выше.

Смотрите также

_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

Синтаксис

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

Синтаксис

myXML.nodeType;

Аргументы

Нет.

Описание

Свойство (только чтение); получает или возвращает значение nodeType, где 1 - элемент XML и 3 - текстовый узел.

Player

Flash 5 или выше.

Смотрите также

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

Добавляет узел к концу дочернего списка указанного объекта. cloneNode Клонирует указанный узел и, опционально, рекурсивно клонирует все дочерние записи. createElement Создает новый элемент XML. createTextNode Создает новый текстовый узел XML. hasChildNodes Возвращает true, если указанный узел имеет подчиненные узлы, в противном случае, возвращает false. insertBefore Вставляет узел перед существующим узлом в дочернем списке указанного узла. load Загружает документ (указанный объектом XML) с адреса URL. onLoad Функция повторного вызова для load и sendAndLoad. parseXML Анализирует XML документ в указанное дерево объекта XML. removeNode Удаляет указанный узел из его родителя. send Посылает указанный объект XML на адрес URL. sendAndLoad Посылает указанный объект XML на адрес URL и загружает ответ сервера в другой объект XML. toString Преобразовывает указанный узел и любые дочерние записи в текст XML.

Список свойств объекта XML

Свойство

Описание

docTypeDecl

Устанавливает и возвращает информацию об объявлениях DOCTYPE в XML документах. firstChild Ссылки на первый подчиненный объект в списке для указанного узла. lastChild Ссылки на последний подчиненный объект в списке для указанного узла. loaded Проверяет загружен ли указанный объект XML. nextSibling Ссылки на следующего брата в дочернем списке родительского узла. nodeName Возвращает имя тега элемента XML. nodeType Возвращает тип указанного узла (XML элемента или текстового узла). nodeValue Возвращает текст выбранного узла, если узел является текстовым.
parentNode Ссылки на родительскую вершину указанного узла. previousSibling Ссылки на предыдущего брата в дочернем списке родительского узла. status Возвращает числовой код состояния, указывающий успех или неудачу операции синтаксического анализа документа XML. xmlDecl Устанавливает и возвращает информацию об объявлениях документов в документе XML. Список групповых операций над объектами XML Метод

Описание

attributes

Возвращает ассоциативный массив, содержащий все атрибуты указанного узла. childNodes Возвращает массив, содержащий ссылки на подчиненные объекты указанного узла. Конструктор для объекта XML

Синтаксис

new XML(); new XML(source);

Аргументы

source Анализируемый документ XML для создания нового объекта XML.

Описание

Конструктор; создает новый объект XML. Вы должны использовать конструктор для создания экземпляра объекта XML перед вызовом его любых методов.

	Первый синтаксис создает новый, пустой объект XML.
	Второй синтаксис создает новый объект XML, анализируя XML документ, указанный в source параметре и заполняет созданный объект XML деревом XML документа.

Примечание: Методы createElement и createTextnode являются "конструкторскими" методами для создания элементов и текстовых узлов в дереве 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, чтобы проверить ответ от сервера.

Смотрите также

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

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

Синтаксис

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

Закрывает открытое сокетное соединение. connect Устанавливает связь с указанным сервером. onClose Возвратная функция, которая вызывается, когда XMLSocket соединение закрыто. onConnect Возвратная функция, которая вызывается, когда XMLSocket соединение установлено. onXML Возвратная функция, которая вызывается, когда с сервера прибывает объект XML. send Посылает объект XML на сервер. Конструктор для объекта XMLSocket

Синтаксис

new XMLSocket();

Аргументы

Нет.

Описание

Конструктор; создает новый объект XMLSocket. Объект XMLSocket первоначально не связан ни с каким сервером. Вы должны вызвать метод XMLSocket.connect, чтобы связать объект с сервером.

Player

Flash 5 или выше.

Пример

myXMLSocket = new XMLSocket();

Смотрите также

XMLSocket.connect

XMLSocket.onClose

Синтаксис

myXMLSocket.onClose();

Аргументы

Нет.

Описание

Метод; возвращающая функция, которая вызывается только в том случае, если связь закрыта сервером. Заданная по умолчанию реализация этого метода не выполняет никаких действий. Чтобы отменить заданное по умолчанию выполнение, Вы должны назначить функцию, содержащую ваши собственные действия.

Player

Flash 5 или выше.

Смотрите также

function

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 или выше.

Смотрите также