Gets or sets whether an event was handled. If it was handled, the default actions are not required.
Namespace: DevExpress.XtraRichEdit
Assembly: DevExpress.RichEdit.v19.2.Core.dll
| Type | Description |
|---|---|
| Boolean | true if it was handled and the default dialog doesn't need to be shown; otherwise, false. |
| Type | Description |
|---|---|
| Boolean | true if it was handled and the default dialog doesn't need to be shown; otherwise, false. |
If the event parameter's Handled property is set to true within a handler, then the default dialog will not be shown. Otherwise, the default dialog will be invoked after the custom actions within the handler have been performed.
Use the Handled property set to true with the ShowFormEventArgs.DialogResult parameter, to substitute a standard dialog with a custom one.
This example demonstrates how to replace the standard Find and Replace dialog with a custom one via the RichEditControl.SearchFormShowing event.
A complete sample project is available at https://github.com/DevExpress-Examples/how-to-customize-dialog-forms-in-xtrarichedit-suite-e3095
private void richEditControl1_SearchFormShowing(object sender, SearchFormShowingEventArgs e)
{
string curWord = richEditControl1.Document.GetText(richEditControl1.Document.Selection);
MySearchTextForm form = new MySearchTextForm(e.ControllerParameters, curWord);
e.DialogResult = form.ShowDialog();
e.Handled = true;
}
using System.Drawing;
using DevExpress.XtraRichEdit.Forms;
namespace CustomDialogs
{
public partial class MySearchTextForm : SearchTextForm
{
public MySearchTextForm(SearchFormControllerParameters controllerParameters, string searchWord)
: base(controllerParameters)
{
lblFndDirection.Location = new Point (lblFndDirection.Location.X - 10, lblFndDirection.Location.Y);
lblFndDirection.Text = "Direction:";
cbFndSearchString.Text = searchWord;
chbFndRegex.Enabled = false;
}
}
}
Imports Microsoft.VisualBasic
Imports System.Drawing
Imports DevExpress.XtraRichEdit.Forms
Namespace CustomDialogs
Partial Public Class MySearchTextForm
Inherits SearchTextForm
Public Sub New(ByVal controllerParameters As SearchFormControllerParameters, ByVal searchWord As String)
MyBase.New(controllerParameters)
lblFndDirection.Location = New Point (lblFndDirection.Location.X - 10, lblFndDirection.Location.Y)
lblFndDirection.Text = "Direction:"
cbFndSearchString.Text = searchWord
chbFndRegex.Enabled = False
End Sub
End Class
End Namespace
Private Sub richEditControl1_SearchFormShowing(ByVal sender As Object, ByVal e As SearchFormShowingEventArgs) Handles richEditControl1.SearchFormShowing
Dim curWord As String = richEditControl1.Document.GetText(richEditControl1.Document.Selection)
Dim form As New MySearchTextForm(e.ControllerParameters, curWord)
e.DialogResult = form.ShowDialog()
e.Handled = True
End Sub