LayoutViewCardDifferences.AddItemDifference(String, LayoutItemDifferenceType, Object) Method

Adds a difference record, identifying how a layout item’s (card field’s) settings differ from the default settings.

Namespace: DevExpress.XtraGrid.Views.Layout

Assembly: DevExpress.XtraGrid.v19.1.dll

Declaration

C#

public void AddItemDifference(
    string itemName,
    LayoutItemDifferenceType type,
    object value
)

VB.NET

Public Sub AddItemDifference(
    itemName As String,
    type As LayoutItemDifferenceType,
    value As Object
)

Parameters

Name	Type	Description
itemName	String	A string that identifies the layout item (card field).
type	LayoutItemDifferenceType	A LayoutItemDifferenceType value that specifies the setting to be changed
value	Object	A new value for the setting.

Remarks

The itemName parameter specifies a card field’s name (the name of a corresponding LayoutViewField object). Groups, tabbed groups, separators, etc are also identified by names.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the AddItemDifference(String, LayoutItemDifferenceType, Object) method.

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-display-records-of-different-types-in-the-same-grid-e446/CS/WindowsApplication16/Form1.cs#L57

{
    e.CardDifferences.AddItemDifference(colTitleName,
        LayoutItemDifferenceType.ItemVisibility, true);

how-to-implement-an-expandable-layoutview-e1716/CS/WindowsApplication3/Main.cs#L25

if(e.RowHandle == view.FocusedRowHandle) {
    e.CardDifferences.AddItemDifference("Group1", LayoutItemDifferenceType.GroupExpanded, true);
}

VB.NET

how-to-display-records-of-different-types-in-the-same-grid-e446/VB/WindowsApplication16/Form1.vb#L47

If p.GetType() Is GetType(Employee) Then
    e.CardDifferences.AddItemDifference(colTitleName, LayoutItemDifferenceType.ItemVisibility, True)
    e.CardDifferences.AddItemDifference(colTotalTurnover, LayoutItemDifferenceType.ItemVisibility, False)

how-to-implement-an-expandable-layoutview-e1716/VB/WindowsApplication3/Main.vb#L27

If e.RowHandle = view.FocusedRowHandle Then
    e.CardDifferences.AddItemDifference("Group1", LayoutItemDifferenceType.GroupExpanded, True)
End If