Difference between revisions of "Text.Show"

From SunFlurry wiki
Jump to: navigation, search
(Created page with "{{infobox function |name=Show |object=Текст |caption=Вывод текста на экран |type=1 |status=2 |db=0 |exception=Невозможно преврати...")
 
m (1 revision imported)
(No difference)

Revision as of 08:54, 7 February 2021

  Show (Вывод текста на экран)
Объект:Текст
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в строку, число
Визуальность:Нет

Функция отображает содержимое текущего объекта в виде окна с текстом. Задается также заголовок окна, наименование файла по умолчанию при попытке пользователя сохранить текст и т.п. Возможно также задание кода, который будет исполняться при попытке пользователя сохранить текст на диск. Код, к примеру, может вызвать функцию записи, чтобы сохранить файл в реквизиты объекта базы данных.

Синтаксис

Text.Show(<Заголовок окна (STRING)>,<Наименование файла по умолчанию (STRING)>,<Режим просмотра (INT)>=0,<Фокусироваться на окне в момент вывода (INT)>=1,<Код, исполняемый вместо стандартного кода сохранения файла на диск (STRING)>)

Аргументы

  • <Заголовок окна (STRING)> - (необязательный аргумент) Заголовок окна, в котором будет отображен текст.
  • <Наименование файла по умолчанию (STRING)> - (необязательный аргумент) Наименование файла по умолчанию при попытке пользователя сохранить текст на диск.
  • <Режим просмотра (INT)> - (необязательный аргумент) 1 -- для просмотра файла (редактирование будет недоступно), 1 -- для редактирования файла (по умолчанию).
  • <Фокусироваться на окне в момент вывода (INT)> - (необязательный аргумент) 1 -- окно с текстом получит фокус сразу после вывода (по умолчанию), 0 -- окно с текстом будет выведено "в фоне", текущее активное окно останется активным.
  • <Код, исполняемый вместо стандартного кода сохранения файла на диск (STRING)> - (необязательный аргумент) При задании этого аргумента при попытке сохранения окна с текстом, будет выполнена программа, заданная этим аргументом. Фактическое сохранение выполнено не будет. Программа может сохранить текст не обычным образом (к примеру, на web-страницу).

Примеры

//В примере показано, как редактировать файл, находящийся в определенном месте, чтобы пользователь не имел возможности сохранить его в другое место
Var ТФайл Export;

  Function ОбновитьФайлПозиций()
    If not isEmpty(ТФайл) Then
      Файл:="Temp\ФайлСОбщимДоступом.txt";
      ТФайл.Save(Файл,1200,1);
    EndIf;
  EndFunction


ТФайл:=Text.Create(1);
Файл:="Temp\ФайлСОбщимДоступом.txt";
If File.DoesFileExist(Файл) Then
  ТФайл.Load(Файл,0);
Else
  ТФайл.AddString(";Каждая позиция задается в одной строке в формате: "+_NEWLINE+
    ";<Имя позиции>:<Имя компонента 1>*<Количество>,<Имя компонента 2>*<Количество>..."+_NEWLINE+
    ";Пример:"+_NEWLINE+
    ";pos0001:nom002*24,mon003*60,mon015*18");
EndIf;  
ТФайл.Show("Настройки позиций",Файл,0,1,"ОбновитьФайлПозиций();");