Sets the hotspot of the selection. The hotspot of the selection is the reference point for the transformations of the selected objects.

syntaxSyntax:
DlxSelection.SetHotspot()
DlxSelection.SetHotspot(point)

Parameters

Parameter Description
point A DlxPoint object with the coordinates specifying the point.

Return Value

If the operation ends correctly, it returns true otherwise it returns false.

Remarks

If the coordinates of the point are not specified, the hotspot is set in the center of the selection rectangle. The hotspot is updated when selection objects are added or removed.

Example

  Copy codeCopy code
var prj = DlxApp.GetJob().GetProject("Example Sch");
if (!prj.IsValid())
  prj = DlxApp.GetJob().NewProject("Example Sch");
var doc = prj.GetDocument("Examples Sch", DlxApp.DOCTYPE_SCHEMATIC);
if (!doc.IsValid())
{
  doc = prj.NewDocument("Examples Sch", DlxApp.DOCTYPE_SCHEMATIC);
  doc.SetPageFormat("A4", false);
}
if (doc.IsValid() && doc.Activate())
{
  var page = doc.GetActivePage();
  if (page.IsValid())
  {
    var layer = page.GetLayerFromType(DlxApp.LAYERTYPE_DRAWING);
    if (layer.IsValid())
    {
      // create objects
      var pen = new DlxPenStyle(0.5, new DlxColor("orangered"), "DASHED");
      doc.SetStyle(pen);
      var obj1 = layer.DrawLine(new DlxPoint(30, 30), new DlxPoint(80, 80));
      pen.SetWidth(1);
      doc.SetStyle(pen);
      var obj2 = layer.DrawLine(new DlxPoint(40, 30), new DlxPoint(90, 80));
      pen.SetDashStyle("SOLID");
      doc.SetStyle(pen);
      var obj3 = layer.DrawLine(new DlxPoint(50, 30), new DlxPoint(100, 80));
      // moves objects
      var selection = page.GetSelection();
      selection.Empty();
      selection.AddObject(obj1);
      selection.AddObject(obj2);
      selection.Move(80, 0);
      selection.SetHotspot(new DlxPoint(100, 80));
      selection.Rotate(135);
    }
  }
}

See also