2 out of 3 rated this helpful - Rate this topic

WebBrowser Class

July 26, 2012

Allows HTML rendering and navigation functionality to be embedded in an application.

System.Object
  System.Windows.DependencyObject
    System.Windows.UIElement
      System.Windows.FrameworkElement
        System.Windows.Controls.Control
          Microsoft.Phone.Controls.WebBrowser

Namespace: Microsoft.Phone.Controls
Assembly: Microsoft.Phone (in Microsoft.Phone.dll)
XMLNS for XAML: Not mapped to an xmlns.

Syntax

[TemplatePartAttribute(Name = "StateContainer", Type = typeof(Border))]
[TemplateVisualStateAttribute(Name = "Disabled", GroupName = "WebBrowserStates")]
[TemplatePartAttribute(Name = "PresentationContainer", Type = typeof(Border))]
[TemplateVisualStateAttribute(Name = "Normal", GroupName = "WebBrowserStates")]
public sealed class WebBrowser : Control

XAML Object Element Usage

<WebBrowser .../>

The WebBrowser type exposes the following members.

Constructors

	Name	Description
	WebBrowser	Initializes a new instance of the WebBrowser class.

Top

Properties

	Name	Description
	ActualHeight	(Inherited from FrameworkElement.)
	ActualWidth	(Inherited from FrameworkElement.)
	AllowDrop	(Inherited from UIElement.)
	Background	(Inherited from Control.)
	Base	Sets the base directory within isolated storage that is used to resolve relative references within the WebBrowser control.
	BorderBrush	(Inherited from Control.)
	BorderThickness	(Inherited from Control.)
	CacheMode	(Inherited from UIElement.)
	Clip	(Inherited from UIElement.)
	Cursor	(Inherited from FrameworkElement.)
	DataContext	(Inherited from FrameworkElement.)
	DefaultStyleKey	(Inherited from Control.)
	DesiredSize	(Inherited from UIElement.)
	Dispatcher	(Inherited from DependencyObject.)
	FlowDirection	(Inherited from FrameworkElement.)
	FontFamily	(Inherited from Control.)
	FontSize	(Inherited from Control.)
	FontStretch	(Inherited from Control.)
	FontStyle	(Inherited from Control.)
	FontWeight	(Inherited from Control.)
	Foreground	(Inherited from Control.)
	Height	(Inherited from FrameworkElement.)
	HorizontalAlignment	(Inherited from FrameworkElement.)
	HorizontalContentAlignment	(Inherited from Control.)
	IsEnabled	(Inherited from Control.)
	IsGeolocationEnabled	Determines whether a website that is hosted in the WebBrowser control can use location services on the device.
	IsHitTestVisible	(Inherited from UIElement.)
	IsScriptEnabled	Enables or disables scripting. This applies to the next document that is navigated to, not the current document. This property is false by default. Set this property to true to enable scripting, or false to disable scripting.
	IsTabStop	(Inherited from Control.)
	Language	(Inherited from FrameworkElement.)
	Margin	(Inherited from FrameworkElement.)
	MaxHeight	(Inherited from FrameworkElement.)
	MaxWidth	(Inherited from FrameworkElement.)
	MinHeight	(Inherited from FrameworkElement.)
	MinWidth	(Inherited from FrameworkElement.)
	Name	(Inherited from FrameworkElement.)
	Opacity	(Inherited from UIElement.)
	OpacityMask	(Inherited from UIElement.)
	Padding	(Inherited from Control.)
	Parent	(Inherited from FrameworkElement.)
	Projection	(Inherited from UIElement.)
	RenderSize	(Inherited from UIElement.)
	RenderTransform	(Inherited from UIElement.)
	RenderTransformOrigin	(Inherited from UIElement.)
	Resources	(Inherited from FrameworkElement.)
	Source	Gets or sets the URI location of the WebBrowser control.
	Style	(Inherited from FrameworkElement.)
	TabIndex	(Inherited from Control.)
	TabNavigation	(Inherited from Control.)
	Tag	(Inherited from FrameworkElement.)
	Template	(Inherited from Control.)
	Triggers	(Inherited from FrameworkElement.)
	UseLayoutRounding	(Inherited from UIElement.)
	VerticalAlignment	(Inherited from FrameworkElement.)
	VerticalContentAlignment	(Inherited from Control.)
	Visibility	(Inherited from UIElement.)
	Width	(Inherited from FrameworkElement.)

Top

