SysGetFiles

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

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