Admin: 1 revision imported

2021-02-07T06:52:24Z

1 revision imported

Admin at 20:39, 3 December 2020

2020-12-03T20:39:22Z

New page

{{infobox function
|name=PostMessageToForm
|object=[[Функции общего назначения]]
|caption=Доставка сообщений
|type=1
|status=1
|db=0
|exception=Невозможно превратить в число, строку, неверный аргумент
|visual=1}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция осуществляет доставку пользовательского сообщения с параметрами указанной по серийному номеру форме. Для формы будет вызвано [[Студия/Визуальные события|прерывающее]] визуальное событие [[Студия/OnMessage|OnMessage]]. Доставка также может быть осуществлена макросу, располагающемуся на форме или указанной по имени странице страничного элемента. Функция возвращается сразу после успешной отправки сообщения или ошибке при отправке. Измененные формой параметры не будут переданы назад. Серийный номер формы можно получить с помощью функции [[Form.SerialNumber]] или как один из аргументов функции [[LoadToolForm]]. PostMessageToForm отличается от [[SendMessageToForm]] тем, что ни при каких условиях не будет занимать продолжительное время, даже если сообщение не удается отправить сразу же и обработчик отправки будет пытаться сделать это некоторое время, поток, вызвавший PostMessageToForm продолжит работу.

== Синтаксис ==
<code>
'''PostMessageToForm'''(''<Серийный номер формы (INT)>'',''<Код сообщения (INT)>''{{Optional|,<Параметр>,<Опция>,<Гарантировать доставку (INT)>{{Default|{{Eq}}1}},<Имя макроса или страницы объекта формы (STRING)>{{Default|{{Eq}}""}}}}):''<Сообщение было отправлено 0 или 1 (INT)>''
</code>
==== Аргументы ====
* <code>''<Серийный номер формы (INT)>''</code> - Серийный номер формы, которой необходимо отправить сообщение.
* <code>''<Код сообщения (INT)>''</code> - Произвольный код сообщения, коды 1-10000 рекомендуется использовать для нужд проекта, остальные для нужд внешних обработок.
* <code>''<Параметр>,<Опция>''</code> - {{Optional}} Произвольные параметры, передаваемые обработчику события ''OnMessage'' и доступные в нем под именами '''Param''' и '''Option'''.
* <code>''<Гарантировать доставку (INT)>''</code> - {{Optional}} Принимает значения: 1 (по умолчанию) -- поток будет ожидать окончания выполнения других событий и после этого будет запущено событие ''OnMessage'', что может занять продолжительное время, 0 -- поток запустит событие ''OnMessage'' только в случае, если поток-получатель сейчас свободен (или выполняет прерываемую работу), иначе функция вернет 0.
* <code>''<Имя макроса или страницы объекта формы (STRING)>''</code> - {{Planned}} Имя визуального объекта макроса или страницы страничного объекта в виде (<Имя страничного объекта>#<Номер или имя страницы объекта>). Если данный аргумент занят, сообщение будет доставлено не обработку самой формы, а указанному элементу формы, если он существует.

==== Возвращаемое значение ====
Возвращает 0 если сообщение не было доставлено или событие ''OnMessage'' не инициировано (форма с таким серийным номером не существует или была занята и пр.), в ином случае возвращает 1.

== Примеры ==
<pre>
//Обработчик визуального события OnMessage (редактируется в редакторе форм Студии)
Sleep(1000);
Message("Было получено сообщение: "+Message+" с параметрами ""+Param+"",""+Option+"""");
</pre>

<pre>
//Отсылает сообщение 10001 без дополнительных параметров текущей форме
PostMessageToForm(<Серийный номер формы с обтаботчиком>,10001);
Message("Проверка последовательности выполнения функций");
//Для текущей формы, в лог будет выведено: "Было получено сообщение: 10001 с параметрами "",""
// затем "Проверка последовательности выполнения функций" (если код вызывался из асинхронного события)
//Для формы другого потока: "Проверка последовательности выполнения функций"
// затем "Было получено сообщение: 10001 с параметрами "",""
</pre>

← Older revision	Revision as of 06:52, 7 February 2021
(No difference)

PostMessageToForm - Revision history

Admin: 1 revision imported

Admin at 20:39, 3 December 2020