RowCellCustomDrawEventArgs.DisplayText Property

Gets or sets the painted element’s display text.

Namespace: DevExpress.XtraGrid.Views.Base

Assembly: DevExpress.XtraGrid.v18.2.dll

Declaration

C#

public string DisplayText { get; set; }

VB.NET

Public Property DisplayText As String

Property Value

Type	Description
String	A string value representing the element’s display text.

Remarks

Initially, the DisplayText property value contains the element’s default text representation.

If painting a data cell (via the GridView.CustomDrawCell, CardView.CustomDrawCardFieldValue and LayoutView.CustomDrawCardFieldValue events), the DisplayText property returns the cell’s display text formatted as specified by the column’s GridColumn.DisplayFormat property.

If painting a card field (via the CardView.CustomDrawCardField event) and card field caption (via the CardView.CustomDrawCardFieldCaption and LayoutView.CustomDrawCardFieldCaption events), the DisplayText property initially contains the card field caption.

The DisplayText property can be used in two ways:

• read the property value and manually paint the default text;
• change the DisplayText property value and leave the event’s CustomDrawEventArgs.Handled parameter set to false. In this case, the element will be painted using the default mechanism but with the modified text.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the DisplayText 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#

gridview-text-automatically-scrolls-horizontally-when-it-doesnt-fit-into-cell-bounds-e2438/CS/GridCellsCreepingLine/Form1.cs#L48

{
    if(e.DisplayText == Convert.ToString(e.CellValue))
        e.DisplayText = e.DisplayText + ' ';

how-to-change-colors-of-a-highlighted-text-corresponding-to-a-search-string-of-find-panel-e3260/CS/WindowsApplication3/Main.cs#L50

{
    int index = FindSubStringStartPosition(e.DisplayText, findText);
    if (index == -1)

how-to-make-richedit-highlight-strings-that-match-the-find-panel-text-e4422/CS/E4422/Form1.cs#L34

if (e.Column == colDescription && !string.IsNullOrEmpty(gridView1.FindFilterText)) {
    server.Text = e.DisplayText;
    Document document = server.Document;

how-to-filter-the-gridview-across-all-columns-and-highlight-the-matched-text-e2508/CS/GridViewFilter.cs#L66

args.Bounds = e.Bounds;
args.Text = e.DisplayText;
args.Appearance.Assign(e.Appearance);

how-to-change-an-in-place-buttonedit-button-caption-in-different-rows-of-xtragrid-e903/CS/Form1.cs#L47

    ButtonEditViewInfo editInfo = (ButtonEditViewInfo)((DevExpress.XtraGrid.Views.Grid.ViewInfo.GridCellInfo)e.Cell).ViewInfo;
    editInfo.RightButtons[0].Button.Caption = e.DisplayText;
}

VB.NET

gridview-text-automatically-scrolls-horizontally-when-it-doesnt-fit-into-cell-bounds-e2438/VB/GridCellsCreepingLine/Form1.vb#L47

If szCellValue.Width > e.Bounds.Width Then
    If e.DisplayText = Convert.ToString(e.CellValue) Then e.DisplayText = e.DisplayText + " "c
    Dim letter As Char = e.DisplayText(0)

how-to-change-colors-of-a-highlighted-text-corresponding-to-a-search-string-of-find-panel-e3260/VB/WindowsApplication3/Main.vb#L50

Private Function HiglightSubString(ByVal e As DevExpress.XtraGrid.Views.Base.RowCellCustomDrawEventArgs, ByVal findText As String) As Boolean
    Dim index As Integer = FindSubStringStartPosition(e.DisplayText, findText)
    If index = -1 Then

how-to-make-richedit-highlight-strings-that-match-the-find-panel-text-e4422/VB/E4422/Form1.vb#L36

If e.Column Is colDescription AndAlso (Not String.IsNullOrEmpty(gridView1.FindFilterText)) Then
    server.Text = e.DisplayText
    Dim document As Document = server.Document

how-to-filter-the-gridview-across-all-columns-and-highlight-the-matched-text-e2508/VB/GridViewFilter.vb#L67

args.Bounds = e.Bounds
args.Text = e.DisplayText
args.Appearance.Assign(e.Appearance)

how-to-change-an-in-place-buttonedit-button-caption-in-different-rows-of-xtragrid-e903/VB/Form1.vb#L43

    Dim editInfo As ButtonEditViewInfo = CType((CType(e.Cell, DevExpress.XtraGrid.Views.Grid.ViewInfo.GridCellInfo)).ViewInfo, ButtonEditViewInfo)
    editInfo.RightButtons(0).Button.Caption = e.DisplayText
End If