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";
}

Ошибка

Error

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

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

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

Примеры

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

LineEdit_1.Text = FileSystemError_1.Text;

Путь к файлу

string Path

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

Примеры

Установите путь к файлу 1.txt

TextFile_1.Path = "C:\\Users\\User1\\Desktop\\1.txt";

Режим открытия

uint1 OpenMode

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

Значение

1 Доступ на чтение.
2 Доступ на запись.
3 Доступ на чтение и запись.
4 Добавление данных в конец файла.
8 При открытии файла его содержимое будет полностью удалено, и файл станет пустым.
16 Автоматическое преобразование переносов строк в зависимости от операционной системы.

Примеры

Установите режим открытия файла, чтобы разрешить чтение и запись:

TextFile_1.OpenMode = 3;

Кодировка

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

Примеры

Вывести кодировку текстового файла в текстовое поле

Text_1.Text = TextFile_1.CurrentEncoding;

Определять Unicode кодировку

bool AutoDetectUnicode

Будет ли автоматически определяться Unicode кодировка файла (UTF-8, UTF-16 или UTF-32) при чтении файла на основе маркера последовательности байтов (BOM).

Значение

true Автоматически определять Unicode кодировку файла.
false Не определять Unicode кодировку автоматически.

Примеры

Включить автоматическое определение Unicode кодировки

TextFile_1.AutoDetectUnicode = true;

Генерировать BOM

bool AutoWriteByteOrderMark

Будет ли автоматически добавляться маркер последовательности байтов (BOM) в начало файла при записи в Unicode кодировке (UTF-8, UTF-16 или UTF-32).

Значение

true Добавлять BOM в начало файла при записи в Unicode кодировке.
false Не добавлять BOM при записи.

Примеры

Включить автоматическое добавление BOM при записи файла

TextFile_1.AutoWriteByteOrderMark = true;

Текущий путь к файлу

string CurrentPath

Путь к текущему открытому текстовому файлу.

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

Примеры

Получить путь к текущему открытому файлу и вывести его в текстовое поле

Text_1.Text = TextFile_1.CurrentPath;

Текущий режим открытия файла

uint1 CurrentOpenMode

В каком режиме открыт файл.

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

Значение

1 Доступ на чтение.
2 Доступ на запись.
3 Доступ на чтение и запись.
4 Добавление данных в конец файла.
8 При открытии файла его содержимое будет полностью удалено, и файл станет пустым.
16 Автоматическое преобразование переносов строк в зависимости от операционной системы.

Примеры

Получить текущий режим открытия файла и вывести его в текстовое поле

Text_1.Text = "Текущий режим открытия: " + String.toString(TextFile_1.CurrentOpenMode);

Текущая кодировка файла

string CurrentEncoding

В какой кодировке открыт файл.

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

Примеры

Получить текущую кодировку файла и вывести ее в текстовое поле

Text_1.Text = "Текущая кодировка файла: " + TextFile_1.CurrentEncoding;

Открыт ли файл

bool Opened

Открыт ли файл в данный момент.

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

Значение

true Файл открыт.
false Файл закрыт.

Примеры

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

Text_1.Text = "Файл открыт: " + (TextFile_1.Opened ? "Да" : "Нет");

Размер файла

int8 Size

Размер файла в байтах.

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

Примеры

Вывести размер файла в текстовое поле

Text_1.Text = "Размер файла: " + String.ToString(TextFile_1.Size) + " байт";

Позиция в файле

int8 Position

Текущая позиция в файле в байтах. Позиция указывает на текущее место чтения или записи в файле.

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

Примеры

Вывести текущую позицию в текстовое поле

Text_1.Text = "Текущая позиция в файле: " + String.ToString(TextFile_1.Position) + " байт";

В конце ли файла

bool AtEnd

Находится ли указатель чтения или записи в конце файла.

 

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

Значение

true Текущая позиция находится в конце файла.
false Текущая позиция не находится в конце файла.

Примеры

Вывести в текстовое поле информацию о том, достигнута ли текущая позиция конца файла

Text_1.Text = "Достигнут ли конец файла: " + (TextFile_1.AtEnd ? "Да" : "Нет");

Доступен для чтения

bool Readable

Доступен ли файл для чтения

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

Значение

true Файл доступен для чтения.
false Файл не доступен для чтения.

Примеры

Вывести в текстовое поле информацию о доступности файла для чтения

Text_1.Text = "Файл доступен для чтения: " + (TextFile_1.Readable ? "Да" : "Нет");

Доступен для записи

bool Writable

Доступен ли файл для записи

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

Значение

true Файл доступен для записи.
false Файл не доступен для записи.

Примеры

Вывести в текстовое поле информацию о доступности файла для записи

Text_1.Text = "Файл доступен для записи: " + (TextFile_1.Writable ? "Да" : "Нет");

Доступен для произвольного позиционирования

bool Seekable

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

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

Значение

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

Примеры

Вывести в текстовое поле информацию о возможности произвольного позиционирования файла

Text_1.Text = "Файл поддерживает произвольное позиционирование: " + (TextFile_1.Seekable ? "Да" : "Нет");