RepositoryItem.CustomDisplayText Event

Enables custom display text to be provided for an editor.

Namespace: DevExpress.XtraEditors.Repository

Assembly: DevExpress.XtraEditors.v18.1.dll

Declaration

C#

[DXCategory("Events")]
public event CustomDisplayTextEventHandler CustomDisplayText

VB.NET

<DXCategory("Events")>
Public Event CustomDisplayText As CustomDisplayTextEventHandler

Event Data

The CustomDisplayText event's data class is CustomDisplayTextEventArgs. The following properties provide information specific to this event:

Property	Description
DisplayText	Gets or sets an editor’s display text.
Value	Gets an editor’s current value.

Remarks

The CustomDisplayText event can be used to provide custom display text for an editor. The event fires when an editor has no focus.

To provide custom text, assign it to the event’s DisplayText parameter. Initially, this property contains the current display text, which is a formatted representation of the editor’s edit value. To access the editor’s edit value, use the Value parameter.

For ImageComboBoxEdit editors, the CustomDisplayText event only fires when no value is selected in the editor (the ComboBoxEdit.SelectedIndex is set to -1). When a value is selected, the CustomDisplayText event doesn’t fire. In this instance, the display text is specified by the selected item’s ImageComboBoxItem.Description property.

The CustomDisplayText event also fires for cells in a container control (e.g GridControl, etc) if a repository item object is assigned to the control’s column/cell for in-place editing. In display mode (when an in-place editor is not active), the CustomDisplayText event fires with the sender parameter, specifying a corresponding repository item object (the RepositoryItem class’ descendant). When an in-place editor is activated, the CustomDisplayText event doesn’t fire. However, it’s possible to disable the text editing feature via the RepositoryItemButtonEdit.TextEditStyle property. In this instance, when the editor is activated, the CustomDisplayText event fires with the sender parameter specifying a corresponding editor object (the BaseEdit class’ descendant).

After your CustomDisplayText event handler is complete, the display text may be modified according to the RepositoryItemTextEdit.CharacterCasing option.

The BaseEdit.CustomDisplayText event is equivalent to the current event.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the CustomDisplayText event.

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#

how-to-use-a-spreadsheet-control-as-an-in-place-editor-gridcontrol-propertygridcontrol-e4777/CS/WindowsFormsApplication1/Form1.cs#L29

propertyGridControl1.DefaultEditors.Add(typeof(DataTable), rePopupContainer);
rePopupContainer.CustomDisplayText += new DevExpress.XtraEditors.Controls.CustomDisplayTextEventHandler(rePopupContainer_CustomDisplayText);

how-to-display-custom-text-when-lookupedits-value-is-not-found-in-the-lookup-list-e781/CS/Form1.cs#L35

editor.DisplayMember = "Name";
editor.CustomDisplayText += new CustomDisplayTextEventHandler(RepositoryItemLookUpEdit_CustomDisplayText);

how-to-create-a-complex-filter-that-uses-mathematic-calculations-for-gridview-e2800/CS/WindowsApplication1/ComplexFilterHelper.cs#L54

RepositoryItemButtonEdit riBE = new RepositoryItemButtonEdit();
riBE.CustomDisplayText += riBE_CustomDisplayText;
riBE.Buttons[0].Kind = ButtonPredefines.Glyph;

how-to-configure-rating-control-t190685/CS/dxSample/MainForm.cs#L79

    riTextEdit.Mask.UseMaskAsDisplayFormat = true;
    riTextEdit.CustomDisplayText += riTextEdit_CustomDisplayText;
}

VB.NET

how-to-use-a-spreadsheet-control-as-an-in-place-editor-gridcontrol-propertygridcontrol-e4777/VB/WindowsFormsApplication1/Form1.vb#L31

propertyGridControl1.DefaultEditors.Add(GetType(DataTable), rePopupContainer)
AddHandler rePopupContainer.CustomDisplayText, AddressOf rePopupContainer_CustomDisplayText

how-to-display-custom-text-when-lookupedits-value-is-not-found-in-the-lookup-list-e781/VB/Form1.vb#L38

editor.DisplayMember = "Name"
AddHandler editor.CustomDisplayText, AddressOf RepositoryItemLookUpEdit_CustomDisplayText

how-to-create-a-complex-filter-that-uses-mathematic-calculations-for-gridview-e2800/VB/ComplexFilterHelper.vb#L56

Dim riBE As New RepositoryItemButtonEdit()
AddHandler riBE.CustomDisplayText, AddressOf riBE_CustomDisplayText
riBE.Buttons(0).Kind = ButtonPredefines.Glyph

how-to-display-a-custom-text-within-the-progressbar-working-in-in-place-mode-e1417/VB/WindowsApplication184/Form1.vb#L49

Private Sub repositoryItemProgressBar1_CustomDisplayText(ByVal sender As Object, ByVal e As DevExpress.XtraEditors.Controls.CustomDisplayTextEventArgs) Handles repositoryItemProgressBar1.CustomDisplayText
    Dim val As String = e.Value.ToString()

how-to-configure-rating-control-t190685/VB/dxSample/MainForm.vb#L81

    riTextEdit.Mask.UseMaskAsDisplayFormat = True
    AddHandler riTextEdit.CustomDisplayText, AddressOf riTextEdit_CustomDisplayText
End Sub