Methods

	Name	Description
	AddHandler	(Inherited from UIElement.)
	ApplyTemplate	(Inherited from Control.)
	Arrange	(Inherited from UIElement.)
	ArrangeOverride	(Inherited from FrameworkElement.)
	CaptureMouse	(Inherited from UIElement.)
	CheckAccess	(Inherited from DependencyObject.)
	ClearValue	(Inherited from DependencyObject.)
	Equals	(Inherited from Object.)
	Finalize	(Inherited from Object.)
	FindName	(Inherited from FrameworkElement.)
	Focus	(Inherited from Control.)
	GetAnimationBaseValue	(Inherited from DependencyObject.)
	GetBindingExpression	(Inherited from FrameworkElement.)
	GetHashCode	(Inherited from Object.)
	GetTemplateChild	(Inherited from Control.)
	GetType	(Inherited from Object.)
	GetValue	(Inherited from DependencyObject.)
	InvalidateArrange	(Inherited from UIElement.)
	InvalidateMeasure	(Inherited from UIElement.)
	InvokeScript(String)	Executes a scripting function defined in the currently loaded document.
	InvokeScript(String, String[])	Executes a scripting function defined in the currently loaded document, and passes the function an array of string parameters.
	Measure	(Inherited from UIElement.)
	MeasureOverride	(Inherited from FrameworkElement.)
	MemberwiseClone	(Inherited from Object.)
	Navigate(Uri)	Initiates a navigate request to the provided URI.
	Navigate(Uri, Byte[], String)	Initiates a navigate request to the provided URI. This method allows customizable options for including posted form data and HTTP headers.
	NavigateToString	Injects an HTML string into the web browser control for rendering.
	OnApplyTemplate	Do not use this method. It is unsupported. (Overrides FrameworkElement.OnApplyTemplate().)
	OnCreateAutomationPeer	(Inherited from UIElement.)
	OnDoubleTap	(Inherited from Control.)
	OnDragEnter	(Inherited from Control.)
	OnDragLeave	(Inherited from Control.)
	OnDragOver	(Inherited from Control.)
	OnDrop	(Inherited from Control.)
	OnGotFocus	(Inherited from Control.)
	OnHold	(Inherited from Control.)
	OnKeyDown	(Inherited from Control.)
	OnKeyUp	(Inherited from Control.)
	OnLostFocus	(Inherited from Control.)
	OnLostMouseCapture	(Inherited from Control.)
	OnManipulationCompleted	(Inherited from Control.)
	OnManipulationDelta	(Inherited from Control.)
	OnManipulationStarted	(Inherited from Control.)
	OnMouseEnter	(Inherited from Control.)
	OnMouseLeave	(Inherited from Control.)
	OnMouseLeftButtonDown	(Inherited from Control.)
	OnMouseLeftButtonUp	(Inherited from Control.)
	OnMouseMove	(Inherited from Control.)
	OnMouseRightButtonDown	(Inherited from Control.)
	OnMouseRightButtonUp	(Inherited from Control.)
	OnMouseWheel	(Inherited from Control.)
	OnTap	(Inherited from Control.)
	OnTextInput	(Inherited from Control.)
	OnTextInputStart	(Inherited from Control.)
	OnTextInputUpdate	(Inherited from Control.)
	ReadLocalValue	(Inherited from DependencyObject.)
	ReleaseMouseCapture	(Inherited from UIElement.)
	RemoveHandler	(Inherited from UIElement.)
	SaveToString	Returns a string containing the HTML content of the webpage.
	SetBinding	(Inherited from FrameworkElement.)
	SetValue	(Inherited from DependencyObject.)
	ToString	(Inherited from Object.)
	TransformToVisual	(Inherited from UIElement.)
	UpdateLayout	(Inherited from UIElement.)

Top

Events

	Name	Description
	BindingValidationError	(Inherited from FrameworkElement.)
	DoubleTap	(Inherited from UIElement.)
	GotFocus	(Inherited from UIElement.)
	Hold	(Inherited from UIElement.)
	IsEnabledChanged	(Inherited from Control.)
	KeyDown	(Inherited from UIElement.)
	KeyUp	(Inherited from UIElement.)
	LayoutUpdated	(Inherited from FrameworkElement.)
	LoadCompleted	Occurs after the WebBrowser control has loaded content.
	Loaded	(Inherited from FrameworkElement.)
	LostFocus	(Inherited from UIElement.)
	LostMouseCapture	(Inherited from UIElement.)
	ManipulationCompleted	(Inherited from UIElement.)
	ManipulationDelta	(Inherited from UIElement.)
	ManipulationStarted	(Inherited from UIElement.)
	MouseEnter	(Inherited from UIElement.)
	MouseLeave	(Inherited from UIElement.)
	MouseLeftButtonDown	(Inherited from UIElement.)
	MouseLeftButtonUp	(Inherited from UIElement.)
	MouseMove	(Inherited from UIElement.)
	MouseWheel	(Inherited from UIElement.)
	Navigated	Occurs after the WebBrowser control successfully navigates.
	Navigating	Occurs when the browser control is navigating, including from a redirect.
	NavigationFailed	Occurs after the WebBrowser control fails to navigate.
	ScriptNotify	Occurs when Javascript calls window.external.notify(<data>)
	SizeChanged	(Inherited from FrameworkElement.)
	Tap	(Inherited from UIElement.)
	TextInput	(Inherited from UIElement.)
	TextInputStart	(Inherited from UIElement.)
	TextInputUpdate	(Inherited from UIElement.)
	Unloaded	(Inherited from FrameworkElement.)

Top

Extension Methods

	Name	Description
	GetCookies	Returns a CookieCollection of Cookie objects retrieved from the Source URI of a WebBrowser control. (Defined by WebBrowserExtensions.)

Top

Fields

	Name	Description
	BaseProperty	Identifies the Base dependency property.
	IsGeolocationEnabledProperty	Identifies the IsGeolocationEnabled dependency property.
	IsScriptEnabledProperty	Identifies the IsScriptEnabled dependency property.
	SourceProperty	Identifies the Source dependency property.

Top

Remarks

Note:
Memory allocated for a WebBrowserTask does not count toward total application memory use. If you are developing your application to target a 256-MB device, consider using a Web Browser Task instead of a WebBrowser control. This helps minimize your application's memory use, which is particularly important when your application runs on a 256-MB device. For more information, see Developing for 256-MB Devices and How to: Use the Web Browser Task for Windows Phone.

Note:

multiple devices Memory allocated for a WebBrowserTask does not count toward total application memory use. If you are developing your application to target a 256-MB device, consider using a Web Browser Task instead of a WebBrowser control. This helps minimize your application's memory use, which is particularly important when your application runs on a 256-MB device. For more information, see Developing for 256-MB Devices and How to: Use the Web Browser Task for Windows Phone.

Version Information

Windows Phone OS

Supported in: 7.1, 7.0

Platforms

Windows Phone

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Reference

Microsoft.Phone.Controls Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)