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

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

ФУНКЦИЯ ТИП_СТРОКА: АТРИБУТ(ТИП_СТРОКА: имя_атрибута)

Параметры

имя_атрибута

В настоящий момент реализована поддержка следующих атрибутов: файл, название, раздел, многоуровневые разделы, альтернативные разделы, plug, exe, заголовок окна и многие другие (см. ниже).

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

В зависимости от указанного атрибута возможны следующие значения:

файл

Имя файла бланка, типовой операции, исходного текста или "" для функций, запущенных из меню, калькулятора и т.п

название

Описательное название исполняющего механизма. Для бланка – название бланка, для типовой операции – полное имя типовой операции, для калькулятора – "Калькулятор" и т.д.

файл_бланка

Имя файла ассоцированного бланка, для остальных случаев "".

раздел

Имя раздела ассоцированного бланка, для остальных случаев "".

многоуровневые разделы, альтернативные разделы

Если указанный режим включен в настройках программы, то функция АТРИБУТ возвращает ДА, иначе НЕТ. Тип возвращаемого значения – строковый.

mode

Режим выполнения кода внутреннего языка, из которого происходит вызов функции АТРИБУТ:
"IBX" – откомпилированный код, "INTERPRETER" – интерпретатор.

plug

Полное имя текущего электронного ключа, включая номер.

plug_request

Код вопроса для текущего электронного ключа и регистрации.

exe

Полный путь к текущему исполняемому файлу Инфо-Бухгалтера.

common_path

Полный путь к общей папке, указанной в файле deploy.ini. Если общая папка не задана, то возвращает то же, что функция ТЕК_ДИР.

ui_config_path

Полный путь к папке конфигурации UI, содержащий файлы IBMENU.INI, IBTBAR.INI и т.п. Папка может указываться в файле deploy.ini.

ui_images_path

Полный путь к папке картинок панели инструментов. Папка может указываться в файле deploy.ini.

blanks_images_path

Полный путь к папке картинок для бланков. Папка может указываться в файле deploy.ini.

opr_path

Полный путь к файлу определений (*.opr). Только в локальной версии.

rek_path

Полный путь к файлу реквизитов (*.rek). Только в локальной версии.

cfg_path

Полный путь к файлу CFG.

BDE

Если использование BDE отключено параметром командной строки /NOBDE (это возможно только в локальной версии), то функция АТРИБУТ возвращает НЕТ, иначе ДА. Тип возвращаемого значения – строковый.

заголовок окна

Заголовок активного дочернего MDI окна или пустая строка, если нет активного окна.

доб_заголовок

Добавочный заголовок Главного окна программы.

буфер обмена

Считывает текст из буфера обмена.

http_code

Код ошибки последнего http-запроса. Например, "7" – когда нет подключения к Интернет.

http_response

Код ответа сервера для последнего http-запроса. Например, "404" – когда указанная в URL страница не найдена.

http_error

Текстовое сообщение об ошибке последнего http-запроса.

batch_success

Количество успешно обработанных элементов при пакетной компиляции.

batch_errors

Количество обработанных с ошибками элементов при пакетной компиляции.

batch_skip

Количество пропущенных элементов при пакетной минимальной компиляции.

last_error

Позволяет получить текст последней не фатальной ошибки. Атрибут устанавливается некоторыми функциями или вручную.

custom_dlg_action

Позволяет получить текущую команду пользовательского диалога.

next_field

Позволяет получить имя поля, для которого будет вызвано редактирование.

результат_тип_опер

Если в окне типовой операции была нажата кнопка ОК, то функция АТРИБУТ возвращает ДА, иначе (была нажата кнопка Отмена) НЕТ. Тип возвращаемого значения – строковый. При запуске вложенных типовых операций или при вызове ВВЕСТИ в цикле устанавливается результат последнего нажатия.

результат_диалога

Если в диалоговом окне редактирования или выбора была нажата кнопка ОК, то функция АТРИБУТ возвращает ДА, иначе (была нажата кнопка Отмена) НЕТ. Тип возвращаемого значения – строковый. Атрибут используется функциями БД_РЕДАКТОР/БД_ВЫБОР, ВЫБОР (выбор из списка строк), ВВОД_ЗНАЧЕНИЯ и ВВОД_ТЕКСТА.

посл_ред_при_выборе

Если в функции БД_РЕДАКТОР разрешено переключение пользователем режима выбора (доп. параметр перекл_выбор), то при выходе из функции в атрибут помещается значение "ДА" или "НЕТ", в зависимости от последнего значения опции.

посл_ред_столбец

Если в функции БД_РЕДАКТОР разрешено перемещение курсора по столбцам (доп. параметр яч_курсор), то при выходе из функции в атрибут помещается имя выбранного столбца (поля) или "" для столбца номера записи (N).

вывод в окно отладки

Опция отладки из настроек программы. Тип возвращаемого значения – строковый.

вывод в файл отладки

Опция отладки из настроек программы. Тип возвращаемого значения – строковый.

трассировка функций

Опция трассировки из настроек программы. Тип возвращаемого значения – строковый.

трассировка sql

