RenderOptions.ProcessRenderMode Property

.NET Framework (current version)
 
System_CAPS_noteNote

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

Specifies the render mode preference for the current process.

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

Public Shared Property ProcessRenderMode As RenderMode

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.

UIPermission

to set this property. Associated enumeration: AllWindows

.NET Framework
Available since 4.0
Return to top
Show: