Admin: 1 revision imported

2026-04-01T09:57:50Z

1 revision imported

1>Admin at 09:30, 4 January 2026

2026-01-04T09:30:01Z

New page

{{infobox function
|name=BroadcastChannelSubscribe
|object=[[Функции общего назначения]]
|caption=Доставка сообщений
|type=1
|status=2
|db=0
|exception=Невозможно превратить в число, строку, ошибка сервера
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция подписывается на сообщения глобального канала сообщений, заданного по его имени (первый аргумент). Если указана форма-получатель сообщений, они будут приходить в виде события OnMessage ([[Студия/OnMessage|OnMessage]]) в момент, когда форма ожидает действий пользователя (idle). Если форма не указана, программе необходимо получать сообщения самостоятельно с помощью функции [[BroadcastChannelReceiveMessage]]. Подписка действует для текущего потока, если сообщения не забираются, они будут накапливаться на сервере. Для отказа от подписки, используйте [[BroadcastChannelUnsubscribe]]. Подписка удаляется автоматически, когда поток с подпиской заканчивает работу. Если указана форма и она будет закрыта, но поток продолжит работать, подписка не будет отменена (однако сообщения приходить не будут, так как отсутствует форма). Функция возвращает цифровой идентификатор канала, по которому к нему можно выполнять обращения (чуть быстрее, чем по имени). Идентификатор корректен до момента вызова [[BroadcastChannelUnsubscribe]] или завершения потока подписки.

== Синтаксис ==
<code>
'''BroadcastChannelSubscribe'''(''<Имя канала (STRING)>''{{Optional|,<Форма-получатель или ее серийный номер (FORM,INT)>{{Default|{{Eq}}0}}}}):''<Числовой идентификатор канала (INT)>''
</code>
==== Аргументы ====
* <code>''<Имя канала (STRING)>''</code> - Произвольное имя канала для подписки.
* <code>''<Форма-получатель или ее серийный номер (FORM,INT)>''</code> - {{Optional}} Указание на форму, если необходимо поулчать сообщения в виде события ''[[Студия/OnMessage|OnMessage]]''. Форма может быть задана серийным номером или самим объектом формы.

==== Возвращаемое значение ====
Возвращает числовой идентификатор канала на сервере.

== Примеры ==
<pre>
//Пример простого отправителя и подписчика в одном фрагменте текста.

Function Подписчик()
аКодКанала:=BroadcastChannelSubscribe("Канал");
аНум:=0;
While 1 Do
If not BroadcastChannelReceiveMessage(аКодКанала,100,аНум) Then
Continue;
EndIf;
Message("Получено сообщение с ID "+аНум);
If аНум=100 Then
Break;
EndIf;
EndDo;
BroadcastChannelUnsubscribe(аКодКанала);
Message("Поток закончил работу...");
EndFunction

Mutex.ExecuteFunctionInSeparateThread("Подписчик",0);

аКодКанала:=BroadcastChannelSubscribe("Канал");
ИдСообщения:=1;
While ИдСообщения<=100 Do
If BroadcastChannelSendMessage(аКодКанала,ИдСообщения,"")>0 Then
ИдСообщения:=ИдСообщения+1;
EndIf;
EndDo;
//Ожидания завершения потока после принятия сообщения 100
//Без этой паузы, поток можен быть завершен форсировано, так как текущий (родительский) поток будет завершен
Sleep(1000);

//Будет выведено:
//Получено сообщение с ID 1
//Получено сообщение с ID 2
//..
//Получено сообщение с ID 100
//Поток закончил работу...
</pre>

← Older revision	Revision as of 09:57, 1 April 2026
(No difference)

BroadcastChannelSubscribe - Revision history

Admin: 1 revision imported

1>Admin at 09:30, 4 January 2026