Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Свойства

Отображаемое имя

Описание объекта (поля объекта). Позволяет указать произвольное (например, русскоязычное) имя для узнаваемости объекта (поля объекта) в проекте. Не мешает использованию базового англоязычного имени объекта (поля объекта) для обращения в коде.

Кардинальное число

Преобразует объект в массив и задает размер массива (количество элементов в массиве).

Значение

1 Одиночный объект.
>1 Массив соответствующей размерности.

Переменные среды процесса

Environment 

Ссылка на компонент Окружение: переменные среды процесса.

Указание ссылки дает возможность использовать настройки переменных окружения, определенных в компоненте Окружение: переменные среды процесса при запуске процесса с помощью компонента Окружение: процесс. Если ссылка на Окружение: переменные среды процесса указана, но переменные окружения не настроены, то будут использоваться значения переменных окружения по умолчанию из операционной системы.

Примеры

Записать в поле ввода значение переменной среды TEMP

TextEdit.Text = Process_1.Environment.Get("TEMP");

Идентификатор запущенного или завершившегося процесса

uint4 ID

ID процесса Alpha.HMI.

Доступно только для чтения в режиме рантайма.

Примеры

Вывести ID процесса Alpha.HMI в поле ввода.

TextEdit.Text = String.ToString(Process_1.ID);

Состояние процесса

uint1 State

Позволяет отслеживать состояние процесса, запущенного с помощью компонента Окружение: процесс.

Доступно только для чтения в режиме рантайма.

Значение

0 Процесс выключен
1 Процесс запускается.
2 Процесс запущен.

Код завершения

int4 ExitCode

Код завершения процесса после его выполнения.

Доступно только для чтения в режиме рантайма.

Значение

0 Процесс успешно завершился.
>0 Процесс завершился с ошибкой.

Полный путь к исполняемому файлу

string ExecutablePath

Предоставляет полный путь к исполняемому файлу.

Доступно только для чтения в режиме рантайма.

Примеры

Вывести в текстовое поле путь к исполняемому файлу.

Text_2.Text = Process_1.ExecutablePath;

Путь до файла приложения

string Path

Позволяет указать путь к исполняемому файлу процесса, который будет запускаться с помощью компонента Окружение: процесс. Установка значения этого свойства определяет, какое приложение должно быть запущено при вызове метода Run().

Примеры

Установить путь к исполняемому файлу MyApp.exe

Process_2.Path = "C:\\Program Files\\MyApp\\MyApp.exe";

Показывать окно

bool ShowWindow

Отображать ли окно запускаемого внешнего процесса при его выполнении.

Значение

true Окно запускаемого процесса будет отображаться на экране.
false Запускаемый процесс будет выполняться в фоновом режиме, без отображения его окна на экране

Примеры

Запустить приложение MyApp.exe с видимым окном.

Process_2.ShowWindow = true;
Process_2.Path = "C:\\Program Files\\MyApp\\MyApp.exe";
Process_2.Run();

Аргументы запуска

string Arguments

Позволяет указать дополнительные аргументы командной строки, которые будут переданы приложению при его запуске с помощью компонента Окружение: процесс. Аргументы командной строки представляют собой дополнительные параметры, которые влияют на работу запускаемого процесса.

Если аргументы содержат пробелы, необходимо заключить их в двойные кавычки. Это важно для корректной интерпретации параметров процессом. Например, если вам нужно передать аргумент D:\\Project Test\\hello.py содержащий пробел, то свойство Аргументы запуска следует установить так:

Process_1.Arguments = "\"D:\\Project Test\\hello.py\"";

Примеры

Открыть текстовый файл 1.txt с помощью notepad.exe

Process_1.Path = "C:\\Windows\\System32\\notepad.exe";
Process_1.Arguments = "C:\\Work\\1.txt";
Process_1.ShowWindow = true;
Process_1.Run();

Рабочий каталог

string WorkingDirectory

Позволяет задать рабочий каталог для запускаемого внешнего процесса.

Рабочий каталог представляет собой директорию, в которой будет выполняться запускаемый процесс.

Используется, если запускаемому процессу необходим доступ к файлам или ресурсам, расположенным в определенной директории, и его работа зависит от этой локации.

Примеры

Задать рабочий каталог C:\Program Files\Work\Process для запускаемого процесса.

Process_1.WorkingDirectory = "C:\\Program Files\\Work\\Process";

Кодировка

String Encoding

Позволяет указать кодировку, которая будет использоваться при выполнении внешнего процесса. Кодировка определяет, как символы текста будут представлены в байтовом виде.

Значение

