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

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.

Результат работы скрипта
До выполнения скрипта:
 

Default-окно MyChat Client под Windows

 

После выполнения скрипта:

 

Окно консоли MyChat Client под Windows

 

Ещё посмотреть

Справка по MyChat Client под Windows