Командная строка

С помощью командной строки вы можете передать неограниченное количество параметров (ключей) для вашего приложения.
Откройте файл cmdline.mbd, который находится в папке Samples. Просто скомпилируйте проект и запустите его с несколькими ключами.

Правила передачи параметров (ключей) скомпилированному exe-файлу:

Все параметры, передаваемые приложению, должны разделяться пробелом.
Пример:
Program.exe param1 param2 => Приложению передано два параметра
Если вы хотите передать параметр, содержащий пробел, то его необходимо заключить в кавычки. Это удобно использовать, если в качестве параметра используется имя файла, содержащее пробелы.
Пример:
Program.exe param1 "param2 param2" => Приложению передано два параметра, но второй разделен пробелом.
Если вы хотите передать параметр, содержащий кавычки, то просто продублируйте кавычки.
Пример:
Program.exe param1 ""param2 param2"" => Приложению передано два параметра, один из которых содержит кавычки.

Все параметры, переданные MMB-приложению, хранятся (в виде переменной строкового типа) в специальном строковом массиве с именем CmdLineParam$[n], где n - число между 0 и числом выполненных параметров.

Переменная CmdLineParam$[0] содержит число выполненных параметров, а остальные переменные CmdLineParam$[1..n] содержат сами параметры. Таким образом можно легко нумеровать параметры.

Если требуется передать приложению какое-либо число (т. е. параметр не строкового типа), то необходимо преобразовать строковый тип в числовой (используя функцию VAL).

ПРИМЕРЫ:
Если запустить приложение с 3 параметрами, то массив CmdLineParam$[n] будет содержать следующие значения:
myprogram.exe param1 param2 param3

CmdLineParam$[0]=>3 **число выполненных параметров
CmdLineParam$[1]=>param1 **первый параметр
CmdLineParam$[2]=>param2 **второй параметр
CmdLineParam$[3]=>param3 **третий параметр

Или, если запустить приложение с двумя параметрами, но один из них разделить пробелом...
myprogram.exe param1 "param21 param22"
CmdLineParam$[0]=>2 **число выполненных параметров
CmdLineParam$[1]=>param1 **первый параметр
CmdLineParam$[2]=>param21 param22 **второй параметр

Это полный (но не имеющий практической ценности) пример использования параметров в MMB-приложениях.

ПРИМЕР:
Поместите этот код в событие MouseUp любого активного объекта (например, кнопки), скомпилируйте приложение и запустите с несколькими ключами. В окне сообщения отобразятся выполненные параметры.

** CmdLineParam$[0] содержит число выполненных параметров
n=VAL(CmdLineParam$[0])
** если число параметров > 0, тогда...
If (n>0) Then
**Этот цикл просто нумерует выполненные параметры...
For i=1 To n
** ..и отображает полученные параметры в окне сообщения.
Message("Параметр командной строки:","CmdLineParam$[i]")
Next i
End

Конечно же, приведенный выше код не будет иметь практического значения без автоматической обработки полученных параметров. Если вы хотите автоматически обрабатывать параметры, как только они будут получены приложением, то просто создайте новый скрипт с именем CBK_CMDLINE (обязательно на Master Page/Layer) и поместите ваш код обработки параметров в этот скрипт. Всякий раз, как только вы запустите приложение с параметрами, этот скрипт будет выполнять код обработки.

С помощью этого специального скрипта вы можете передавать параметры не только запускаемым приложениям, но и уже работающим приложениям. Например, если программа уже запущена, и вы хотите передать несколько новых параметров, то просто вызовите приложение с новыми параметрами.

ПРИМЕЧАНИЕ!
Подводным камнем данной функции (но с нашей точки зрения большим плюсом ;) является то, что mmb-приложения больше не обрабатывают аудио/видеофайлы автоматически в качестве команды, как в предыдущих версиях. Другими словами, если вы хотите передать в качестве параметра имя MP3/OGG файла и начать его воспроизведение, то это необходимо делать через скрипт CBK_CMDLINE. Как и раньше, MMB автоматически запустит файл поддерживаемого типа, например, mp3, ogg или avi.

Единственный формат, который по-прежнему автоматически загружается в качестве параметра - файл проекта mbd. Если вы укажете в качестве первого параметра файл проекта mbd, то он автоматически откроется в основном окне приложения. Если требуется избежать автоматического запуска проекта, то необходимо указывать путь к файлу mbd в качестве второго параметра:

короче говоря, в этом случае избегайте таких команд...
myprogram.exe "Путь к файлу.mbd" "Параметр"

и используйте команды вида:
myprogram.exe "Параметр" "Путь к файлу.mbd"

ПОДСКАЗКА!
С помощью параметров командной строки можно создать программу-заставку (Screen Saver), включая вызов настроек заставки. Примеры находятся в папке Samples: screensaver.mbd и rlt4.mbd. Просто скомпилируйте данные проекты с расширением scr и поместите в папку Windows. Затем установите их в качестве заставки.