SysGetFiles

<< Click to Display Table of Contents >>

Navigation:  Проект в MasterSCADA 4D > Дерево библиотек > Библиотека BaseObjects > BaseObjects.ФБ.Системные > Работа с файлами >

SysGetFiles

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

Важно! Для возможности работы c ФБ SysGetFiles в исполнительную систему должна входить опция MSRT4D-FileWork. Данная опция включена в базовый функционал лицензий Professional и Enterprise.

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

Важно! Данный ФБ не будет будет исполняться в задаче экрана.

Находится в библиотеке BaseObjects.

Вид в дереве

Вид в редакторе FBD

SysGetFiles

SysGetFiles_1

Входы и выходы ФБ:

Название

Тип

Назначение

Входы

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.Типы данных:

SysGetFiles_2

Смотрите также: