Компонент WebBrowserBox предназначен для загрузки и отображения веб-страниц.
Для загрузки какой-либо веб-страницы используйте метод Navigate. Также, если имеется html-код страницы, то его можно задать в свойстве DocumentText. Управление загруженной страницей осуществляется посредством свойств и методов объекта WebBrowser, лежащего в основе компонента WebBrowserBox. Также поддерживаются свойства/методы интерфейса IWebBrowser2, используемые при работе с экземплярами браузера Internet Explorer. Вся работа осуществляется через свойство OleObject. Описание WebBrowser/IWebBrowser2 представлено в MSDN.
При навигации в компоненте могут возникнуть различного рода ошибки не позволяющие корректно отобразить веб-страницы. Это связано с тем, что по умолчанию WebBrowser использует ядро устаревшего браузера Internet Explorer 7.0. Для решения проблемы можно воспользоваться методом, описание которого представлено в статье Internet Feature Controls (MSDN). В подразделе реестра [HKEY_LOCAL_MACHINE (или HKEY_CURRENT_USER)\Software\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BROWSER_EMULATION] создайте параметр типа REG_DWORD с наименованием запускаемого приложения (в случае запуска «Форсайт. Аналитическая платформа» - параметр с наименованием «studio.exe» или «pp.exe») и установите для него значение, соответствующее необходимой версии Internet Explorer (значения приведены в таблице по указанной ссылке). После этого в компоненте будет использоваться эмуляция более новой версии браузера Internet Explorer, что позволит избежать возникновения ряда ошибок, связанных с различием версий браузера.
Имя свойства | Краткое описание | |
Align | Свойство Align определяет, как поведет себя компонент при изменении размеров содержащего его родительского компонента. | |
AllowDrag | Свойство AllowDrag определяет возможность взять у компонента перетаскиваемый объект. | |
AllowDrop | Свойство AllowDrop определяет, будет ли возможность у компонента принять перетаскиваемый объект. | |
Anchors | Свойство Anchors возвращает настройки, определяющие в процентном соотношении изменение размеров текущего компонента при изменении размеров родительского компонента. | |
BorderStyle | Свойство BorderStyle определяет стиль границы компонента. | |
Brush | Свойство Brush определяет кисть, используемую для заливки области компонента. | |
ClientHeight | Свойство ClientHeight используется для получения или задания высоты клиентской области компонента. | |
ClientWidth | Свойство ClientWidth используется для получения или задания ширины клиентской области компонента. | |
Color | Свойство Color определяет цвет фона компонента. | |
ComponentCount | Свойство ComponentCount возвращает количество дочерних компонентов. | |
Components | Свойство Components возвращает дочерний компонент. | |
Cursor | Свойство Cursor определяет вид курсора над компонентом. | |
Data | Свойство Data предназначено для хранения любых пользовательских данных. | |
DocumentText | Свойство DocumentText определяет HTML код страницы, загруженной в компоненте. | |
Enabled | Свойство Enabled определяет доступность компонента для пользователя. | |
Focused | Свойство Focused возвращает True, если фокус установлен на данном компоненте. | |
Font | Свойство Font определяет множество характеристик, описывающих шрифт, используемый при отображении текста. | |
Height | Свойство Height определяет высоту компонента. | |
HelpContext | Свойство HelpContext определяет уникальный индекс раздела контекстно-зависимой справки для данного компонента. | |
Hint | Свойство Hint определяет текст подсказки для компонента. | |
Left | Свойство Left определяет координату левого края компонента. | |
Name | Свойство Name определяет наименование компонента. | |
OleObject | Свойство OleObject возвращает веб-страницу, загруженную в компонент, в виде OLE-объекта. | |
Parent | Свойство Parent определяет родительский компонент. | |
ParentColor | Свойство ParentColor определяет, будет ли для компонента заимствован цвет родительского компонента. | |
ParentFont | Свойство ParentFont определяет, будет ли для компонента использоваться шрифт родительского компонента. | |
ParentShowHint | Свойство ParentShowHint определяет условие отображения всплывающей подсказки. | |
PopupMenu | Свойство PopupMenu определяет контекстное меню, которое будет появляться по щелчку дополнительной кнопки мыши на компоненте. | |
Scrolls | Свойство Scrolls возвращает параметры полос прокрутки компонента. | |
ShowHint | Свойство ShowHint включает и выключает показ всплывающего окна подсказки для компонента. | |
TabOrder | Свойство TabOrder определяет позицию компонента в последовательности табуляции. | |
TabStop | Свойство TabStop определяет признак необходимости компоненту получать фокус при нажатии кнопки «TAB». | |
Tag | Свойство Tag не используется компилятором. Пользователь может изменить значение свойства Tag и использовать его по своему усмотрению. | |
Text | Свойство Text определяет строку, идентифицирующую компонент для пользователя. | |
Top | Свойство Top определяет координату верхнего края компонента. | |
Visible | Свойство Visible определяет видимость компонента во время выполнения. | |
Width | Свойство Width определяет ширину компонента. |
Имя метода | Краткое описание | |
BringToFront | Метод BringToFront располагает компонент на передний план. | |
ClientToScreen | Метод ClientToScreen преобразовывает координаты точки, указанные относительно системы координат компонента, в экранные координаты. | |
DoDragDrop | Метод DoDragDrop позволяет начать операцию перетаскивания. | |
GetImage | Метод GetImage возвращает изображение компонента со всеми дочерними компонентами. | |
Navigate | Метод Navigate осуществляет загрузку в компонент веб-страницу, адрес которой передается в качестве входного параметра. | |
Refresh | Метод Refresh осуществляет обновление загруженной Web-страницы. | |
ScreenToClient | Метод ScreenToClient преобразовывает экранные координаты точки в координаты, указываемые относительно системы координат компонента. | |
SendToBack | Метод SendToBack располагает компонент на задний план. | |
SetFocus | Метод SetFocus устанавливает фокус на данный компонент. |
Имя события | Краткое описание | |
OnBeforeNavigate2 | Событие OnBeforeNavigate2 наступает перед тем, как будет совершен переход к какой-либо Web-странице. | |
OnBeginDrag | Событие OnBeginDrag для компонента наступает, когда пользователь начинает перетаскивать объект от компонента. | |
OnClick | Событие OnClick наступает, если пользователь щёлкнул в области компонента. | |
OnDblClick | Событие OnDblClick наступает, если пользователь дважды щёлкнул в области компонента. | |
OnDocumentComplete | Событие OnDocumentComplete наступает после завершения загрузки Web-страницы. | |
OnDragDrop | Событие OnDragDrop для компонента наступает, когда пользователь отпускает над ним перетаскиваемый объект. | |
OnDragEnter | Событие OnDragEnter наступает, когда перетаскиваемый объект входит в границы данного компонента. | |
OnDragLeave | Событие OnDragLeave наступает, когда перетаскиваемый объект выходит за границы данного компонента. | |
OnDragOver | Событие OnDragOver для компонента наступает, когда пользователь протаскивает над ним перетаскиваемый объект. | |
OnEnter | Событие OnEnter наступает в момент получения фокуса компонентом. | |
OnExit | Событие OnExit наступает в момент потери фокуса компонентом. | |
OnHScroll | Событие OnHScroll наступает при изменении положения ползунка горизонтальной полосы прокрутки. | |
OnKeyDown | Событие OnKeyDown наступает, если компонент находится в фокусе и производится нажатие на клавиатуру. | |
OnKeyPress | Событие OnKeyPress наступает, если компонент находится в фокусе, при нажатии пользователем символьной клавиши. | |
OnKeyPreview | Событие OnKeyPreview наступает перед каждым событием, связанным с нажатием клавиш. | |
OnKeyUp | Событие OnKeyUp наступает, если компонент находится в фокусе, при отпускании пользователем любой, ранее нажатой клавиши. | |
OnMouseDown | Событие OnMouseDown наступает, если указатель находится в области компонента и была нажата любая кнопка мыши. | |
OnMouseEnter | Событие OnMouseEnter наступает в момент входа курсора мыши в область компонента. | |
OnMouseHover | Событие OnMouseHover наступает при задержке курсора мыши в области компонента. | |
OnMouseLeave | Событие OnMouseLeave наступает в момент выхода курсора мыши за пределы области компонента. | |
OnMouseMove | Событие OnMouseMove наступает при перемещении курсора мыши над компонентом. | |
OnMouseUp | Событие OnMouseUp наступает при отпускании кнопки мыши, когда указатель находится в области компонента. | |
OnMouseWheel | Событие OnMouseWheel наступает, если компонент находится в фокусе при вращении колеса мыши. | |
OnNavigateComplete2 | Событие OnNavigateComplete2 наступает после завершения перехода к новой Web-странице. | |
OnVScroll | Событие OnVScroll наступает при изменении положения ползунка вертикальной полосы прокрутки. |
См. также: