Тип: Строка. Содержит полное имя файла, которое будет использоваться при сохранении текстового документа пользователем. Данное свойство будет заполняться: 1. при программной установке значения; 2. при интерактивном открытии документа из файла; 3. при вызове метода Показать, если в нем указано имя файла; 4. при вызове пользователем команды "Сохранить как…".
Полное описание, параметры и ограничения
ТекстовыйДокумент.ИспользуемоеИмяФайла (TextDocument.UsedFileName)
ТекстовыйДокумент (TextDocument)
ИспользуемоеИмяФайла (UsedFileName)
Доступен, начиная с версии 8.1.
Использование:
Чтение и запись.
Описание:
Тип: Строка.
Содержит полное имя файла, которое будет использоваться при сохранении текстового документа пользователем.
Данное свойство будет заполняться:
1. при программной установке значения;
2. при интерактивном открытии документа из файла;
3. при вызове метода Показать, если в нем указано имя файла;
4. при вызове пользователем команды "Сохранить как…".
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Открыть учебную памятку только для просмотра и отличить имя сохранения от файла
Клиентская команда показывает новую памятку, запрещает редактирование/вывод и отдельно проверяет, что назначение ИспользуемоеИмяФайла не создало файл.
Где и как запускать
Модуль пустой управляемой формы учебной внешней обработки; тонкий или толстый клиент Windows. Вставьте весь модуль. Это не серверный код.
Подготовка
Создайте учебную внешнюю обработку с пустой управляемой основной формой. Создайте команду УчебныйПример и кнопку этой команды.
В свойстве команды Действие выберите процедуру УчебныйПример. Вставьте полный приведённый модуль формы.
Откройте EPF в тонком или толстом клиенте Windows и нажмите кнопку. Не переносите Ждать и Асинх в серверный общий модуль.
Пример работает только со своими данными в памяти; записи в базу, файлы и сеть нет.
&НаКлиенте
Процедура УчебныйПример(Команда)
Документ = Новый ТекстовыйДокумент;
Документ.УстановитьТекст("Учебная памятка" + Символы.ПС + "Книга: 3 × 250 = 750 руб.");
Документ.ТолькоПросмотр = Истина;
Документ.Вывод = ИспользованиеВывода.Запретить;
ПредлагаемоеИмя = ПолучитьИмяВременногоФайла("txt");
Документ.ИспользуемоеИмяФайла = ПредлагаемоеИмя;
ФайлПроверки = Новый Файл(ПредлагаемоеИмя);
Сообщить(Документ.ТолькоПросмотр);
Сообщить(Документ.Вывод = ИспользованиеВывода.Запретить);
Сообщить(Документ.ИспользуемоеИмяФайла = ПредлагаемоеИмя);
Сообщить(Не ФайлПроверки.Существует());
Документ.Показать("Учебная памятка — без записи на диск");
КонецПроцедурыРазбор по шагам
Документ — локальная переменная команды, не реквизит формы. Для реквизита формы Показать вызвал бы исключение.
ТолькоПросмотр ограничивает интерактивное редактирование. Вывод=Запретить задаёт ограничение печати, сохранения и работы с буфером обмена.
ИспользуемоеИмяФайла — имя, которое используется при пользовательском сохранении. Само присваивание не вызывает Записать.
Проверяем отсутствие по этому имени ДО Показать и открываем отдельное окно просмотра без второго аргумента имени файла.
Закройте окно после визуальной проверки; в задаче нет программного сохранения или печати.
Как проверить результат
Четыре сообщения Истина; окно содержит заголовок и итог 750 руб.
Попытка редактировать текст не меняет содержимое; команды вывода ограничены согласно настройке.
Проверка файла подтверждает отсутствие записи при присваивании имени, не поведение любых последующих пользовательских действий.
Ожидаемый результат
Открыта самостоятельная памятка с явно разделёнными режимом просмотра, политикой вывода и рекомендуемым именем.
На что обратить внимание
Ограничение Вывод не является криптографической защитой информации от снимков экрана или других каналов.
ТолькоПросмотр не запрещает программное изменение объекта встроенным языком.
Если разрешить вывод или изменить настройки, пользовательское сохранение — отдельное действие и может создать файл.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.