справка

Author: ahyahy

docs/OSDFormsRu/Enumerations.html

@@ -33,4 +33,7 @@ <H3 class=dtH3>События</H3>
     <TD width="50%">Возвращает или задает код для выполнения при нажатии элемента управления.</TD></TR>
   <TR vAlign=top>
     <TD width="50%"><A href="OSDForms.ElementMouseUpEvent.html">ПриОтпусканииМыши&nbsp;(MouseUp) (Элемент)</A></TD>
-    <TD width="50%">Возвращает или задает код для выполнения при отпускании кнопки мыши, когда указатель мыши находится на элементе.</TD></TR></TBODY></TABLE></DIV></DIV></BODY></HTML>
+    <TD width="50%">Возвращает или задает код для выполнения при отпускании кнопки мыши, когда указатель мыши находится на элементе.</TD></TR>
+  <TR vAlign=top>
+    <TD width="50%"><A href="OSDForms.DeclarativeFormsGettingPropertyEvent.html">ПриПолученииСвойства&nbsp;(GettingProperty) (ДекларативныеФормы)</A></TD>
+    <TD width="50%">Возвращает или задает код, указывающий на обработчик события при получении свойства объекта формы методом <B>ДекларативныеФормы.ПолучитьСвойство&nbsp;(DeclarativeForms.GetObjectProperty)</B>.</TD></TR></TBODY></TABLE></DIV></DIV></BODY></HTML>

docs/OSDFormsRu/Events.html

@@ -81,19 +81,6 @@ <H3 class=dtH3>Требования к каталогу Вашей програ
 <IMG src="Intro3.jpg"></IMG>
 <P></P>
 <br>
-<H3 class=dtH3>Конструкторы экземпляров класса.</H3>
-<br>
-<P>Создать элемент можно разными способами. Поддерживаются <B>HTML</B> тэги соответствующие элементу, но только для класса <B>Элемент</B>, так как он является базовым 
-классом.</P>
-<PRE class=code>
-Кнопка1 = ДФ.Кнопка();
-Кнопка2 = ДФ.Элемент("Кнопка");
-Кнопка3 = ДФ.Элемент("button");
-Абзац1 = ДФ.Элемент("p");
-Диалог1 = ДФ.Элемент("dialog");
-</PRE>
-<P></P>
-<br>
 <H3 class=dtH3>Подключение библиотеки и создание объекта ДекларативныеФормы.</H3>
 <br>
 <P>Подключить библиотеку можно так:</P>
@@ -118,10 +105,47 @@ <H3 class=dtH3>Закрытие программы.</H3>
 после закрытия окна программы.</P>
 <P>Избежать появление окна консоли совсем поможет разработка <A href="https://github.com/ahyahy/OneScriptNoConsole" target="_blank">Запуск сценариев OneScript без окна консоли</A>.</P>
 <P></P>
