Процедуры и функции управления работой сценария

Инструкции для управления сценарием, плагинами и пр.

Содержание

• WAIT
• WAITMS
• GOTO
• CALL
• EXECUTE
• INPUTBOX
• DIALOGBOX
• RADIOBOX
• HALT
• READMEM
• WRITEMEM

WAIT

WAIT (delay) - приостанавливает выполнение сценария на неск. секунд

delay - числовое значение, обозначающее длину задержки в секундах между строками сценария

Задержка имеет некоторую неустранимую погрешность, зависящую от некоторых факторов. На практике, погрешность обычно не превышает 5 мс (0,005 сек.)
Допускается указание дробного аргумента. Так, задержка 1.25 будет означать одну секунду и 250 милисекунд.

WAITMS

WAITMS (delay) - приостанавливает выполнение сценария на неск. миллисекунд

delay - числовое значение, обозначающее длину задержки в миллисекундах между строками сценария

В одной секунде 1000 миллисекунд
Задержка имеет некоторую неустранимую погрешность, зависящую от некоторых факторов. На практике, погрешность обычно не превышает 5 мс (0,005 сек.)

GOTO

GOTO (label) - переводит интерпретацию на строку с меткой

label - имя метки

goto(skip)

logwrite("nope") // пропускается
skip:
logwrite("yea")  // выполнится

Переход на метку допускается в рамках блоков одного уровня вложенности. Текстовая метка задается без кавычек, в тексте скрипта после текстовой метки обязательно должно идти двоеточие ":", как в примере. Метка занимает всю строку

CALL

CALL ("filename", par1, ...) - вызывает плагин

filename - имя файла плагина относительно директории %Clickermann%/plugins
par1, ... - целочисленные параметры

call("plugin_example.dll", 5, 2, 3)

logwrite($_return1)

Рекомендуется ознакомиться со статьей "Плагины" из основной справки
Кликер ждет момента как отработки плагина и только потом продолжает работу
Плагин возвращает значение в переменную $_return1

EXECUTE

EXECUTE ("filename", ["param"]) - вызывает внешний файл

filename - имя файла
param - необязательный параметр; строка параметров

// вызываем батник
execute("some.bat")

// пингуем яндекс
execute("ping", "ya.ru -n 10")

Инструкция вызывает произвольный внешний файл. При этом запуск обрабатывается согласно ассоциациям, прописанным в системе. Дает схожий результат с "Пуск" -> "Выполнить" (Win + R)
Допускается как задание относительного пути к файлу, так и абсолютного.
Инструкция сразу же возвращает управление в программу независимо от времени загрузки внешнего файла и его обработчика.

INPUTBOX

INPUTBOX("message", "default", [delay]) - строковая функция; выводит диалоговое окно для ввода строки

message - сообщение диалогового окна
default - значение по умолчанию
delay - необязательный параметр; таймаут

$str = inputbox("text", "hello")

print($str)

Диалоговое окно висит delay секунд. Если за это время пользователь не начал ввод или не нажал одну из кнопок, то функция вернет строку по умолчанию. Если пользователь нажал отмену, то будет возвращена пустая строка
По умолчанию параметр delay равен 5
Возможно использовать кнопки Enter для ввода и Esc для отмены

DIALOGBOX

DIALOGBOX("message", buttons, [icon]) - числовая функция; выводит диалоговое окно с кнопками

message - сообщение диалогового окна
buttons - код набора кнопок
icon - код иконки

Код	Кнопка
0	OK
1	OK, CANCEL
2	ABORT, RETRY, IGNORE
3	YES, NO, CANCEL
4	YES, NO
5	RETRY, CANCEL

Код	Кнопка
0	Без иконки
1	Ошибка
2	Вопрос
3	Внимание
4	Информирование

Код	Кнопка
1	OK
2	CANCEL
3	ABORT
4	RETRY
5	IGNORE
6	YES
7	NO

// Выводит диалоговое окно с двумя кнопками - Yes, No
$mr = dialogbox("Yes or No?", 4)

if ($mr = 6)
  print("Yes")
else
  print("No")
end_if  

Функция возвращает код той кнопки, которую нажал пользователь. Выполнение скрипта будет остановлено до тех пор, пока какая-либо из кнопок не будет нажата
По умолчанию параметр icon равен 0

RADIOBOX

RADIOBOX("message", radio1, ...) - числовая функция; выводит диалоговое окно с переключателями

message - сообщение диалогового окна
radio1 - строка, описывающая переключатель

$res = radiobox("Выберете пункт", "1 Мясо", "2 Птица", "3 Рыба")

if ($res ! 0)
  print("Вы выбрали: ", $res)
else
  print("Вы ничего не выбрали")
end_if	  
	 
halt

Число параметров данной инструкции неограниченно
Функция возвращает порядковый номер выбранного элемента. Выполнение скрипта будет остановлено до тех пор, пока не будет нажаты OK или CANCEL
В случае нажатия CANCEL, функция вернет 0

HALT

HALT([close]) - полностью останавливает выполнение сценария

close - если 1, то приложение закрывается целиком

READMEM

READMEM (pid, "addr", [size]) - считывает целое значение из памяти процесса

pid - идентификатор процесса
addr - строка, адрес памяти
size - тип значения (1,2,4,8)

$_return1 - прочитанное значение

readmem(2080, "0006F2B7")
logwrite($_return1)

идентификатор процесса (PID) можно узнать в диспетчере задач либо в самом кликере, в области "Оконный режим"
Адрес представлен строкой шестнадцатеричного числа
Параметр size указывает на размер целого значения: 1, 2, 4 или 8 байт. Если данный параметр опущен, то он принимается за 4
Полученное значение возвращается в переменную $_return1

WRITEMEM

WRITEMEM (pid, "addr", value, [size]) - помещает целое значение в память процесса

pid - идентификатор процесса
addr - строка, адрес памяти
value - численное значение
size - тип значения (1,2,4,8)

writemem(2080, "0006F2B7", 5000)

идентификатор процесса (PID) можно узнать в диспетчере задач либо в самом кликере, в области "Оконный режим"
Адрес представлен строкой шестнадцатеричного числа
Параметр size указывает на размер целого значения: 1, 2, 4 или 8 байт. Если данный параметр опущен, то он принимается за 4

GETFILELIST

GETFILELIST ($arr, ["dir"]) - помещает в массив список файлов, найденных согласно маске

$arr - принимающий массив
dir - адрес, содержащий маску выборки

// пример1 вывод всех файлов из C:
getfilelist($arr, "C:\*.*")

for($i=0, $i< arrsize($arr))
   print($arr[$i])
end_cyc

halt

// пример2 вывод файлов sys из C:
getfilelist($arr, "C:\*.sys")

for($i=0, $i< arrsize($arr))
   print($arr[$i])
end_cyc

halt

Путь должен обязательно содержать маску. По умолчанию путь равен "*".

GETDIRLIST

GETDIRLIST ($arr, ["dir"]) - помещает в массив список каталогов, найденных согласно маске

$arr - принимающий массив
dir - адрес, содержащий маску выборки

// вывод всех каталогов на C:
getdirlist($arr, "C:\*")

for($i=0, $i< arrsize($arr))
   print($arr[$i])
end_cyc

halt

Путь должен обязательно содержать маску. По умолчанию путь равен "*".