Функция ПУТЕВОДИТЕЛЬ

Функция ПУТЕВОДИТЕЛЬ позволяет открыть путеводитель по программе на заданном файле или выполнить встроенную команду по протоколу cmd или ib. Также поддерживается выполнение команд Инфо-Навигатора.

ФУНКЦИЯ ПУТЕВОДИТЕЛЬ(ТИП_СТРОКА: команда)

Параметры

команда

Путь к файлу путеводителя, или встроенная команда по протоколу cmd в формате "cmd:команда", либо по протоколу ib в формате "ib:команда". Для протокола cmd поддерживаются следующие команды:

• back
• forward
• home
• search
• findcont
• content
• index
• new_window[(<команда>)]
• exec
• setvar

Для протокола ib поддерживаются следующие команды:

• function(<библиотека>,<функция>[,<парам. 1> [,<парам. 2> ...]])
• start(<файл ibx>)
• blank(<файл blw>)
• archive(<файл blw>)
• operation(<имя типовой операции>)
• menu(<название пункта меню>:<название пункта меню> ...)
• blanklist(<раздел бланков>)
• operlist(<раздел типовых операций>)
• account(<Название отчета>,<код счета>)
• chart(<название графика>)
• help(<справка>)
• edit(<файл>[,<доп. параметры>])

Также может указываться команда Инфо-Навигатора, которая будет выполнена в окне путеводителя. Команда Инфо-Навигатора начинается с символа "*" (звездочка).

Замечания:

• Для команды function поддерживается передача функции параметров строкового типа. Параметры указываются после имени функции без кавычек.
• Для команды menu в названиях пунктов меню игнорируется ... (троеточие) и комбинация клавиш.
• Для команды account названия отчетов соответствуют заголовкам окон:
  • Движения средств.
  • Оборотная ведомость.
  • Ведомость остатков.
  • План счетов.
  • Исходные остатки.
• Для команды help параметр <справка> может быть как командой Инфо-Навигатора, так и именем файла справки в формате WinHelp (*.hlp) или HtmlHelp (*.chm). С помощью ib:help команда Инфо-Навигатора выполняется в окне справочной системы, а не в окне путеводителя.
• Для команды edit возможно задание до 4-х дополнительных параметров через запятую. Для не текстовых файлов дополнительные параметры игнорируются. Первый параметр соответствует номеру строки. Вместо номера строки может указываться EOF для позиционирования на последнюю строку. Второй параметр может задавать номер столбца или опцию. Третий и четвертый параметр могут содержать только опции. Порядок указания опций не важен. Поддерживаются следующие опции:
  • ANSI – использовать кодировку ANSI/WIN;
  • OEM – использовать кодировку OEM/DOS;
  • PASTE – выполнять команду "Вставить" после позиционирования.
  Кодировку следует указывать при открытии на редактирование произвольных файлов (не IBL, SRC, TOP, BLW). Если кодировка не указана, то используется ANSI/WIN.

Пример использования

// открывается файл по умолчанию "docs\guide\ib8\index.html"
ПУТЕВОДИТЕЛЬ("")
// открывается файл "docs\guide\ib8\menu.html"
ПУТЕВОДИТЕЛЬ("menu.html")
// открывается файл "docs\guide\ib8\blanks\pp.html"
ПУТЕВОДИТЕЛЬ("blanks\pp.html")
// выполняется встроенная команда back
ПУТЕВОДИТЕЛЬ("cmd:back")
ПУТЕВОДИТЕЛЬ("ib:function(somelib.ibl, функцияАБСД)")
ПУТЕВОДИТЕЛЬ("ib:function(somelib.ibl, функцияСПарам, Парам1, Парам2)")
ПУТЕВОДИТЕЛЬ("ib:menu(Операции: Фильтр)")
ПУТЕВОДИТЕЛЬ("ib:operation(Касса: сдача в банк)")
// открывает справку по ключевому слову ОБД в окне путеводителя
ПУТЕВОДИТЕЛЬ("*keyword=ОБД")
// открывает справку по ключевому слову ОБК в окне справочной системы
ПУТЕВОДИТЕЛЬ("ib:help(*keyword=ОБК)")
// открывает бланк balance.blw на редактирование
ПУТЕВОДИТЕЛЬ("ib:edit(balance.blw)")
// открывает формульный раздел бланка balance.blw на редактирование на строке 42
ПУТЕВОДИТЕЛЬ("ib:edit(balance.blw,42)")
// открывает текстовый файл dostext.txt в кодировке OEM на последней строке
ПУТЕВОДИТЕЛЬ("ib:edit(dostext.txt,EOF,OEM)")
// открывает библиотеку utils.ibl на строке 1234 и колонке 17,
// вставляет туда текст из буфера обмена
ПУТЕВОДИТЕЛЬ("ib:edit(utils.ibl,1234,17,PASTE)")

---

См. также:

• Найти в содержании
• Встроенные функции
• Язык программирования