EA_OnPreNewConnector

Details

EA_OnPreNewConnector notifies Add-Ins that a new connector is about to be created on a diagram. It enables Add-Ins to permit or deny creation of a new connector.

This event occurs when a user drags a new connector from the Enterprise Architect UML Toolbox or Resources window, onto a diagram. The notification is provided immediately before the connector is created, so that the Add-In can disable addition of the connector.

Also look at EA_OnPostNewConnector.

Syntax

Function EA_OnPreNewConnector(Repository As EA.Repository, Info As EA.EventProperties) As Boolean

The EA_OnPreNewConnector function syntax contains the following elements:

Parameter

Type

Direction

Description

Info

EA.EventProperties

IN

Contains the following EventProperty Objects for the connector to be created:

  • Type: A string value corresponding to Connector.Type
  • Subtype: A string value corresponding to Connector.Subtype
  • Stereotype: A string value corresponding to Connector.Stereotype
  • ClientID: A long value corresponding to Connector.ClientID
  • SupplierID: A long value corresponding to Connector.SupplierID
  • DiagramID: A long value corresponding to Connector.DiagramID.

Repository

EA.Repository

IN

An EA.Repository object representing the currently open Enterprise Architect model. Poll its members to retrieve model data and user interface status information.

Return Value

Return True to enable addition of the new connector to the model. Return False to disable addition of the new connector.