43. Назначение и синтаксис операторов Messagebox, Print, Inputbox, Dialogbox.

Пожалуй, самым употребляемым оператором для взаимодействия с пользователями является Messagebox. Указанная команда предлагает множество опций, которые могут использоваться в интерфейсе с конечным пользователем. Вот ее синтаксис:

MessageBox сообщение , опции , заголовок

сообщение - любая текстовая строка (включая ссылки, переменные и константы).

опции - предназначены для настройки кнопок, значков, режима отобра-

жения и «выбранной» кнопки по умолчанию. Не являются обя­зательными.

заголовок - служит для задания заголовка всплывающего окна. Не является обязательным.

В простейшем виде оператор используется для вывода всплывающих сообще­ний (см. рис. 6.3). Например, следующая команда выводит текстовую строку с те­кущей датой и временем.

Messagebox "The current date and time is: " + Now

The current date and time is: 8/24/2005 10:27:32 AM

OK

Рис. 6.3. Пример окна Messagebox

Однако этот оператор способен принимать и дополнительные параметры, поз­воляющие настроить представление всплывающих сообщений. Впрочем, прежде чем перейти к опциям настройки отображения, вы можете добавить к этому окну заголовок. Заголовок - это третий параметр, которым должна являться текстовая строка, не превышающая 128 символов. Обратите внимание, что на рис. 6.4 второй параметр не указан, поэтому в строке кода встречаются две запятые.

Messagebox "The date and time is: " + Now ,, "Today's Date"

Теперь в окно сообщения можно добавить графику, изменить кнопки, задать кноп­ку по умолчанию. Все это осуществляет второй параметр, который должен быть допустимым значением, равным сумме одного или нескольких значений опций оператора Messagebox.

Оператор Print

Другой способ взаимодействия с пользователем представлен оператором Print. Здесь вместо вывода сообщений в виде всплывающего окна отображаемый текст появляется в строке состояния (Status Bar) в нижней части клиента Lotus Notes. Синтаксически команда Print такова:

Print строка

строка - произвольная текстовая строка, переменная, дата, время или список значений, разделенных пробелами, точками с запятой или двоеточием.

Print "The current date and time is: " + Now

Операторы Print и Messagebox способны помочь в отладке и трассировке программ на языке LotusScript. Так, вызов операторов Print можно периодически добавлять для того, чтобы в ходе выполнения программы определять значения пе­ременных или отслеживать условные переходы. Приведенный ниже пример показывает, как вывести на экран значение переменной. Вставляя время от времени оператор печати (Print) или диалогового окна (Messagebox), вы сможете наблю­дать значение интересующего объекта при работе программы.

Print "The current value is: " + doc.Status(0) Msgbox "The current value is: " + doc.Status(0)

В другом примере можно проконтролировать, какой маршрут выбрал пользо­ватель.

answer% = Messagebox( "Are you sure?", 36, "Continue?" ) If answer% = 6 Then

Print "The user selected YES" Else

Print "The user selected NO" End If

Оператор Inputbox

Inputbox предназначен для вывода всплывающего окна, в котором конечный пользователь может задать значение. Затем значение возвращается программе на LotusScript, где может быть обработано или сохранено. Синтаксически эта функ­ция такова:

Inputbox ( приглашение, заголовок, значение, положение )

приглашение - текстовая строка с описанием окна ввода. заголовок - необязателен. Содержит заголовок окна. значение - необязательно. Значение в поле ввода по умолчанию. положение - необязательно. Разделенные запятой координаты окна по оси х и оси у.

Например, следующий вызов функции Inputbox запрашивает у пользовате­ля его имя. При выводе окна на экран поле ввода по умолчанию содержит строку «John Doe», а в верхней части окна содержится заголовок (см. рис. 6.5). В завер­шение ответ пользователя отображается в строке состояния у нижнего края окна клиента Lotus Notes.

Dim result As String

result = Inputbox("What is your name?","Question","John Doe")

Рис. 6.5. Пример окна Inputbox

Print "Your name is: " + result

Оператор Dialogbox

Метод Dialogbox используется для вывода на экран текущего документа или заданной формы как всплывающего диалогового окна. Используя этот метод, вы можете передавать значения полей из окна в ту форму, на которой оно построено. Синтаксический формат метода продемонстрируем на примерах:

flag = notesUIWorkspace.Dialogbox ( форма , опции ) Call notesUIWorkspace.Dialogbox ( форма , опции )

Опишем опции этого метода, перечислив их по порядку следования в списке па­раметров такового. Для того чтобы использовать значение по умолчанию, укажите в списке параметров запятую.

Опция	Описание
AutoHorzFit	Автоматически подбирает горизонтальный размер диалогового окна так, чтобы на форме поместилась первая область раскладки или таб­лица. Значение должно иметь логический тип и равняться true или FALSE
2. AutoVertFit	Автоматически подбирает вертикальный размер диалогового окна так, чтобы на форме поместилась первая область раскладки или таб­лица. Значение должно иметь логический тип и равняться true или FALSE
3. NoCancel	Не отображать кнопку Cancel. Значение должно иметь логический тип И равнятся TRUE ИЛИ FALSE
NoNewFields	По умолчанию любое поле, содержащее значение на форме диалого­вого окна, но при этом не существующее в документе, на котором оно построено, создается автоматически. Этот опциональный параметр разрешает или запрещает создание в документе новых полей. Значе­ние должно иметь логический тип и равняться true или false
5. NoFieldUpdate	Блокирует обновление полей данными из диалогового окна и докумен­та, на котором оно построено. Значение должно иметь логический тип и равняться true или false
[б. Readonly	В значении TRUE выводится диалоговое окно в режиме «только для чтения». Иначе по умолчанию оно выводится в режиме чтения-запи­си. Значение должно иметь логический тип и равняться true или FALSE
7. Title	Заголовок диалогового окна
8. NotesDocument	Позволяет вывести на экран документ, отличный от текущего до­кумента
9. SizeToTable	Автоматически подбирает размер диалогового окна по первой таблице формы. Значение должно иметь логический тип и равняться true или FALSE
10. NoOkCancel	Удаляет из диалогового окна кнопку ОК. Значение должно иметь логи­ческий тип и равняться true или false
11.OkCancelAtBottom	По умолчанию кнопки ОК и Cancel выводятся у правой границы окна. В значении TRUE параметр выводит ОК и Cancel в нижней части окна. Значение должно иметь логический тип и равняться true или false

Пусть, скажем, у вас имеется форма для бронирования конференц-зала, содер­жащая в себе кнопку Recurring Event (Повторяющееся событие). На кнопке содер­жится следующий код, который при нажатии на нее, выводит в диалоговое окно форму (RepeatReservation). Используя открывшийся диалог, пользователь получает возможность ввести параметры периодического бронирования.

По нажатию на ОК значения полей формы передаются из диалогового окна в со­ответствующие поля документа, на котором она построена. При этом для передачи значений из окна (Dialogbox) в документ названия полей формы, находящейся в диалоге, и главной формы должны полностью совпадать. Если в документе поля отсутствуют, они автоматически создаются.

Dim w As New NotesUIWorkspace

Dim uidoc As NotesUIDocument

Dim doc As NotesDocument

Set uidoc = w.CurrentDocument

Set doc = uidoc.Document

Call w.DialogBox("(RepeatReservation)",True,True,,,,,"Repeat")