ProcessRenderMode Property
Collapse the table of content
Expand the table of content

RenderOptions::ProcessRenderMode Property

.NET Framework (current version)
 

Specifies the render mode preference for the current process.

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

public:
property RenderMode ProcessRenderMode {
	[SecurityCriticalAttribute]
	static RenderMode get();
	[SecurityCriticalAttribute]
	[UIPermissionAttribute(SecurityAction::LinkDemand, Window = UIPermissionWindow::AllWindows)]
	static void set(RenderMode value);
}

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:
© 2016 Microsoft