Библиотека WMLBrowser
Библиотека WMLBrowser
Библиотека WMLBrowser содержит набор функций, предназначенных для доступа
к составляющим информационного наполнения устройства (device context).
getCurrentCard
Функция: WMLBrowser. getCurrentCard ();
Описание: Возвращает URL карты, выполняемой в текущий
момент времени.
Возвращаемое значение: Строка
/ Пример: Следующий сценарий использует функцию
WMLBrowser.getCurrentCard() для получения
URL карты, выполняемой в текущий момент
времени:
extern function GetCurrentCardTest()
{
var Result = WMLBrowser.getCurrentCard();
var ResultString = "WMLBrowser.getCurrentCard()" + "\r\r"
"The current card is " + Result;
Dialogs.alert(ResultString); ....
}
getVar
Функция: WMLBrowser. getVar (name);
Описание: Возвращает значение переменной с указанным
именем. Если переменная не определена, функция возвращает пустую строку. Если синтаксис
имени переменной некорректен, функция возвращает значение invalid.
Аргумент: name = Строка
Возвращаемое значение: Строка или значение invalid
Пример: Следующий сценарий использует функцию
WMLBrowser. getVar () для получения значения
переменной name, которая была определена в
WML-файле, вызвавшем сценарий:
extern function GetVarTestO
{
var Argument = "Name";^'
var Result = WMLBrowser.getVar(Argument);
var ResultString = "WMLBrowser.getVar()" + "\r\r" +
"The name is " + Result;
Dialogs.alert(ResultString);
Go
Функция: WMLBrowser.go(url);
Описание: Указывает, что должна загружаться и выполняться WML-страница по указанному URL WML-
страница не загружается до тех пор, пока не за-
кончится работа сценария. Функция возвращает
Пустую строку
Функции WMLBrowser. go О и WMLBrowser .prev()
замещают друг друга. Прежде чем сценарий
закончит свою работу, каждая из функций может
вызываться по нескольку раз. Однако сценарий
выполняет только последний вызов. Если по-
слeдний вызов устанавливает URL на пустую
строку, все запросы отменяются, и загрузка но вой карты или WML-страницы не выполняется.
Аргумент: url = Строка
Возвращаемое значение: Строка или значение invalid
Пример: Следующий сценарий использует функцию
WMLBrowser. go () для запуска WML-страницы
getvar.wml:
extern function GoTest()
{
var Argument = "getvar.wml";
var Result = WMLBrowser.go(Argument);
var ResultString = "WMLBrowser.go()" + "\r\r" +
"Ready to start " + "\r" +
"getvar.wml ";
Dialogs.alert(ResultString);
}
prev
Функция: WMLBrowser. prev ();
Описание: Указывает, что должна загружаться и выпол няться предыдущая карта. Карта не загружается
ДО тех пор, пока сценарий не завершит свою
работу. Функция возвращает пустую строку.
Функции WMLBrowser. go () и WMLBrowser. prev ()
замещают друг друга. Прежде чем сценарий
закончит свою работу, каждая из функций может
вызываться по нескольку раз. Выполняется
только последний вызов. Если последний вызов
устанавливает URL на пустую строку, все запросы
отменяются, и загрузка новой карты или WML-
страницы не выполняется.
Возвращаемое значение: Строка
Пример: Следующий сценарий использует функцию
WMLBrowser.prev() для,возврата на предыдущую
WML-страницу, которая в данном случае
представляет собой WML-страницу из примера
для функции WMLBrowser. go:
extern function PrevTestO
{
var Result = WMLBrowser.prev();
var ResultString = "WMLBrowser.prev()" + "\r\r" +
"Ready to go back one deck ";
Dialogs.alert(ResultString);
}
setVar
Функция: WMLBrowser.setVar(name, value);
Описание: Присваивает задаваемое значение value переменной с указываемым именем name и возвращает логическое значение true, если операция
выполнена успешно, и значение false, если
операция закончилась неудачей. Если синтаксис
имени переменной или указываемое значение
некорректны, функция возвращает значение
invalid.
Аргументы: name = Строка
value = любое значение
Возвращаемое значение: Логическое значение или значение invalid
Пример: Следующий сценарий использует функцию
WMLBrowser. setVar () для определения переменной Name в WML-странице, которая вызвала
сценарий:
extern function SetVarTestO
{
var Argumentl = "Name";
var Arguments = "Krissy";
var Result = WMLBrowser. setVar (Argumentl, Argument2) ;
var ResultString = "WMLBrowser. setVar ()" 4- "\r\r"
"Setting Name to Krissy";
Dialogs, alert (Resul tString) ;
)
