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.
Assembly: System.Windows (in System.Windows.dll)
Thetype exposes the following members.
|DefaultDesignImage||Gets or sets a stream associated with a PNG image to be displayed by the host when the Silverlight application is not executing.|
|EnableAutoZoom||Gets or sets a value that indicates whether the Silverlight plug-in will resize its content based on the current browser zoom setting.|
|EnableCacheVisualization||Gets or sets a value that indicates whether to use a non-production analysis visualization mode, which shows areas of a page that are not being GPU accelerated with a colored overlay. Do not use in production code.|
|EnableFrameRateCounter||Gets or sets a value that indicates whether to display the current frame rate in the hosting browser's status bar. (Microsoft Internet Explorer only.)|
|EnableGPUAcceleration||Gets a value that indicates whether to use graphics processor unit (GPU) hardware acceleration for cached compositions, which potentially results in graphics optimization.|
|EnableHTMLAccess||Gets a value that indicates whether the Silverlight plug-in allows hosted content or its runtime to access the HTML DOM.|
|EnableRedrawRegions||Gets or sets a value that indicates whether to show the areas of the Silverlight plug-in that are being redrawn each frame.|
|MaxFrameRate||Gets or sets the maximum number of frames to render per second.|
|Windowless||Gets a value that indicates whether the Silverlight plug-in displays as a windowless plug-in. (Applies to Windows versions of Silverlight only.)|
|Equals(Object)||Determines whether the specified Object is equal to the current Object. (Inherited from Object.)|
|Finalize||Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)|
|GetHashCode||Serves as a hash function for a particular type. (Inherited from Object.)|
|GetType||Gets the Type of the current instance. (Inherited from Object.)|
|MemberwiseClone||Creates a shallow copy of the current Object. (Inherited from Object.)|
|ToString||Returns a string that represents the current object. (Inherited from Object.)|
The class contains APIs that specifically relate to aspects of the HTML DOM outside of the Silverlight content area (the area declared by the width and height in the initialization).
The following code example demonstrates how to use this class.
// The Host object, which represents the host Silverlight plug-in. System.Windows.Interop.SilverlightHost host = 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. bool isSupported = host.IsVersionSupported("2.0.30908.0"); // Read-only properties of the Host object. System.Windows.Media.Color pluginBackground = host.Background; bool loaded = host.IsLoaded; Uri source = host.Source; // The Settings object, which represents Web browser settings. System.Windows.Interop.Settings 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. bool windowless = settings.Windowless; bool htmlAccessEnabled = settings.EnableHTMLAccess; // The Content object, which represents the plug-in display area. System.Windows.Interop.Content content = host.Content; // The read/write IsFullScreen property of the Content object. // See also the Content.FullScreenChanged event. bool isFullScreen = 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. double actualWidth = content.ActualWidth; double actualHeight = content.ActualHeight;
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.