SolidWorksMakroprogrammierung

Methode · DrawingDoc

InsertCenterMark3-Methode (DrawingDoc)

Fügt eine Mittelpunktmarkierung in die Zeichnung ein und liefert sie zurück.

Syntax

Function InsertCenterMark3( _
   ByVal Style As Long, _
   ByVal Propagate As Boolean, _
   ByVal Slot As Boolean _
) As CenterMark
Set swCenterMark = swDraw.InsertCenterMark3(swCenterMark_Single, False, False)

Parameter

StyleLongByVal

Art der Mittelpunktmarkierung als swCenterMarkStyle_e:

  • swCenterMark_Single (2): einzelne Mittelpunktmarkierung
  • swCenterMark_LinearGroup (3): lineare Gruppe
  • swCenterMark_CircularGroup (4): kreisförmige Gruppe
  • swCenterMark_NonAnnotation (1): dem Namen nach eine Markierung, die keine Beschriftung ist. Die Hilfe erklärt den Wert nicht.
PropagateBooleanByVal
True, wenn die Mittelpunktmarkierung auf das ganze Muster übertragen werden soll, sonst False.
SlotBooleanByVal
True für eine Mittelpunktmarkierung im Stil für Langlöcher, sonst False.

Rückgabewert

Die neue Mittelpunktmarkierung (CenterMark).

Beispiel

' swModel ist die aktive Zeichnung (ModelDoc2), swDraw dasselbe Dokument als DrawingDoc.
' Vorher in einer Zeichenansicht eine Kreiskante auswählen.
Dim swCenterMark As SldWorks.CenterMark
Dim swAnn As SldWorks.Annotation
Set swCenterMark = swDraw.InsertCenterMark3(swCenterMark_Single, False, False)
If swCenterMark Is Nothing Then
    Debug.Print "Keine Mittelpunktmarkierung eingefügt."
Else
    Set swAnn = swCenterMark.GetAnnotation
    Debug.Print "Neu: " & swAnn.GetName & ", Stil " & swCenterMark.Style
End If
swModel.ClearSelection2 True

Bemerkungen

Was vorher ausgewählt sein muss, sagt die Hilfe nicht. Der alte Vorgänger DrawingDoc.InsertCenterMark erzeugte die Markierung aus der zuletzt ausgewählten Kante, vermutlich gilt das hier genauso. Was bei einem Fehler zurückkommt, ist nicht dokumentiert. Prüf das Ergebnis mit Is Nothing.

Größe und Darstellung sind keine Parameter. Dem Namen nach änderst du sie danach über Eigenschaften von CenterMark, etwa CenterMark.Size oder CenterMark.ShowLines.

Willst du Mittelpunktmarkierungen automatisch in ganze Ansichten setzen, verweist die Hilfe auf AutoInsertCenterMarks. Dessen aktueller Nachfolger ist View.AutoInsertCenterMarks2.

Ersetzt DrawingDoc.InsertCenterMark2, dem der Parameter Slot fehlte.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2009

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

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