PictureEdit.UseDirectXPaint Property

Gets or sets whether or not this PictureEdit uses the DirectX Hardware Acceleration.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v22.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Appearance")]
public DefaultBoolean UseDirectXPaint { get; set; }

VB.NET

<DXCategory("Appearance")>
<DefaultValue(DefaultBoolean.Default)>
Public Property UseDirectXPaint As DefaultBoolean

Property Value

Type	Default	Description
DefaultBoolean	Default	A DefaultBoolean enum value that specifies whether or not this control employs the DirectX Hardware Acceleration. To enable DirectX hardware acceleration, call the static WindowsFormsSettings.ForceDirectXPaint method and set UseDirectXPaint to DefaultBoolean.True.

Available values:

Name	Description
True	true. DefaultBoolean.True has a constant value of 0, while the standard true value corresponds to a value of 1. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
False	false. DefaultBoolean.False has a constant value of 1, while the standard false value corresponds to a value of 0. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
Default	The default behavior determined by the control’s logic.

Remarks

The static WindowsFormsSettings.ForceDirectXPaint method does not affect Picture Edits. To enable the DirectX Hardware accelleration for required Picture Edit controls, you need to manually enable their UseDirectXPaint properties.

The DirectX engine allows you to improve the scrolling and resizing performance for PictureEdits that contain huge images.

Show animation (GDI+ rendering)

Note

Only modify the UseDirectXPaint setting before the control’s handle is created. For instance, you can do this at design time, or in the form’s constructor.