DiagramDataBindingControllerBase.GenerateItem Event

Fires before generating a diagram item representing a data object and allows you to customize it.

Namespace: DevExpress.XtraDiagram

Assembly: DevExpress.XtraDiagram.v19.2.dll

Declaration

C#

public event EventHandler<DiagramGenerateItemEventArgs> GenerateItem

VB.NET

Public Event GenerateItem As EventHandler(Of DiagramGenerateItemEventArgs)

Event Data

The GenerateItem event's data class is DevExpress.XtraDiagram.DiagramGenerateItemEventArgs.

Remarks

By default, the uppermost diagram item defined in XAML within the DiagramDataBindingControllerBase.TemplateDiagram is used as the template for the diagram items representing data objects.

You can use the GenerateItem event to implement custom logic for choosing the item template. To do this, create diagram items in the DiagramDataBindingControllerBase.TemplateDiagram and specify their names using the DiagramItem.TemplateName property. Specify the name of the desired template as the event’s CreateItemFromTemplate method parameter and assign the method return value to the event’s Item property. See the example below.

C#

private void DiagramDataBindingController_GenerateItem(object sender, DiagramGenerateItemEventArgs e) {
    if (e.DataObject is PentagonDataItem)
        e.Item = e.CreateItemFromTemplate("PentagonShape");
    else e.Item = e.CreateItemFromTemplate("DefaultItem");
}

VB.NET

Private Sub DiagramDataBindingController_GenerateItem(ByVal sender As Object, ByVal e As DiagramGenerateItemEventArgs)
    If TypeOf e.DataObject Is PentagonDataItem Then
        e.Item = e.CreateItemFromTemplate("PentagonShape")
    Else
        e.Item = e.CreateItemFromTemplate("DefaultItem")
    End If
End Sub