SolidWorksMakroprogrammierung

Methode · DatumTargetSym

SetTargetArea-Methode (DatumTargetSym)

Setzt Form und Größe des Zielbereichs: Punkt, Kreis oder Rechteck mit Durchmesser oder Breite und Höhe als Text.

Syntax

Function SetTargetArea( _
   ByVal Shape As Long, _
   ByVal Size1 As String, _
   ByVal Size2 As String _
) As Boolean
bOk = swStelle.SetTargetArea(swDatumTargetAreaRectangle, "10", "5")

Parameter

ShapeLongByVal
Die Form als Wert aus swDatumTargetAreaShape_e: swDatumTargetAreaNone (0), swDatumTargetAreaPoint (1), swDatumTargetAreaCircle (2) oder swDatumTargetAreaRectangle (3).
Size1StringByVal
Der Durchmesser oder die Breite des Zielbereichs als Text.
Size2StringByVal
Die Höhe des Zielbereichs als Text, nur beim Rechteck.

Rückgabewert

True, wenn Form und Größe gesetzt wurden, sonst False.

Beispiel

' swStelle ist ein Bezugsstellensymbol (DatumTargetSym), etwa aus View.GetFirstDatumTargetSym.
' swModel ist das Dokument (ModelDoc2).
Dim bOk As Boolean
bOk = swStelle.SetTargetArea(swDatumTargetAreaCircle, "6", "")
If bOk Then
    swModel.ActiveView.GraphicsRedraw Empty
    Debug.Print "Durchmesser " & swStelle.GetTargetAreaSize(0)
End If

Bemerkungen

Je nach Form gilt:

  • Punkt: eine Größe, die leer sein darf, mit Durchmesserzeichen in der oberen Hälfte des Symbols.
  • Kreis: eine Größe, mit Durchmesserzeichen in der oberen Hälfte des Symbols.
  • Rechteck: zwei Größen, in der oberen Hälfte durch ein „x“ getrennt.

Ist Shape keiner der Werte aus swDatumTargetAreaShape_e, ändert SOLIDWORKS das Symbol nicht und die Methode liefert False. Was du bei Punkt und Kreis in Size2 übergibst, sagt die Hilfe nicht. Das Beispiel übergibt einen leeren Text. Ob die Größe als Zahl in der Einheit des Dokuments gelesen wird oder nur als Text erscheint, sagt die Hilfe ebenfalls nicht.

Danach zeichnest du neu, damit die Änderung zu sehen ist. Die Hilfe nennt dafür das veraltete ModelDoc2.GraphicsRedraw2, der Nachfolger ist ModelView.GraphicsRedraw.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2000

Englisches Original: IDatumTargetSym::SetTargetArea in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.