Visual Basic 6. Руководство разработчика

       

Методы объекта


Wscript

Объект Wscript имеет несколько методов, большая часть которых подобна функциям VBScript. Наиболее важные методы — CreateObject и GetObject — аналогичны функциям VBScript с такими же именами Рассмотрим методы Wscript.

Echo. Отображает одно или более значений в окне сообщений. Можно отобразить синоним имени Windows Scripting Host, воспользовавшись функцией MsgBox().

Wscript.Echo Wscript.Name

Можно отобразить несколько значений, разделив их запятыми. Они отобразятся одно за другим с пробелом между ними. Следующий оператор отображает окно сообщений, показанное на рис. 20.10.

Wscript.Echo "string argument", Wscript.Name, 98.9+1

Свойство Name заменено его значением, а выражение 98, 9+1 - вычислено

Рис. 20.10. Метод Echo отображает несколько значений подряд

Echo — это простой метод и может использоваться в качестве примитивного инструмента отладки Функция

MsgBox() и метод Pop-Up (описан ниже) предос­тавляют гораздо больше возможностей.

Quit. Завершает выполнение сценария и может вернуть код ошибки. Его синтаксис:

Wscript.Quit errorCode



Необязательный аргумент errorCode - возвращаемый код ошибки. По умолчанию этот метод возвращает 0. Код ошибки может использоваться для контроля завершения приложения нормально или с ошибками.


InternetExplorer и элемента управления WebBrowser

Методы элемента управления WebBrowser и объекта InternetExplorer позволяют переместиться к новым или к уже посещенным URL.

GoBack, GoForward (Переместиться вперед. Переместиться назад). Эти методы управляют перемещением назад или вперед на один URL в списке посещенных узлов, который поддерживается автоматически элементом управления WebBrowser или объектом InternetExplorer. При попытке перемещения за пределы списка гене­рируется ошибка. Чтобы ее перехватить, необходимо включить код, обрабатывающий данную ошибку.

GoHome, GoSearch (Перейти к домашней странице. Перейти к поиску). GoHome — метод, который перемещает пользователя к домашней странице; GoSearch — метод, который перемещает пользователя к странице, определенной в диалоговом окне Internet Explorer Options.

Navigate (Переместиться).

Этот метод передвигается на URL или открывает HTML-файл, заданный в первом параметре метода. Его синтаксис:

Navigate URL [Flags], [TargetFrameName,] [PostData,] [Headers]

Все параметры, кроме первого, имеют значения по умолчанию. Параметр URL -адрес ресурса, который нужно показать на элементе управления. Параметр Flag — константа или значение, которое определяет, добавить ресурс к списку хронологии, читать или записывать из кэша, и отображать ли ресурс в новом окне. Его значения приведены в табл. 21.1.

Таблица 21.1. Значения параметра Flags

Константа

Значение

Описание

NavOpenlnNew Window

1

Открывать ресурс или файл в новом окне

NavNoHistory

2

Не добавлять ресурс или имя файла к списку хронологии

NavNoReadFrom Cache

4

Не читать из кэша жесткого диска при этом передвижении

NavNo Write To Cache

8

Не записывать результаты передвижения в кэш жесткого диска

Параметр Target FrameName - имя фрейма, в котором отображается документ. Если документ, отображенный на элементе управления WebBrowser, содержит фреймы, то можно отобразить новый документ в одном из существующих фреймов.




Document

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

Open (Открыть).

Открывает документ для вывода. Текущий документ очищается, а новые строки помещаются в документ с помощью методов Write и WriteLn.

Примечание

Метод Open объекта Document открывает текущий документ для вывода и не имеет ничего общего с методом Open объекта Window, который запускает новый экземпляр Internet Explorer и отображает в нем документ.

Write string (Записать строку). Записывает значение строковой

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

WriteLn string.

Записывает строковую переменную в текущий документ с управ­ляющим символом "новая строка", добавленным в конец строки. Управляющий символ игнорируется броузером, так что строковый метод WriteLn работает так же, как метод Write string.

Close (Закрыть).

Закрывает документ и заставляет всю информацию, записанную в него с помощью методов Write и WriteLn, отображаться как в HTML-документе, загруженном в окне броузера.

Clear (Очистить).

Очищает содержимое документа.

Использование методов объекта Document

Описанные методы позволяют программисту (или Web-дизайнеру) с помощью сценария создать HTML-документ, что и показано в примере

Pagel.htm следую­щего параграфа. Методы объекта Document обычно вызываются в следующем порядке.

Document.open

Document.write string

........

Document.write string

Document.close

Переменная string или литеральная константа могут быть чем угодно, что обычно появляется в HTML-документе (текст, HTML-отметки, гиперсвязи и т.д.). Параметр метода Write может содержать HTML-теги, что позволяет создавать Web-страницы на лету. Следующие операторы отображают заголовок первого уровня, расположенный на странице по центру.

Document.write "<CENTER>"

Document.write "<Hl>Welcome to our Active Pages</Hl>"

' (Добро пожаловать на наши активные страницы)




History

Объект History из Scripting Model поддерживает список уже посещенных узлов и предоставляет возможность обращения к ним через методы объекта History, описанные ниже. Объект History не имеет собственных свойств или событий.

Back n (Назад).

Позволяет перемещаться обратно в списке хронологии на п шагов, как при нажатии кнопки Back n раз. Чтобы переместится на предыдущий URL, используется выражение

call Window.History.back(0)

или

call Window.History.back

Forward n (Вперед).

Приводит к перемещению вперед по списку хронологии на п шагов, как при нажатии кнопки Forward n раз.

Go n (Перейти к).

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

элемент в списке хроно­логии. Следующее выражение осуществляет переход к первому URL в списке.

Window.History.gо 1



Содержание раздела