MyChat Scripts: mSetRemoteClientCurrentPlaceID, switch user's active window
The function to force switching from the user's client interface to a conference, private dialogue, console, or other interface options.
Syntax
function mSetRemoteClientCurrentPlaceID(const iUIN, iID, iPlaceID: integer; const bShowChatWindow: boolean): integer;
Parameters and return values
|
Parameter |
Type |
Value |
|
iUIN |
integer |
online user's ID; |
|
iID |
integer |
UIN / UID / index of the important message according to which place you need to switch; |
|
iPlaceID |
integer |
chat's interface option for switching; 0 - console; 1 - private dialogue; 2 - conference; 7 - default window; 8 - creating a text conference; 9 - choosing a conference for connection ; 10 - window with QR code and links to Android application; 11 - tab with important messages (Ctrl + 4); 13 - window with QR code and link leading to iOS application (iPhone/iPad); |
|
bShowChatWindow |
boolean |
show chat window on top of all windows. |
Function result
|
0 |
all OK, the command sent successfully; |
|
-1 |
this user does not exist; |
|
-2 |
this user is currently disconnected from the server (offline); |
|
-3 |
impossible to send this command to the built in bot (UIN 0); |
|
-4 |
UID does not exist; |
|
-5 |
UIN for a private dialogue does not exist; |
|
-6 |
incorrect Place ID. |
Example
The script switches the window of the user UIN 6 to the console and display MyChat Client window on top of all windows, even if the application works in the terminal session.
begin
mSetRemoteClientCurrentPlaceID(6, -1, 0, true);
end.
Script work result
Before executing the script:
After:
