Alpha.Community

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

Свойства

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

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

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

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

Значение

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

Длина

int8 Length

Размер массива (количество элементов в массиве).

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

Примеры

Записать в текстовое поле длину массива.

TextEdit_1.Text = Str.ToString (SW_1.Length);

Индекс

int8 Index

Индекс элемента в массиве. Позволяет отследить у какого элемента сработало то или иное событие.

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

Примеры

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

TextEdit_2.Text = Str.ToString(Index);

Записать в текстовое поле текущее значение элемента массива, у которого сработало событие изменения значения.

TextEdit_3.Text = Str.ToString(penwidth[Index]);

В зависимости от индекса элемента в массиве вывести в текстовое поле запись о включении соответствующего режима работы задвижки.

if (SW_1.Mode.Index == 0)
{
TextEdit_1.Text = "Включен режим 1";
}
else
{
TextEdit_1.Text = "Включен режим 2";
}

Папка текущего пользователя

string CurrentUserFolder

Полный путь к папке текущего пользователя операционной системы.

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

Примеры

Вывести полный путь к папке текущего пользователя ОС в текстовое поле.

Text_1 = FileSystem.CurrentUserFolder;

Общая папка пользователей

string AllUsersFolder

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

Полный путь к общей папке пользователей операционной системы.

Примеры

Вывести полный путь к общей папке пользователей ОС в текстовое поле.

Text_1 = FileSystem.AllUsersFolder;

В ОС Linux общая папка пользователей отсутствует, поэтому в данных системах свойство возвращает путь к папке текущего пользователя.

Папка текущего проекта

string ProjectFolder

Полный путь к папке проекта Alpha.HMI.

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

Примеры

Вывести полный путь к проекту в текстовое поле.

Text_1 = FileSystem.ProjectFolder;

Ошибка

FileSystemError Error

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

Чтобы узнать детали возникшей ошибки, обратитесь к свойствам Окружение: ошибка работы с файлами:

  • Состояние – произошла ли ошибка при возникновении последней операции;
  • Текст – текст ошибки последней операции;
  • Код – код ошибки последней операции;

Вывести возникшую ошибку в поле ввода.

LineEdit_1.Text = FileSystemError_1.Text;

Корневой путь

string RootPath

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