Back to Devexpress

OverlayWindowOptions.UseDirectX Property

windowsforms-devexpress-dot-xtrasplashscreen-dot-overlaywindowoptions-e64d1340.md

latest3.7 KB
Original Source

OverlayWindowOptions.UseDirectX Property

Gets or sets whether DirectX is used to render an Overlay Form.

Namespace : DevExpress.XtraSplashScreen

Assembly : DevExpress.XtraEditors.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

csharp
public bool? UseDirectX { get; set; }
vb
Public Property UseDirectX As Boolean?

Property Value

TypeDescription
Nullable<Boolean>

true , to use DirectX; false , to use GDI+; null to use the default engine. The default engine is DirectX if the Use DirectX option is enabled in the Project settings; otherwise, the default engine is GDI+.

|

Property Paths

You can access this nested property as listed below:

LibraryObject TypePath to UseDirectX
WinForms ControlsOverlayWindowOptions

.Default .UseDirectX

| | XAF: Cross-Platform .NET App UI & Web API | DefaultOverlayFormOptions |

.Options .UseDirectX

|

Remarks

You can enable the Use DirectX option in the Project Settings to use DirectX Hardware Acceleration for all compatible DevExpress controls in the application.

The UseDirectX property allows you to specify the draw engine for Overlay Forms only. This property value takes priority over the global option specified in the Project Settings. If this property is set to null , the application uses the default engine. The default engine is DirectX if the Use DirectX option is enabled in the Project settings; otherwise, the default engine is GDI+.

csharp
using DevExpress.XtraSplashScreen;

// Default setting applied to all Overlay Forms.
DevExpress.XtraSplashScreen.OverlayWindowOptions.Default.UseDirectX = true;

// Setting for an individual Overlay Form.
IOverlaySplashScreenHandle handle = SplashScreenManager.ShowOverlayForm(
    owner: gridControl1,
    useDirectX: true
);
vb
Imports DevExpress.XtraSplashScreen

' Default setting applied to all Overlay Forms.
DevExpress.XtraSplashScreen.OverlayWindowOptions.Default.UseDirectX = True

' Setting for an individual Overlay Form.
Dim formHandle As IOverlaySplashScreenHandle = SplashScreenManager.ShowOverlayForm(
    owner:=gridControl1,
    useDirectX:=True
)

See Also

DirectX Hardware Acceleration

OverlayWindowOptions Class

OverlayWindowOptions Members

DevExpress.XtraSplashScreen Namespace