Основы языка формул. Синтаксис и лексические элементы формул, страница 15

Аргумент

Результат

[ОК]

Отображаент простое окно с сообщением и олной кнопкой OK

[YesNo]

Отображает окно с двумя кнопками Yes и No

[YesNoCancel]

Отображает окно с тремя кнопками Yes, No и Cancel

[OKCancelEdit]

Отображает окно ввода с кнопками ОК и Cancel

[OKCancelList]

Отображает окно, содержащее список, из которого можно выбрать одно значение

[OKCancelCombo]

Отображает окно с раскрывающимся списком, из которого можно выбрать одно значение

[OKCancelEditCombo]

Отображает окно с раскрывающимся списком, из которого можно выбрать одно значение, а также позволяет пользователю ввести новое значение

[OKCancelListMult]

Отображает окно, содержащее список, из которого можно выбрать более одного значения

[LocalBrowse]

Отображает выбираемый список файлов, расположенных на локальном жестком диске

[Password]

Позволяет пользователю ввести пароль безопасным способом

Ниже приводится пример кода из программы-агента с установленным параметром Manually from Agent List, которая запускается с помощью кнопки в представлении Done (Готово). В этом примере демонстрируется как функция @Prompt() может использоваться для получения информации от пользователя и занесения этой информации в документ:

RЕМ   "Найти   сколько   времени   (часов)    это   занимает";

jnHours    :=  @Prompt([OKCANCELEDIT];    "Effort";

"Please   enter   the   number   of   hours.";   0);

@If (jnHours   =   0;   @Return("");   gSuccess);

FIELD  nActual   :=   jnHours;

FIELD   cStatus    :=   "Completed";

FIELD  dComplete   :=   @Today

Для ввода информации с помощью функции @DialogBox необходимо, чтобы исходный (базовый) документ находился в режиме редактирования. Функция @DiaIogBox имеет несколько параметров, которые определяют будет ли она отображать информацию, будет ли запоминать ее в документе и то, будут ли разрешены записи для новых полей. Можно также задать заголовок диалогового окна. Функция @DialogBox имеет следующие параметры:

@DialogBox (имяформа ; [AutoHorzFit] : [AutoVertFit] : [NoCancel] :

[NoNewFields] : [NoFieldUpdate] : [Readonly] ; SizeToTable ;

NoOkCancel ; title)

Если в форме имеется область компоновки, то лучше всего использовать как параметр [AutoHorzFit], так и [AutoVertFit]. Если требуется только отображать содержимое поля или полей, то применяется параметр [ReadOnly]. Включение параметра [NoCancel] означает, что в диалоговом окне будет присутствовать только кнопка ОК. Параметры [NoNewFields] и [NoFieldUpdate] контролируют, каким образом диалоговое окно взаимодействует с полями базового документа. Параметр [NoNewFields] дает возможность использовать в диалоговом окне поля, отсутствующие в документе. Когда диалоговое окно закрывается, эти поля не сохраняются в документе. Параметр [NoFieldUpdate] предотвращает запись в исходный документ изменений, сделанных в полях диалогового окна. Параметры SizeToTable и NoOkCancel — это новые параметры, появившиеся в версии Lotus Notes R5. Параметр SizeToTable определяет размер таблицы в диалоговом окне, а параметр NoOkCancel означает, что в диалоговом окне отсутствуют кнопки ОК и Cancel. Параметр Title определяет название диалогового окна и его следует применять всегда. Если параметр Title опущен, в области заголовка диалогового окна отображается название "Lotus Notes". Все параметры являются необязательными, за исключением параметра имя формы.

ИСПОЛЬЗОВАНИЕ ПОДЧИНЕННОЙ ФОРМЫ

Для функции @DialogBox не обязательно создавать полностью законченную форму. Область компоновки можно создать в подчиненной форме и назвать ее так же, как и исходную форму. Чтобы отличать форму или подчиненную форму от других форм или подчиненных форм, к ее имени следует добавить префикс.