MyChat Scripts: функция mSetRemoteClientCurrentPlaceID, переключить активное окно пользователя

"Для разработчиков", "Серверные скрипты", "Описание функций", "Пользователи", "mSetRemoteClientCurrentPlaceID".

Функция для принудительного переключения интерфейса клиентского приложения указанного онлайн-пользователя на конференцию, приват, консоль и другие элементы интерфейса.

Синтаксис

function mSetRemoteClientCurrentPlaceID(const iUIN, iID, iPlaceID: integer; const bShowChatWindow: boolean): integer;

Параметры и возвращаемые значения

Параметр	Тип	Значение
iUIN	integer	уникальный идентификатор онлайн-пользователя;
iID	integer	UIN / UID / индекс важного сообщения, в зависимости от того, на что нужно переключиться;
iPlaceID	integer	элемент интерфейса чата, куда нужно переключиться: 0 - консоль; 1 - приват; 2 - конференция; 7 - default окно, когда не выбрано ничего; 8 - создание текстовой конференции; 9 - выбор текстовой конференции для подключения; 10 - окно с QR-кодом и ссылками на Android-приложение; 11 - панель важных сообщений (Ctrl + 4); 13 - окно с QR-кодом и ссылкой на приложение для iOS (iPhone/iPad);
bShowChatWindow	boolean	показывать окно чата на переднем плане.

Результат функции

0	всё ок, команда успешно отправлена;
-1	указанного пользователя не существует;
-2	указанный пользователь сейчас отключен от сервера (офлайн);
-3	нельзя отправить эту команду встроенному роботу (UIN 0);
-4	UID не существует;
-5	UIN для привата не существует;
-6	неправильный Place ID.

Пример

Скрипт переключает окно удалённого пользователя с UIN 6 на консоль и показывает окно приложения MyChat Client поверх всех окон (stay on top), даже если программа работает в терминальной сессии.

begin
mSetRemoteClientCurrentPlaceID(6, -1, 0, true);
end.