doActivate method

void doActivate()

Start the relinking operation.

Find the relink handle by calling Tool#findToolHandleAt looking for either the "RelinkFrom" adornment or the "RelinkTo" adornment, saving the result in #handle.

Normally when this method is called the value of LinkingBaseTool#originalLink and #handle will be null, resulting in a call to Tool#findToolHandleAt to find a "RelinkFrom" or "RelinkTo" tool handle, which is then remembered as the value of #handle. If when this method is called the value of #handle is already set, then there is no need to call Tool#findToolHandleAt, because the programmer has already set up which relinking handle they want the user to be relinking. Finding a handle is not necessary if LinkingBaseTool#originalLink and #isForwards have been set before calling this method.

This starts a transaction, captures the mouse, and sets the cursor.

If LinkingBaseTool#originalLink or #handle was not set beforehand, the value of #isForwards is set depending on the category of the relink handle found. The LinkingBaseTool#originalLink property and various "Original..." port and node properties are set too. The temporary nodes and temporary link are also initialized.

This method may be overridden, but we recommend that you call this base method.

Implementation

void doActivate() {
  _i4.callMethod(
    this,
    'doActivate',
    [],
  );
}