Опция трассировки из настроек программы. Тип возвращаемого значения – строковый.

авто_инд_перем

Глобальная опция компилятора "Автоматическое распознание индексных переменных". Тип возвращаемого значения – строковый.

графы_ввода_общ_перем

Глобальная опция компилятора "Объявлять графы ввода как общие переменные". Тип возвращаемого значения – строковый.

выд_тыс_в_докум

Опция "Выделение тысяч в документах" из настроек программы. Тип возвращаемого значения – строковый.

local_time

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

hwnd_main_dec

Описатель (HWND) Главного окна в десятичной системе.

hwnd_main_hex

Описатель (HWND) Главного окна в шестнадцатеричной системе.

hwnd_popup_dec

Описатель (HWND) активного всплывающего окна в десятичной системе.

hwnd_popup_hex

Описатель (HWND) активного всплывающего окна в шестнадцатеричной системе.

process_id

Целочисленный идентификатор текущего процесса в десятичной системе.

last_child_process_id

Целочисленный идентификатор последнего запущенного дочернего процесса в десятичной системе.

cur_kb_layout

Текущая раскладка клавиатуры в форме: "код, язык (метод ввода)".

def_printer

Имя принтера, выбранного по умолчанию в Windows.

cur_printer

Имя текущего принтера в программе.

continue_export

Логический признак продолжения экспорта бланка стандартными средствами. Тип возвращаемого значения – строковый.

process_admin

"ДА" - процесс Инфо-Бухгалтера обладает администраторскими привилегиями (elevated), иначе "НЕТ".

user_admin

"ДА" - текущий пользователь Windows обладает администраторскими привилегиями (elevated), иначе "НЕТ".

elevation_required

"ДА" - для выполнения из программы Инфо-Бухгалтер действий, требующих администраторскими привилегий, требуется повышение прав (elevation), иначе "НЕТ".

under_wine

"ДА" - программа Инфо-Бухгалтер выполняется под эмулятором Windows в ОС Linux - WINE, иначе "НЕТ".

block1..block8

Имена дополнительных блоков. Доступны во всех версиях, включая демо.

$<имя>

Значение пользовательского атрибута, глобальное для текущего бланка, типовой операции и т.п.

&<имя>

Значение пользовательского атрибута, глобальное для программы.

^<инструкция>

Запросы информации об офисных приложениях для экспорта. Инструкция задается в виде типа запроса и параметров через запятую. Поддерживаются следующие типы запросов:

• DETECT – обнаружение установленного офисного приложения;
• DEFAULT – определение офисного приложения используемого по умолчанию в зависимости от установленных приложений, задачи и расширения файла.

Инструкция DETECT имеет единственный параметр – тег офисного приложения (см. функцию ЭКСПОРТ_ФОРМЫ). Например, инструкция "^DETECT, Excel" выполняет поиск установленного MS Excel. В зависимости от результата поиска функция возвращает "ДА" или "НЕТ".

Инструкция DEFAULT позволяет определить офисное приложение, которое будет использоваться по умолчанию для выполнения задачи и файла. Учитывается совокупность факторов: установленные на компьютере офисные приложения, тип задачи и расширения участвующих в экспорте файлов. Задача и имя файла являются необязательными параметрами. Синтаксис инструкции: "^DEFAULT, <задача>, <имя файла>". Где задача задается одним из следующих обозначений:

"ExportTable"	–	экспорт таблицы;
"FillTemplate"	–	заполнение шаблона документа;
"ExportChart"	–	экспорт графика;
"FillChartTemplate"	–	заполнение шаблона графика;
"Spreadsheet"	–	использование функции ЭЛЕКТРОННАЯ_ТАБЛИЦА.

Задачи определяют тип целевого приложения: электронная таблица или текстовый редактор. Некоторые задачи применимы к обоим типам приложений. Например, заполнение шаблона документа. Если указана пустая строка, то рассматриваются все типы приложений. Имя файла (а точнее - только его расширение) может использоваться как подсказка при выборе офисного приложения. Если указана пустая строка, то отбора по расширению файла не происходит. Например, "^DEFAULT, FillTemplate, *.doc" определит, какое приложение будет использовано для заполнения шаблона в формате doc - MS Excel или OpenOffice.org Writer. Если подходящего приложения не обнаружено, то функция возвращает пустую строку. Когда приложение найдено, то возвращается его имя в верхнем регистре:

"WORD"	–	Microsoft Word;
"EXCEL"	–	Microsoft Excel;
"OPENOFFICE WRITER"	–	OpenOffice.org Writer;
"OPENOFFICE CALC"	–	OpenOffice.org Calc.

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

Замечание

Параметры "http_code", "http_response" и "http_error" имеет смысл использовать после того, как функция HTTP_ЗАПРОС вернула значение НЕТ. Если информации об ошибке последнего http-запроса нет, то для всех параметров "http_..." функция АТРИБУТ возвращает пустую строку.

---

См. также:

• УСТ_АТРИБУТ
• СПИСОК_АТРИБУТОВ
• УСТ_СПИСОК_АТРИБУТОВ
• Найти в содержании
• Встроенные функции
• Язык программирования