|
<< Click to Display Table of Contents >> Navigation: Проект в MasterSCADA 4D > Дерево библиотек > Библиотека BaseObjects > BaseObjects.ФБ.Системные > Работа с файлами > SysGetFiles |
Функциональный блок SysGetFiles служит для получения списка рабочих папок или файлов по заданному пути.
Важно! Для возможности работы c ФБ SysGetFiles в исполнительную систему должна входить опция MSRT4D-FileWork. Данная опция включена в базовый функционал лицензий Professional и Enterprise.
Этот функциональный блок может использоваться как самостоятельно, вне программ, так и в составе любой программы.
Важно! Данный ФБ не будет будет исполняться в задаче экрана.
Находится в библиотеке BaseObjects.
Вид в дереве |
Вид в редакторе FBD |
|
|
Входы и выходы ФБ:
Название |
Тип |
Назначение |
Входы |
||
Path |
STRING |
Задается путь к папке, из содержимого которой будет формироваться список. Может быть абсолютным или относительным рабочей папки. |
Wildcard |
STRING |
Задается шаблон для выбора файлов или папок из которых будет формироваться список при помощи знака *, существует четыре варианта использования шаблона: •*, в этом случае в список будут добавлены все файлы или папки; •*.txt, в этом случае в список будут добавлены все файлы с заданным расширением (в данном случае файлы с расширение .txt); •*1*, в этом случае в список будут добавлены все папки и файлы содержащие 1 в названии; •*1.txt, в этом случае в список будут добавлены все файлы оканчивающиеся на 1 с заданным расширением (в данном случае файлы с расширение .txt). |
SortBy |
USINT |
Определяет поле, по которому выполняется сортировка элементов. Значения: •0 — без сортировки; •1 — по имени; •2 — по размеру; •3 — по времени. |
Ascending |
BOOL |
Задает направление сортировки для поля, выбранного в SortBy, где TRUE — по возрастанию, FALSE — по убыванию. |
FoldersFirst |
BOOL |
Определяет приоритетное расположение папок относительно файлов в отсортированном списке, где TRUE — папки в начале списка, FALSE — порядок папок и файлов определяется только правилами сортировки по полю SortBy. |
Выходы |
||
ErrorText |
STRING |
Выдается текст ошибки, если не удалось сформировать список. |
Files |
ARRAY [*] OF FileInfo |
Выдается описание по каждому добавленному файлу или папки в список. Выход представляет собой массив структур. Каждый элемент массива соответствует добавленному файлу или папки. Каждая структура содержит следующие поля: •Name — имя добавленного файла или папки, STRING; •FullName — полное имя добавленного файла или папки с путем до него, STRING; •IsFolder — тип элемента BOOL. Если TRUE, то это папка. Если FALSE, то это файл; •Size — размер файла, LINT; •Time — время последнего изменения, STRING.
|
Вспомогательные типы данных находятся в библиотеке BaseObjects.Типы данных:

Смотрите также:
Вызов функций и функциональных блоков
Ограничения использования функций и ФБ в задаче экрана