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

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

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

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

Параметры

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

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

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

Замечание

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


См. также: