Функция ВЫБОР_ФАЙЛА
Функция ВЫБОР_ФАЙЛА показывает на экране стандартный диалог Windows для выбора файлов.
ФУНКЦИЯ СТРОКА: ВЫБОР_ФАЙЛА(СТРОКА: файл = "";
СТРОКА: фильтр = "";
СТРОКА: опции = "";
СТРОКА: заголовок = "")
Параметры
- файл
Начальный выбор файла или начальная папка, содержимое которой будет отображено. Если задан абсолютный путь к папке, то эта папка становится начальной, если задан абсолютный путь к файлу, то его имя и расширение помещаются в поле выбора и отображается содержимое соответствующей папки. Если параметр не указан или равен пустой строке, то начальная папка выбирается по правилам оболочки Windows в зависимости от версии: диалог может отобразить папку "Мои документы", последнюю папку, в которой открывались файлы данного типа или какую-либо другую папку.
- фильтр
Позволяет задать несколько категорий файлов соответствующих им расширений. Категории разделяются запятой, а текст и маска – двоеточием. Если для одной категории файлов надо задать несколько расширений, то расширения перечисляются через точку с запятой. Пример фильтра:
"Текстовые файлы:*.txt,Картинки:*.bmp;*.jpg,Все файлы:*.*"
Когда фильтр не задан, то используется фильтр по умолчанию:
"Все файлы:*.*"
.- опции
Опции позволяют настроить режим работы диалога. По умолчанию диалог работает в режиме открытия файла, предполагается, что файл должен существовать. Для изменения режима работы поддерживаются следующие опции:
S – режим сохранения файла; N – допускает ввод имени нового (не существующего) файла (только в режиме открытия); С – запрос на создание нового файла (только в режиме открытия); W – запрос на перезапись существующего файла (только в режиме сохранения). Пример опций: "SW" – запрашиваем имя файла для сохранения с запросом на перезапись существующего.
- заголовок
- Текст заголовка окна выбора файла.
Возвращаемое значение
Если пользователь нажимает кнопку ОК – функция возвращает имя выбранного файла, если кнопку Отмена – пустую строку.
Пример:
файл = ВЫБОР_ФАЙЛА ( "default.txt", "Текстовые файлы:*.txt" )
ЕСЛИ файл <> "" ТО
СООБЩЕНИЕ ( "Выбран файл " + файл )
ИНАЧЕ
СООБЩЕНИЕ ( "Файл выбран не был" )
КОНЕЦ_ЕСЛИ