Export (0) Print
Expand All

SilverlightHost Class

Silverlight

Reports details about the Silverlight-based application's instantiation settings, and exposes some of the HTML DOM values for the hosted Silverlight plug-in instance.

System.Object
  System.Windows.Interop.SilverlightHost

Namespace:  System.Windows.Interop
Assembly:  System.Windows (in System.Windows.dll)

'Declaration
Public Class SilverlightHost

The SilverlightHost type exposes the following members.

  NameDescription
Public methodSupported by Silverlight for Windows PhoneSilverlightHostInfrastructure. Initializes a new instance of the SilverlightHost class.
Top

  NameDescription
Public propertySupported by Silverlight for Windows PhoneBackgroundGets the background color value that was applied to the Silverlight plug-in as part of instantiation settings.
Public propertySupported by Silverlight for Windows PhoneContentGets the "Content" sub-object of this SilverlightHost.
Public propertyInitParamsGets the initialization parameters that were passed as part of HTML initialization of a Silverlight plug-in.
Public propertySupported by Silverlight for Windows PhoneIsLoadedGets a value that indicates whether the hosted Silverlight plug-in has finished loading.
Public propertySupported by Silverlight for Windows PhoneNavigationStateGets or sets a URI fragment that represents the current navigation state.
Public propertySupported by Silverlight for Windows PhoneSettingsGets the "Settings" sub-object of this SilverlightHost.
Public propertySourceGets the URI of the package or XAML file that specifies the XAML content to render.
Top

  NameDescription
Public methodSupported by Silverlight for Windows PhoneEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodSupported by Silverlight for Windows PhoneFinalizeAllows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneIsVersionSupportedReturns a value that indicates whether the installed Silverlight plug-in supports the specified version.
Protected methodSupported by Silverlight for Windows PhoneMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodSupported by Silverlight for Windows PhoneToStringReturns a string that represents the current object. (Inherited from Object.)
Top

  NameDescription
Public eventSupported by Silverlight for Windows PhoneNavigationStateChangedOccurs when the NavigationState property changes value.
Top

Much of the information that is reported by a SilverlightHost object is the same information that could be obtained from properties of the Silverlight plug-in object in the JavaScript API of the Silverlight object model. For instance, the Background color that was set as part of the Silverlight plug-in instantiation can be obtained by getting the current SilverlightHost instance from the Application.Host property, and then getting the Background property.

The Content property returns a value of type Content, which represents the visual state of the plug-in. This type enables you to perform common tasks, such as display the plug-in in full-screen mode or retrieve its current size.

The Settings property returns a value of type Settings, which provides access to some plug-in configuration values.

The following code example demonstrates how to use this class.


' The Host object, which represents the host Silverlight plug-in. 
Dim host As System.Windows.Interop.SilverlightHost = _
    Application.Current.Host

' The following code demonstrates how to use the Host object 
' to access other APIs in the System.Windows.Interop namespace. 

' The IsVersionSupported method. This method is useful when 
' you want to implement an upgrade experience in managed code. 
Dim isSupported As Boolean = host.IsVersionSupported("2.0.30908.0")

' Read-only properties of the Host object. 
Dim pluginBackground As System.Windows.Media.Color = host.Background
Dim loaded As Boolean = host.IsLoaded
Dim source As Uri = host.Source

' The Settings object, which represents Web browser settings. 
Dim settings As System.Windows.Interop.Settings = host.Settings

' Read/write properties of the Settings object. 
settings.EnableFrameRateCounter = True
settings.EnableRedrawRegions = True
settings.MaxFrameRate = 60

' Read-only properties of the Settings object. 
Dim windowless As Boolean = settings.Windowless
Dim htmlAccessEnabled As Boolean = settings.EnableHTMLAccess

' The Content object, which represents the plug-in display area. 
Dim content As System.Windows.Interop.Content = host.Content

' The read/write IsFullScreen property of the Content object. 
' See also the Content.FullScreenChanged event. 
Dim isFullScreen As Boolean = content.IsFullScreen

' Read-only properties of the Content object. These properties do 
' not contain meaningful values until after the Content.Resized 
' event occurs for the first time. 
Dim actualWidth As Double = content.ActualWidth
Dim actualHeight As Double = content.ActualHeight


Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

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

Community Additions

ADD
Show:
© 2014 Microsoft