Settings.EnableRedrawRegions Property
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Gets or sets a value that indicates whether to show the areas of the Silverlight plug-in that are being redrawn each frame.
Namespace: System.Windows.Interop
Assembly: System.Windows (in System.Windows.dll)
Syntax
'Declaration
Public Property EnableRedrawRegions As Boolean
public bool EnableRedrawRegions { get; set; }
Property Value
Type: System.Boolean
true if the areas of the plug-in that are being redrawn each frame are shown; otherwise, false.
Remarks
The EnableRedrawRegions property enables a diagnostic feature that is used during development for performance-tuning your application by showing the areas of the plug-in that are being redrawn each frame. You cannot set this property during initialization. Typically you would turn this property on and off using an event handler, after the Silverlight plug-in is loaded.
Examples
The following code example demonstrates how to use this property.
' 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
// 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;
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.