Глава 37 Работа с Файлами
Открывает окно диалога выбора/сохранения файла картинки.
Синтаксис:
ВыбратьФайлКартинки(ТипДиалога, ИмяФайла, ИмяНачКаталога,
3аголовокОкна,
Расширение, Таймаут)
Англоязычный синоним:
SelectPictFile
Параметры:
|
ТипДиалога |
Числовое выражение, значение которого определяет тип открываемого диалога.
Допустимые значения: 0 — диалог типа «открыть», 1 — диалог типа «сохранить». |
|
ИмяФайла |
Имя переменной, содержащей строковое значение с именем файла. В эту же
переменную система возвращает имя выбранного файла. |
|
ИмяНачКаталога |
Имя переменной, содержащей строковое значение с именем начального каталога.
В эту же переменную система возвращает имя выбранного каталога. |
|
3аголовокОкна |
Строковое выражение, с помощью которого можно задать заголовок открываемого
окна. |
|
Расширение |
Строковое выражение, с помощью которого можно задать расширение файла
по умолчанию, которое используется системой при записи файла. |
|
Таймаут |
Необязательный параметр. Числовое выражение, значение которого задает
время ожидания системы (в секундах) на отклик пользователя. |
Возвращаемое значение:
Число: 0 — если в окне диалога нажата кнопка «Отмена»; 1 — если в окне диалога
нажата кнопка «ОК», при этом в переменную ИмяФайла
возвращается выбранное имя файла, а в переменную ИмяНачКаталога
возвращается имя выбранного каталога; -1 (минус единица) — закончилось время
Таймаут
ожидания отклика пользователя.
Описание:
Метод ВыбратьФайлКартинки открывает окно диалога (с
возможностью предварительного просмотра) выбора/сохранения файла картинки.
Пример:
* В данном примере приведена процедура вызова диалога выбора файла картинки.
// Фото — Объект типа Картинка
Процедура ЗагрКарт()
ИмяВыбрФайла = ;
ИмяПути = ;
// Выбор файла с просмотром
Если ФС.ВыбратьФайлКартинки(0, ИмяВыбрФайла, ИмяПути,
Выберите файл, bmp, ) = 1
Тогда
Фото.Загрузить(ИмяПути + ИмяВыбрФайла);
КонецЕсли;
КонецПроцедуры
Открывает окно диалога выбора каталога.
Синтаксис:
ВыбратьКаталог(ИмяКаталога, 3аголовок, Таймаут)
Англоязычный синоним:
SelectDirectory
Параметры:
|
ИмяКаталога |
Имя переменной, содержащей строковое значение с именем начального каталога.
В эту же переменную система возвращает имя выбранного каталога. |
|
3аголовок |
Строковое выражение, с помощью которого можно задать заголовок открываемого
окна. |
|
Таймаут |
Необязательный параметр. Числовое выражение, значение которого задает
время ожидания системы (в секундах) на отклик пользователя. |
Возвращаемое значение:
Число: 0 — если в окне диалога нажата кнопка «Отмена»; 1 — если в окне диалога
нажата кнопка «ОК», при этом в переменную ИмяНачКаталога
возвращается имя выбранного каталога; -1 (минус единица) — закончилось время
Таймаут
ожидания отклика пользователя.
Описание:
Метод ВыбратьКаталог открывает окно диалога выбора
каталога.
Пример:
* В данном примере приведена процедура вызова диалога выбора каталога.
Функция УстКат(ИмяПути)
Если ФС.ВыбратьКаталог(ИмяПути, Выберите каталог,
10) = 1 Тогда
Возврат ИмяПути;
Иначе
Возврат КаталогПользователя();
КонецЕсли;
КонецПроцедуры
Проверяет существование файла.
Синтаксис:
Существуетфайл(ИмяФайла)
Англоязычный синоним:
ExistFile
Параметры:
|
ИмяФайла |
Строковое выражение с именем файла. |
Возвращаемое значение:
Число: 1 — файл существует; 0 — не существует.
Описание:
Метод СуществуетФайл проверяет существование файла.
Пример:
Процедура СущФ(ИмяФайла)
Если ФС.СуществуетФайл(ИмяФайла) = 1 Тогда
Сообщить(Файл + ИмяФайла + — существует);
КонецЕсли;
КонецПроцедуры
Копирует файл.
Синтаксис:
КопироватьФайл(ИмяФайлаИсточника, ИмяФайлаПриемника,
ФлагОтказаПерезаписи)
Англоязычный синоним:
FileCopy
Параметры:
|
ИмяФайлаИсточника |
Строковое выражение с именем файла источника. |
|
ИмяФайлаПриемника |
Строковое выражение с именем файла приемника. |
|
ФлагОтказаПерезаписи |
Числовое выражение: 0 — при существовании файла приемника заменяет его
на копируемый; 1 — при существовании файла приемника копирования не производится. |
Описание:
Метод КопироватьФайл копирует файл-источник в файл-приемник.
Пример:
* В данном примере приведена процедура копирования файла.
Процедура КопирФ()
ФС.КопироватьФайл(ИмяВыбрФайла, ФПриемник, 1);
КонецПроцедуры
Удалить файл.
Синтаксис:
УдалитьФайл(ИмяФайла)
Англоязычный синоним:
DeleteFile
Параметры:
|
ИмяФайла |
Строковое выражение с именем удаляемого файла. |
Описание:
Метод УдалитьФайл удаляет указанный файл.
Пример:
* В данном примере приведена процедура удаления файла.
Процедура УдалФ()
ФС.УдалитьФайл(ИмяФайла);
КонецПроцедуры
Переименовать файл.
Синтаксис:
ПереименоватьФайл(ИмяФайлаИсточника, ИмяФайлаПриемника,
ФлагПерезаписи)
Англоязычный синоним:
MoveFile
Параметры:
|
ИмяФайлаИсточника |
Строковое выражение с именем файла источника. |
|
ИмяФайлаПриемника |
Строковое выражение с требуемым именем файла. |
|
ФлагПерезаписи |
Числовое выражение: 0 — запрещает перемещение файла между дисками и при
существовании файла приемника копирования не производится; 1 — разрешает
перемещение файла (только для файлов) между дисками и при существовании
файла приемника замещает его на копируемый. |
Описание:
Метод ПереименоватьФайл выполняет переименование (перемещение)
указанного файла.
Пример:
* В данном примере приведена процедура переименования файла.
Процедура ПереимФ()
ФС.ПереименоватьФайл(Результат, ФПриемник, 1);
КонецПроцедуры
Открывает выборку файлов по заданной маске и находит первый файл.
Синтаксис:
НайтиПервыйФайл(МаскаИмени)
Англоязычный синоним:
FindFirstFile
Параметры:
|
МаскаИмени |
Строковое выражение с маской имен файлов. В строке маски можно использовать
символ *, что означает наличие любого числа произвольных символов.
Символ ? в строке маски означает наличие одного произвольного
символа. |
Возвращаемое значение:
Строка с именем найденного файла.
Описание:
Метод НайтиПервыйФайл находит первый файл и открывает
выборку файлов по заданной маске.
Замечание. Методы НайтиПервыйФайл и НайтиСледующийФайл
возвращают имена файлов в той же последовательности, как это делает команда
Dir операционной системы MS DOS, т. е. если задана маска *.*для некорневого
каталога, первым возвращаемым значением будет . — обозначающая ссылку
на текущий каталог. Имя следующего файла будет .. — обозначающее
ссылку на каталог уровнем выше. При получении следующих файлов возвращаемым
значением будет имя найденного файла.
Пример:
* В данном примере приведена процедура открытия выборки файлов по заданной
маске.
Процедура ПервФ()
Результат = ФС.НайтиПервыйФайл(*.*);
КонецПроцедуры
См. также: НайтиСледующийФайл
Находит следующий файл по открытой выборке файлов.
Синтаксис:
НайтиСледующийФайл()
Англоязычный синоним:
FindNextFile
Возвращаемое значение:
Строка с именем найденного файла.
Описание:
Метод НайтиСледующийФайл находит следующий файл по
открытой выборке файлов.
Пример:
* В данном примере приведена процедура взятия следующего файла выборки файлов.
Процедура СледФ()
Результат = ФС.НайтиСледующийФайл();
КонецПроцедуры
См. также: НайтиПервыйФайл
Возвращает атрибуты файла.
Синтаксис:
АтрибутыФайла(ИмяФайла, РазмерФайла , АтрибутыФайла,
ВремяСоздания,
ВремяПоследнДоступа, ВремяПоследнЗаписи,
РасширенноеИмяФайла)
Англоязычный синоним:
GetFileAttr
Параметры:
|
ИмяФайла |
Строковое выражение с именем файла. |
|
РазмерФайла |
Возвращаемое Числовое значение размера файла в байтах. |
|
АтрибутыФайла |
Возвращаемое строковое значение длиной 9 символов, в котором закодированы
атрибуты файла. Символы могут принимать значения 0 или 1:
Первый символ: если 1 — файл только для чтения;
Второй символ: если 1 — скрытый файл;
Третий символ: если 1 — системный файл;
Четвертый символ: если 1 — каталог;
Пятый символ: если 1 — архивный файл;
Шестой символ: если 1 — обычный файл (все другие атрибуты
не установлены);
Седьмой символ: если 1 — временный файл;
Восьмой символ: если 1 — файл, сжатый каким-либо архиватором;
Девятый символ: если 1 — нет доступа к файлу.
Для проверки атрибута можно применять выражение:
Цел(ПолученныйАтрибут/КодАтрибута)/2
где кодАтрибута — 1/2/4/16/32...
это выражение возвращает 1 или 0, в зависимости от того, установлен атрибут
или нет. |
|
ВремяСоздания |
Возвращаемое строковое значение, содержащее дату и время создания файла. |
|
ВремяПоследнДоступа |
Возвращаемое строковое значение, содержащее дату и время последнего доступа
к файлу. |
|
ВремяПоследнЗаписи |
Возвращаемое строковое значение, содержащее дату и время последней записи
файла. |
|
РасширенноеИмяФайла |
Возвращаемое строковое значение, содержащее полное имя файла. |
Описание:
Метод АтрибутыФайла считывает атрибуты файла и записывает
их значения в передаваемые параметры.
Пример:
* В данном примере приведена процедура считывания атрибутов файла.,
Лроцедура АттрФ()
ФС.АтрибутыФайла(ИмяВыбрФайла, A, B, C, D, E, F);
КонецПроцедуры
Создает новый каталог файлов.
Синтаксис:
СоздатьКаталог(ИмяКат)
Англоязычный синоним:
CreateDirectory
Параметры:
|
ИмяКат |
Строковое выражение с именем создаваемого каталога. |
Описание:
Метод СоздатьКаталог создает новый каталог файлов.
Пример:
* В данном примере приведена процедура создания нового каталога файлов.
Процедура СоздДир()
ФС.СоздатьКаталог(ИмяВыбрДир);
КонецПроцедуры
Удаляет каталог файлов.
Синтаксис:
УдалитьКаталог(ИмяКат)
Англоязычный синоним:
RemoveDirectory
Параметры:
ИмяКат Строковое выражение с именем удаляемого
каталога файлов.
Описание:
Метод УдалитьКаталог удаляет каталог файлов.
Пример:
* В данном примере приведена процедура удаления каталога файлов.
Процедура УдалДир()
ФС.УдалитьКаталог(ИмяВыбрДир);
КонецПроцедуры
Устанавливает текущий каталог файлов.
Синтаксис:
УстТекКаталог(ИмяКат)
Англоязычный синоним:
GetCurrentDirectory
Параметры:
|
ИмяКат |
Строковое выражение с именем текущего каталога файлов. |
Описание:
Метод УстТекКаталог устанавливает текущий каталог файлов.
Пример:
* В данном примере приведена процедура установки текущего каталога файлов
Процедура УстТекДир()
ФС.УстТекКаталог(ИмяВыбрДир);
КонецПроцедуры
См. также: ТекКаталог
Возвращает текущий каталог файлов.
Синтаксис:
ТекКаталог()
Англоязычный синоним:
GetCurrentDirectory
Возвращаемое значение:
Строковое значение имени текущего каталога файлов.
Описание:
Метод ТекКаталог возвращает строковое значение имени
текущего каталога файлов.
Пример:
ТекКат = ФС.ТекКаталог();
См. также: УстТекКаталог
Возвращает имя Windows директории.
Синтаксис:
WindowsКаталог()
Англоязычный синоним:
GetWindowsDirectory
Возвращаемое значение:
Строковое значение — имя Windows директории.
Описание:
Метод WindowsКаталог возвращает имя Windows
директории.
Пример:
WinKaT = ФC.WindowsКаталог();
Определить размер свободного дискового пространства.
Синтаксис:
СвободноеМестоНаДиске(ИмяДиска)
Англоязычный синоним:
GetDiskFreeSpace
Параметры:
|
ИмяДиска |
Строковое выражение с именем диска. |
Возвращаемое значение:
Численое значение — размер свободного дискового пространства в байтах.
Описание:
Метод СвободноеМестоНаДиске возвращает численое значение
размера
свободного дискового пространства.
Пример:
* В данном примере приведена процедура определения свободного дискового пространства
диска С:
Процедура РазмД()
Рез = ФС.СвободноеМестоНаДиске(С:);
КонецПроцедуры
Содержание раздела