UTF-8 ISO-8859-1 latin1 CP819 IBM819
iso-ir-100 csISOLatin1 ISO-8859-15 latin9 UTF-32LE
UTF-32BE UTF-32 UTF-16LE UTF-16BE UTF-16
System Big5-HKSCS Big5 Big5-ETen CP950
windows-949 CP949 EUC-KR Shift-JIS SJIS
MS_Kanji ISO-2022-JP JIS7 EUC-JP GB2312
GBK CP936 MS936 windows-936 GB18030
hp-roman8 roman8 csHPRoman8 TIS-620 ISO 8859-11
WINSAMI2 WS2 macintosh Apple Roman MacRoman
windows-1258 CP1258 windows-1257 CP1257 windows-1256
CP1256 windows-1255 CP1255 windows-1254 CP1254
windows-1253 CP1253 windows-1252 CP1252 windows-1251
CP1251 windows-1250 CP1250 IBM866 CP866
csIBM866 IBM874 CP874 IBM850 CP850
csPC850Multilingual ISO-8859-16 iso-ir-226 latin10 ISO-8859-14
iso-ir-199 latin8 iso-celtic ISO-8859-13 ISO-8859-10
iso-ir-157 latin6 ISO-8859-10:1992 csISOLatin6 ISO-8859-9
iso-ir-148 latin5 csISOLatin5 ISO-8859-8 ISO 8859-8-I
iso-ir-138 hebrew csISOLatinHebrew ISO-8859-7 ECMA-118
greek iso-ir-126 csISOLatinGreek ISO-8859-6 ISO-8859-6-I
ECMA-114 ASMO-708 arabic iso-ir-127 csISOLatinArabic
ISO-8859-5 cyrillic iso-ir-144 csISOLatinCyrillic ISO-8859-4
latin4 iso-ir-110 csISOLatin4 ISO-8859-3 iso-ir-109
latin3 csISOLatin3 ISO-8859-2 latin2 iso-ir-101
csISOLatin2 KOI8-U KOI8-RU KOI8-R csKOI8R
iscii-mlm iscii-knd iscii-tlg iscii-tml iscii-ori
iscii-gjr iscii-pnj iscii-bng iscii-dev TSCII

Примеры

Открыть текстовый файл 1.txt с помощью notepad.exe с содержимым в кодировке UTF-8

Process_1.Path = "C:\\Windows\\System32\\notepad.exe";
Process_1.Arguments = "C:\\Work\\1.txt";
Process_1.ShowWindow = true;
Process_1.Encoding = "UTF-8"
Process_1.Run();

Накапливать стандартный вывод

bool AccumulateStdout

Указывает, следует ли накапливать стандартный вывод stdout при выполнении процесса, запущенного с использованием компонента Окружение: процесс. Когда данное свойство установлено в значение true, компонент Окружение: процесс будет накапливать данные, выводимые в стандартный поток вывода и сохранять их в свойстве Накопленный стандартный вывод.

Значение

true Накопление стандартного вывода включено .
false Накопление стандартного вывода отключено (по умолчанию).

 

Накопленный стандартный вывод

String AccumulatedStdout

Предоставляет доступ к накопленному стандартному выводу stdout после выполнения процесса, запущенного с использованием компонента Окружение: процесс.

Если свойство Накапливать стандартный вывод установлено в значение true, процесс накапливает стандартный вывод, а затем сохраняет его в данном свойстве.

Доступно только для чтения в режиме рантайма.

Вывести в текстовое поле накопленный стандартный вывод после завершения процесса.

Text_1.Text = Process_1.AccumulatedStdout;

Накапливать стандартный вывод ошибок

bool AccumulateStderr

Указывает, следует ли накапливать стандартный вывод ошибок stderr при выполнении процесса, запущенного с использованием компонента Окружение: процесс.

Когда данное свойство установлено в значение true, компонент Окружение: процесс будет накапливать данные, выводимые в стандартный поток вывода ошибок и сохранять их в свойстве Накопленный стандартный вывод ошибок.

Значение

true Накопление стандартного вывода ошибок включено.
false Накопление стандартного вывода ошибок отключено (по умолчанию).

Накопленный стандартный вывод ошибок

string AccumulatedStderr

Предоставляет доступ к накопленному стандартному выводу ошибок stderr после выполнения процесса, запущенного с использованием компонента Окружение: процесс.

Если свойство Накапливать стандартный вывод ошибок было установлено в true процесс накапливает стандартный вывод ошибок, а затем сохраняет его в данном свойстве.

Доступно только для чтения в режиме рантайма.

Вывести в текстовое поле накопленный стандартный вывод ошибок после завершения процесса.

Text_1.Text = Process_1.AccumulatedStderr;