IME Support
RadRichTextBox provides built-in support for the most commonly used Microsoft IMEs like Chinese IME, Japanese IME, Korean IME and etc., which are shipped with the Windows OS. Further, you can easily add support for the IME which is used in your application.
When working with the IME inside RadRichTextBox, moving the caret position or performing a selection inside the composition will be disabled.
Use Previous Version of Microsoft IME
The RadRichTextBox class exposes the UsePreviousVersionOfMicrosoftIme property. It controls whether the previous version of the Microsoft IME will be used.
When using Japanese, the UsePreviousVersionOfMicrosoftIme property needs to be synchronized with the OS settings. To learn more about how to revert to the previous version of the IME, you check this article.
Reverting to the previous version of Microsoft IME
public partial class MainWindow : Window
{
public MainWindow()
{
InitializeComponent();
this.radRichTextBox.Loaded += RadRichTextBox_Loaded;
}
private void RadRichTextBox_Loaded(object sender, RoutedEventArgs e)
{
this.radRichTextBox.UsePreviousVersionOfMicrosoftIme = true;
}
}
Public Partial Class MainWindow
Inherits Window
Public Sub New()
InitializeComponent()
Me.radRichTextBox.Loaded += AddressOf RadRichTextBox_Loaded
End Sub
Private Sub RadRichTextBox_Loaded(ByVal sender As Object, ByVal e As RoutedEventArgs)
Me.radRichTextBox.UsePreviousVersionOfMicrosoftIme = True
End Sub
End Class
Caret class
The caret is the UI which shows where the current document position is. It is represented by the Caret class. It also provides ability to modify the text. It exposes several events which are corresponding to the relevant text operation.
-
TextInputStart—This event is fired when a UI element initially gets text. -
TextInputUpdate—This event is fired when text continues to be composed and IME is used. -
TextInput—This event is fired when the text should be committed.
Additionally, the Caret class also exposes the CurrentImeLanguage property, which provides information about the current IME language. It is of the type of ImeLanguage and it can return one of the following options:
-
Korean—The current IME language is Korean. -
Japanese—The current IME language is Japanese. -
Chinese—The current IME language is Chinese. -
Other—The current IME language is not Korean, Japanese, nor Chinese.
How the text is inserted in RadRichTextBox?
The CaretTextInputHandler class is responsible for the text insertion in RadRichTextBox. It is attached to the Caret’s TextInserted event, which has TextInsertedEventArgs as event arguments.
The TextInsertedEventArgs class exposes the following properties:
-
Text—This property represents the text which is entered. -
ImeLanguage—This property provides information about the current IME language. -
CurrentEvent—This property contains the type of action that is performed that raises the TextInserted event. It is of the type ofInputEventsand the possible events are as follows:-
OnTextInputStart—This action will be present when starting a new text input. -
OnTextInputUpdate—This action will be present when updating the text input. -
OnTextInput—This action will be present when ending the text input. -
OnStandardTextInput—This action will be present when insering standart text without using the IME.
-
With the 2025 Q1 release, the
ShouldPersistandShouldStartNewCompositionproperties of the TextInsertedEventArgs class are now obsoleted. To learn more about the obsoleted API, check the Breaking Changes article.
When you are executing your logic in the overridden Caret event handlers, it is important to execute the OnTextInserted method with the desired TextInsertedEventArgs, so the TextInserted event will be fired and the CaretTextInputHandler will process the text depending on the arguments.
Custom IME Support
If you want to add support for another input method editor, you can easily achieve it by creating a custom caret and plug it in the RadRichTextBox. Here is what is necessary to know before doing that.
ICaretFactory interface
The ICaretFactory interface has a CreateCaret method which is responsible for the caret creation. It returns the caret which should handle the text input.
How to implement your own IME support?
To achieve a different than the Microsoft IME support, you should implement your own caret which inherits RadRichTextBox’s Caret class and overrides the handlers of the above mentioned events. In these overridden methods you can execute the specific logic for the corresponding input method editor.
Extending the Caret class
public class SogouCaret : Caret
{
protected override void OnTextInputStart(object sender, TextCompositionEventArgs e)
protected override void OnTextInputUpdate(object sender, TextCompositionEventArgs e)
protected override void OnTextInput(TextCompositionEventArgs e)
}
Public Class SogouCaret
Inherits Caret
Protected Overloads Sub OnTextInputStart(ByVal sender As Object, ByVal e As TextCompositionEventArgs)
Protected Overloads Sub OnTextInputUpdate(ByVal sender As Object, ByVal e As TextCompositionEventArgs)
Protected Overloads Sub OnTextInput(ByVal e As TextCompositionEventArgs)
End Class
The inherited caret should be created by a factory class, which should implement the ICaretFactory interface.
Implementing a custom caret factory
public class SogouCaretFactory : ICaretFactory
{
public Caret CreateCaret()
{
return new SogouCaret();
}
}
Public Class SogouCaretFactory
Implements ICaretFactory
Public Function CreateCaret() As Caret Implements ICaretFactory.CreateCaret
Return New SogouCaret()
End Function
End Class
The last thing you should do, is to set the RadRichTextBox’ CaretFactory property to be your factory class.
Setting the custom caret factory
this.radRichTextBox.CaretFactory = new SogouCaretFactory();
Me.radRichTextBox.CaretFactory = new SogouCaretFactory()
You can download a runnable project of the previous example from our online SDK repository here.