Поделиться через

Обзор элемента управления WebBrowser

  • Статья

Элемент управления WebBrowser обеспечивает управляемую оболочку для элемента управления ActiveX WebBrowser. Управляемая оболочка позволяет отображать веб-страницы в клиентских приложениях Windows Forms. Вы можете использовать элемент управления WebBrowser для дублирования функций браузера Internet Explorer в приложении или отключения функций Internet Explorer по умолчанию и использования элемента управления в качестве простого средства просмотра HTML-документов. Вы также можете использовать элемент управления для добавления элементов пользовательского интерфейса на основе DHTML в форму и скрыть тот факт, что они размещены в элементе управления WebBrowser. Такой подход позволяет легко объединять веб-элементы управления с элементами управления Windows Forms в одном приложении.

Часто используемые свойства, методы и события

Элемент управления WebBrowser содержит несколько свойств, методов и событий, которые можно использовать для реализации элементов управления, найденных в Internet Explorer. Например, можно использовать метод Navigate для реализации адресной строки и методов GoBack, GoForward, Stopи Refresh для реализации кнопок навигации на панели инструментов. Можно обработать событие Navigated, чтобы обновить адресную строку со значением свойства Url и строкой заголовка со значением свойства DocumentTitle.

Если вы хотите создать собственное содержимое страницы в приложении, можно задать свойство DocumentText. Если вы знакомы с объектной моделью HTML-документа (DOM), вы также можете управлять содержимым текущей веб-страницы с помощью свойства Document. С помощью этого свойства можно хранить и изменять документы в памяти, а не перемещаться между файлами.

Свойство Document также позволяет вызывать методы, реализованные в коде скриптов веб-страниц из клиентского кода приложения. Чтобы получить доступ к коду клиентского приложения из кода скриптов, задайте свойство ObjectForScripting. Указанный объект можно получить с помощью кода скрипта в качестве объекта window.external.

Имя Описание
свойство Document Возвращает объект, предоставляющий управляемый доступ к объектной модели HTML-документа (DOM) текущей веб-страницы.
событие DocumentCompleted Происходит при завершении загрузки веб-страницы.
свойство DocumentText Возвращает или задает HTML-содержимое текущей веб-страницы.
свойство DocumentTitle Возвращает заголовок текущей веб-страницы.
метод GoBack Переходит на предыдущую страницу в журнале.
метод GoForward Переходит на следующую страницу в истории.
метод Navigate Переходит к указанному URL-адресу.
событие Navigating Происходит перед началом навигации, что позволяет отменить действие.
свойство ObjectForScripting Возвращает или задает объект, который код скриптов веб-страниц может использовать для взаимодействия с приложением.
метод Print Печатает текущую веб-страницу.
метод Refresh Перезагрузит текущую веб-страницу.
метод Stop Останавливает текущую навигацию и останавливает динамические элементы страницы, такие как звуки и анимация.
свойство Url Возвращает или задает URL-адрес текущей веб-страницы. При задании этого свойства элемент управления переходит к новому URL-адресу.

См. также