windowsforms-devexpress-dot-xtraeditors-dot-repository-dot-repositoryitemtextedit.md
Switches the editor to Advanced Mode. This mode supports new caret and selection animations, emojis, and embedded labels. You can set up properties from the RepositoryItemTextEdit.AdvancedModeOptions group to choose which Advanced Mode features are enabled.
Namespace : DevExpress.XtraEditors.Repository
Assembly : DevExpress.XtraEditors.v25.2.dll
NuGet Package : DevExpress.Win.Navigation
[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Appearance")]
public DefaultBoolean UseAdvancedMode { get; set; }
<DXCategory("Appearance")>
<DefaultValue(DefaultBoolean.Default)>
Public Property UseAdvancedMode As DefaultBoolean
| Type | Default | Description |
|---|---|---|
| DefaultBoolean | Default |
Specifies whether Advanced Mode is on. The Default value is identical to False.
|
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
|
You must set the UseAdvancedMode property before the Form’s handle is created.
public partial class Form1 : DevExpress.XtraEditors.XtraForm {
public Form1() {
InitializeComponent();
textEdit1.Properties.UseAdvancedMode = DevExpress.Utils.DefaultBoolean.True;
textEdit1.Properties.AdvancedModeOptions.Label = "Product Name";
}
}
Partial Public Class Form1
Inherits DevExpress.XtraEditors.XtraForm
Public Sub New()
InitializeComponent()
textEdit1.Properties.UseAdvancedMode = DevExpress.Utils.DefaultBoolean.True
textEdit1.Properties.AdvancedModeOptions.Label = "Product Name"
End Sub
End Class
Enable the static WindowsFormsSettings.UseAdvancedTextEdit property to activate Advanced Mode for all TextEdit-based editors in your application.
namespace DXApplication {
internal static class Program {
[STAThread]
static void Main() {
DevExpress.XtraEditors.WindowsFormsSettings.UseAdvancedTextEdit = DevExpress.Utils.DefaultBoolean.True;
Application.EnableVisualStyles();
Application.SetCompatibleTextRenderingDefault(false);
Application.Run(new Form1());
}
}
public partial class Form1 : DevExpress.XtraEditors.XtraForm {
public Form1() {
InitializeComponent();
textEdit1.Properties.AdvancedModeOptions.Label = "Product Name";
dateEdit1.Properties.AdvancedModeOptions.Label = "Delivery Date";
}
}
}
Namespace DXApplication
Friend NotInheritable Class Program
Private Sub New()
End Sub
<STAThread>
Shared Sub Main()
DevExpress.XtraEditors.WindowsFormsSettings.UseAdvancedTextEdit = DevExpress.Utils.DefaultBoolean.True
Application.EnableVisualStyles()
Application.SetCompatibleTextRenderingDefault(False)
Application.Run(New Form1())
End Sub
End Class
Partial Public Class Form1
Inherits DevExpress.XtraEditors.XtraForm
Public Sub New()
InitializeComponent()
textEdit1.Properties.AdvancedModeOptions.Label = "Product Name"
dateEdit1.Properties.AdvancedModeOptions.Label = "Delivery Date"
End Sub
End Class
End Namespace
Advanced Mode activates the following features:
The redesigned control painter enables more responsive and smooth animations.
To disable these effects, use AdvancedModeOptions.AllowCaretAnimation and AdvancedModeOptions.AllowSelectionAnimation properties.
The selection color depends on the current application skin.
The autocomplete functionality displays suggestions to complete words that a user types in a text editor.
Use the AutoCompleteMode property to enable the autocomplete functionality. You can choose one of the following options:
Suggest - The editor displays a drop-down list with suggestions when a user types the first word in the edit box.
Append - The editor automatically completes the first entered word in the edit box. The editor uses the first matching suggestion from a source of suggestions.
SuggestAppend - The editor uses a combination of the Append and Suggest options — it automatically completes the first word in the edit box, and displays a drop-down list with suggestions.
SuggestSingleWord - The editor displays a drop-down list with custom suggestions every time a user types a new word in the edit box. The editor automatically sets the AutoCompleteSource option to CustomSource in SuggestSingleWord mode. Use the CustomizeAutoCompleteSource event, or AutoCompleteCustomSource collection to specify the custom auto-complete suggestions.
Use the AutoCompleteSource property to specify the source of autocomplete strings. To supply custom autocomplete strings, set the AutoCompleteSource property to CustomSource, then handle the CustomizeAutoCompleteSource event or populate the TextEditAdvancedModeOptions.AutoCompleteCustomSource collection.
You can use ShowAutoCompletePopup() and CloseAutoCompletePopup() methods to control the visibility of the drop-down list with autocomplete suggestions.
Set the AdvancedModeOptions.Label property to display an editor caption inside the text box. This caption moves upward when the editor is focused.
Use the AdvancedModeOptions.LabelAppearance property to customize appearance settings of the embedded label (caption).
Note that to accommodate both an embedded label and its input value, the editor increases its height.
Users can press “Win+.“ to enter emojis from the Windows library. If the AdvancedModeOptions.UseDirectXPaint property is disabled, emojis are grayed out.
You can handle the TextEdit.CustomHighlightText (or RepositoryItemTextEdit.CustomHighlightText) event to highlight or paint specific strings within the control’s text in a custom manner:
Set the TextEditAdvancedModeOptions.ShortcutsEnabled property to false to disable all keyboard shortcuts within the editor.
The WXI vector skin utilizes Advanced Mode to paint rounded editor corners and color accents. Advanced Mode cannot be disabled while this skin is active.
Important
In Advanced Mode or when the WXI Skin is applied, use the Appearance.BackColor property to specify the editor’s background color. Other appearance settings that specify the background color of the editor in different states are ignored (for example, the AppearanceReadOnly.BackColor, AppearanceFocused.BackColor, AppearanceDisabled.BackColor).
if (textEdit1.Properties.ReadOnly) {
textEdit1.Properties.Appearance.BackColor = Color.LightGray;
}
If textEdit1.Properties.ReadOnly Then
textEdit1.Properties.Appearance.BackColor = Color.LightGray
End If
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the UseAdvancedMode 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.
winforms-memo-editor-advanced-mode/CS/MemoEditSample/Views/DemoView.cs#L18
fluent.SetBinding(memoEdit.Properties, me => me.WordWrap, x => x.WordWrap);
fluent.SetBinding(memoEdit.Properties, me => me.UseAdvancedMode, x => x.UseAdvancedMode);
fluent.SetBinding(memoEdit.Properties, me => me.ScrollBars, x => x.ScrollBars);
winforms-memo-editor-advanced-mode/VB/MemoEditSample/Views/DemoView.vb#L21
fluent.SetBinding(memoEdit.Properties, Function([me]) [me].WordWrap, Function(x) x.WordWrap)
fluent.SetBinding(memoEdit.Properties, Function([me]) [me].UseAdvancedMode, Function(x) x.UseAdvancedMode)
fluent.SetBinding(memoEdit.Properties, Function([me]) [me].ScrollBars, Function(x) x.ScrollBars)
See Also