PictureEdit.UseDirectXPaint Property

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

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.2.dll

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	Return Value
True	The value is true.	0
False	The value is false.	1
Default	The value is specified by a global option or a higher-level object.	2

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.