Skip to main content

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

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

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.

PictureEdit - DirectX Rendering

Show animation (GDI+ rendering)

PictureEdit - 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.

See Also