TextEditAdvancedModeOptions.UseDirectXPaint Property

Gets or sets whether an editor uses the DirectX Hardware Acceleration. DirectX is required to support some of the unique editor features available when this editor is in Advanced Mode. See this property for more information about this mode: RepositoryItemTextEdit.UseAdvancedMode.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v21.2.dll

NuGet Packages: DevExpress.Win.Design, 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	Specifies whether the editor uses the DirectX or traditional GDI renderer.

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.

Property Paths

You can access this nested property as listed below:

Object Type	Path to UseDirectXPaint
RepositoryItemTextEdit	.AdvancedModeOptions .UseDirectXPaint

Remarks

TextEdit-based editors use the standard GDI renderer even when you turn on the DirectX Hardware Acceleration in the Project Settings Page or call the global WindowsFormsSettings.ForceDirectXPaint() method. You need to enable this TextEditAdvancedModeOptions.UseDirectXPaint property for every editor that should operate in this mode.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the UseDirectXPaint property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-memo-editor-advanced-mode/CS/MemoEditSample/Views/DemoView.cs#L20

fluent.SetBinding(memoEdit.Properties, me => me.ScrollBars, x => x.ScrollBars);
fluent.SetBinding(memoEdit.Properties.AdvancedModeOptions, me => me.UseDirectXPaint, x => x.UseDirectXPaint);
fluent.SetBinding(memoEdit, me => me.EditValue, x => x.Text);

VB.NET

winforms-memo-editor-advanced-mode/VB/MemoEditSample/Views/DemoView.vb#L23

fluent.SetBinding(memoEdit.Properties, Function([me]) [me].ScrollBars, Function(x) x.ScrollBars)
fluent.SetBinding(memoEdit.Properties.AdvancedModeOptions, Function([me]) [me].UseDirectXPaint, Function(x) x.UseDirectXPaint)
fluent.SetBinding(memoEdit, Function([me]) [me].EditValue, Function(x) x.Text)