LayoutView.CustomFieldCaptionStyle Event

Allows you to customize the appearance of field captions in cards.

Namespace: DevExpress.XtraGrid.Views.Layout

Assembly: DevExpress.XtraGrid.v19.2.dll

Declaration

C#

[DXCategory("Behavior")]
public event LayoutViewFieldCaptionStyleEventHandler CustomFieldCaptionStyle

VB.NET

<DXCategory("Behavior")>
Public Event CustomFieldCaptionStyle As LayoutViewFieldCaptionStyleEventHandler

Event Data

The CustomFieldCaptionStyle event's data class is DevExpress.XtraGrid.Views.Layout.Events.LayoutViewFieldCaptionStyleEventArgs.

Remarks

The CustomFieldCaptionStyle event fires for every card field when it’s about to be displayed on-screen. You can handle this event to provide different appearances for field captions in different cards. To customize the appearance settings, use the event’s Appearance property.

To identify the currently processed card, use the event’s RowHandle parameter. This specifies the handle of the card. To identify the currently processed card field, see the Column parameter.

Important

Never change cell values or modify the control’s layout on this event, or any other event designed to tune the control’s appearance. Any action that causes a layout update can cause the control to malfunction.

Example

The following code shows how to dynamically change the appearance of a card field’s caption in a Layout View via the LayoutView.CustomFieldCaptionStyle event. In the example, the font of a CategoryName field’s caption is changed only in the cards that contain the “Beverages” value in this field.

The result is shown below:

C#

using DevExpress.XtraGrid.Views.Base;
using DevExpress.XtraGrid.Views.Layout.Events;

private void layoutView1_CustomFieldCaptionStyle(object sender, 
    LayoutViewFieldCaptionStyleEventArgs e) {
    if(e.Column.FieldName != "CategoryName") return;
    LayoutView view = sender as LayoutView;
    bool isBeverage = view.GetRowCellValue(e.RowHandle, e.Column).ToString() == "Beverages";
    if (isBeverage) {
        e.Appearance.Font = new Font(e.Appearance.Font, FontStyle.Bold);
    }
}

VB.NET

Imports DevExpress.XtraGrid.Views.Layout.Events
Imports DevExpress.XtraGrid.Views.Layout

Private Sub LayoutView1_CustomFieldCaptionStyle(ByVal sender As System.Object, _
ByVal e As LayoutViewFieldCaptionStyleEventArgs) Handles LayoutView1.CustomFieldCaptionStyle
    If e.Column.FieldName <> "CategoryName" Then Return
    Dim view As LayoutView = TryCast(sender, LayoutView)
    Dim isBeverage As Boolean = view.GetRowCellValue(e.RowHandle, e.Column).ToString() = "Beverages"
    If isBeverage Then
        e.Appearance.Font = New Font(e.Appearance.Font, FontStyle.Bold)
    End If
End Sub