RenderOptions.ProcessRenderMode Property

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Specifies the render mode preference for the current process.

Namespace:   System.Windows.Media
Assembly:  PresentationCore (in PresentationCore.dll)

public static RenderMode ProcessRenderMode {
	[UIPermissionAttribute(SecurityAction.LinkDemand, Window = UIPermissionWindow.AllWindows)]

Property Value

Type: System.Windows.Interop.RenderMode

The RenderMode preference for the current process.

Use the ProcessRenderMode property to force software rendering for the current process. You can avoid many rendering issues that occur in WPF applications and that are caused by external issues if you change your preference to software rendering.

During application startup, if your application detects rendering issues, such as slow frame rates, you can set the rendering mode to software only. Also, you may want to enable the user setting while the application is running.

The SoftwareOnly preference overrides the RenderMode setting. The precedence order for software rendering is:

  1. DisableHWAcceleration registry key

  2. ProcessRenderMode

  3. RenderMode (per-target)

Note    ProcessRenderMode specifies a preference and does not necessarily change the actual rendering mode. Other parts of the system may override this preference and force the system into software rendering.


to set this property. Associated enumeration: AllWindows

.NET Framework
Available since 4.0
Return to top