-<P></P>
-<P></P>
-<P></P>
-<P></P>
+<br>
+<H3 class=dtH3>Как происходит обработка событий.</H3>
+<br>
+<P>Декларативные формы выполнены в парадигме событийно-ориентированного программирования. С одной стороны у нас движок <B>NW.JS</B>, который по нашему плану 
+создал окно с движком браузера <B>Chromium</B> в пределах окна. С другой стороны сценарий, работающий на движке <B>OneScript</B>. Связь между ними происходит 
+посредством <B>TCP сервера</B>, запущенного фоновым процессом из сценария. При возникновении в форме события выполняется соответствующая функция из 
+скрипта <B>main.js</B>. Функция формирует <B>HTTP-запрос</B> для <B>TCP сервера</B>. <B>TCP сервер</B> анализирует этот запрос, находит указанный 
+обработчик в сценарии и выполняет его. Затем высылает клиенту ответ. В этом ответе в виде строки собраны все действия возникшие во время выполнения обработчика. 
+Действия эти представлены именами функций с параметрами. Функции разделены точкой с запятой. Получив в ответ на <B>HTTP-запрос</B> строку с перечнем функций 
+скрипт <B>main.js</B> выполняет их, что вызывает изменения в форме.</P>
+<P>Строка ответа сервера может быть просмотрена в любое время, она доступна в свойстве 
+<B>ДекларативныеФормы.СтрокаФункций&nbsp;(DeclarativeForms.FunctionString)</B>. И её можно изменить, повлияв на ответ сервера по своему усмотрению.</P>
+<P>Из всего этого ясно, что изменять форму в ответ на возникающие события мы можем только во время выполнения <B>HTTP-запроса</B>. Первый такой запрос 
+производится при выполнении метода <B>Форма.Открыть&nbsp;(Form.Open)</B>. До его запуска идет код создания объектов формы, задания свойств. Эти действия 
+записываются в свойство <B>ДекларативныеФормы.СтрокаФункций&nbsp;(DeclarativeForms.FunctionString)</B>. С запуском метода <B>Форма.Открыть&nbsp;(Form.Open)</B> 
+<B>NW.JS</B> формирует окно и срабатывает событие загрузки страницы <B>index.html</B>. В этом событии посылается первый запрос на сервер. Сервер в ответе высылает 
+строку <B>ДекларативныеФормы.СтрокаФункций&nbsp;(DeclarativeForms.FunctionString)</B> функции из которой выполняются друг за другом. Создаются объекты формы и 
+устанавливаются их свойства.</P>
+<P>Мы обходимся без веб-сервера, но при этом не можем изменять состояние формы непосредственно при каждом атомарном изменении свойств объектов в сценарии. 
+Можно только пакетом получить сделанные изменения и только в пределах выполнения обработчика события. Сервер закрывает соединение после отсылки ответа 
+клиенту, иначе <B>HTTP-запрос</B> не будет получен клиентом. Было бы лучше иметь возможность влиять на состояние формы 
+не только при обработке события, но и в произвольном месте сценария. Для этого средствами <B>NW.JS</B> в файле <B>main.js</B> создается <B>TCP&nbsp;клиент</B>. 
+Он подключается к серверу и создает постоянный канал связи. При случайном или намеренном разрыве канал восстанавливается. По нему можно так же посылать 
+форме имена функций с параметрами и делать это можно не в пределах обработчика события. Клиент будет доступен как <B>ДФ.ОбщаяСтруктура.Клиент</B>. 
+ <PRE class=code>
+ДФ.ОбщаяСтруктура.Клиент.ОтправитьСообщение(ДФ.ОбщаяСтруктура.КС.СообщениеТекст(
+";setAttribute('" + Кнопка2.Имя + "', '" + "backgroundColor" + "', '" + "rgb(255, 255, 0)" + "')"));
+
+или так:
+
+Кнопка2.ЦветФона = ДФ.Цвет.Красный;
+ДФ.ОбщаяСтруктура.Клиент.ОтправитьСообщение(ДФ.ОбщаяСтруктура.КС.СообщениеТекст(ДФ.СтрокаФункций));
+</PRE>
+</P>
+<P>И клиент и переменная <B>КС</B> - это объекты библиотеки <B>OneScriptClientServer.dll</B>. Они доступны вот просто так сразу, без 
+дополнительных объявлений во всех подключенных сценариях. Как это достигается Вы можете узнать ознакомившись с моей разработкой 
+<A href="https://github.com/ahyahy/OneScriptIntegrator" target="_blank">Эффективное взаимодействия между сценариями проекта...</A>.</P>
+<P> Есть ограничение - такое возможно только после выполнения метода <B>Форма.Открыть&nbsp;(Form.Open)</B>, потому что <B>ДФ.ОбщаяСтруктура.Клиент</B> и 
+<B>ДФ.ОбщаяСтруктура.КС</B> доступны только после первого <B>HTTP-запроса</B> от загруженной формы.</P>
+<P>Так как <B>TCP сервер</B> многопоточный выполнение событий будет происходить не в линейном порядке отправки <B>HTTP-запросов</B>. 
+Оно будет зависеть от алгоритма работы сервера и выполнение строгой очередности здесь не наблюдается.</P>
 <P></P>
 <P></P>
 <br>