This documentation is archived and is not being maintained.

RenderOptions.ProcessRenderMode Property

Specifies the render mode preference for the current process.

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

public static RenderMode ProcessRenderMode { get; set; }

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.

.NET Framework

Supported in: 4

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.