Руководство разработчика

Функция УСТ_АТРИБУТ

Функция УСТ_АТРИБУТ изменяет значения атрибутов отображения списка бланков, название выполняемого кода внутреннего языка, а также пользовательские атрибуты.

ФУНКЦИЯ ТИП_ЛОГИКА: УСТ_АТРИБУТ(ТИП_СТРОКА: имя_атрибута, значение)

Параметры

имя_атрибута
В настоящий момент реализована поддержка следующих атрибутов:
  • многоуровневые разделы – логический признак использования многоуровневых разделов;
  • альтернативные разделы – логический признак использования альтернативных разделов;
  • название – строка названия, ассоциированная с выполняемым кодом;
  • строг – дата строгого ограничения. Для отключения использования даты строгого ограничения указывается "01.01.1900".
  • доб_заголовок – добавочный заголовок Главного окна программы.
  • буфер обмена – записывает текст в буфер обмена.
  • last_error – вручную устанавливает текст последней не фатальной ошибки.
  • insert_text – вставляет фрагмент текста в активное окно текстового редактора в позиции каретки.
  • custom_dlg_action – устанавливает команду пользовательского диалога. При создании нового элемента поддерживается команда "repeat" – создание еще одного элемента. При редактировании существующего элемента поддерживаются команды "first", "next", "prev" и "last" – переход к редактированию другого элемента. Команда "continue" позволяет показать стандартный диалог редактирования записи после или вместо пользовательского.
  • next_field – Позволяет указать имя поля, для которого будет вызвано редактирование. Может задаваться в обработчиках полей текущей записи для перехода к редактированию произвольного поля вместо следующего по порядку.
  • cur_kb_layout – изменяет текущую раскладку клавиатуры. Раскладка задается в форме: "код, язык (метод ввода)" или только "код".
  • cur_printer – изменяет текущий принтер в программе. Указывается имя принтера. Если указанного принтера не найдено, то функция возвращает НЕТ. Если указана пустая строка, то выбирается принтер по умолчанию Windows.
  • continue_export – логический признак продолжения экспорта бланка стандартными средствами.
  • вывод в окно отладки – опция отладки из настроек программы.
  • вывод в файл отладки – опция отладки из настроек программы.
  • трассировка функций – опция трассировки из настроек программы.
  • трассировка sql – опция трассировки из настроек программы.
  • авто_инд_перем – глобальная опция компилятора "Автоматическое распознание индексных переменных".
  • графы_ввода_общ_перем – глобальная опция компилятора "Объявлять графы ввода как общие переменные".
  • выд_тыс_в_докум – опция "Выделение тысяч в документах" из настроек программы.
  • $<имя> – пользовательский атрибут, глобальный для текущего бланка, типовой операции и т.п.
  • &<имя> – пользовательский атрибут, глобальный для программы.
значение
Значение атрибута. Для логических значений указывается ДА или НЕТ в строковом виде, для дат – дата в строковом виде. Для пользовательских атрибутов указание пустой строки приводит к удалению существующего атрибута.

Возвращаемое значение

Если указанный атрибут не поддерживается текущим исполняющим механизмом, функция возвращает НЕТ.

Замечание

При изменении названия не происходит сохранения изменений в файл. Изменения носят временный характер, до завершения выполнения кода внутреннего языка. В случае бланка изменененное название отображаются также в заголовке окна.


См. также: