Back to Devexpress

DiagramDataBindingControllerBase.GenerateConnector Event

windowsforms-devexpress-dot-xtradiagram-dot-diagramdatabindingcontrollerbase-7dd71064.md

latest4.6 KB
Original Source

DiagramDataBindingControllerBase.GenerateConnector Event

Fires before generating a connector from the data source and allows you to customize it.

Namespace : DevExpress.XtraDiagram

Assembly : DevExpress.XtraDiagram.v25.2.dll

NuGet Package : DevExpress.Win.Diagram

Declaration

csharp
public event EventHandler<DiagramGenerateConnectorEventArgs> GenerateConnector
vb
Public Event GenerateConnector As EventHandler(Of DiagramGenerateConnectorEventArgs)

Event Data

The GenerateConnector event's data class is DevExpress.XtraDiagram.DiagramGenerateConnectorEventArgs.

Remarks

By default, the uppermost connector defined in XAML within the DiagramDataBindingControllerBase.TemplateDiagram is used as the template for the connectors.

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

csharp
private void DiagramDataBindingController_GenerateConnector(object sender, DiagramGenerateConnectorEventArgs e) {
    if (e.DataObject is Link)
        e.Connector = e.CreateConnectorFromTemplate("CurvedConnector");
    else e.Connector = e.CreateConnectorFromTemplate("DefaultConnector");
}
vb
Private Sub DiagramDataBindingController_GenerateConnector(ByVal sender As Object, ByVal e As DiagramGenerateConnectorEventArgs)
    If TypeOf e.DataObject Is Link Then
        e.Connector = e.CreateConnectorFromTemplate("CurvedConnector")
    Else
        e.Connector = e.CreateConnectorFromTemplate("DefaultConnector")
    End If
End Sub

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the GenerateConnector 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.

winforms-generate-diagram-with-grouped-items/CS/DiagramDataControllerBehavior/Form1.cs#L24

csharp
diagramDataBindingController1.GenerateItem += DiagramDataBindingController1_GenerateItem;
diagramDataBindingController1.GenerateConnector += DiagramDataBindingController1_GenerateConnector;
diagramDataBindingController1.DataSource = viewModel.Departments;

winforms-generate-diagram-with-grouped-items/VB/DiagramDataControllerBehavior/Form1.vb#L26

vb
AddHandler diagramDataBindingController1.GenerateItem, AddressOf DiagramDataBindingController1_GenerateItem
AddHandler diagramDataBindingController1.GenerateConnector, AddressOf DiagramDataBindingController1_GenerateConnector
diagramDataBindingController1.DataSource = viewModel.Departments

See Also

ConnectorsSource

DiagramDataBindingControllerBase Class

DiagramDataBindingControllerBase Members

DevExpress.XtraDiagram Namespace