SolidWorksMakroprogrammierung

Methode · DrawingDoc

InsertModelAnnotations4-Methode (DrawingDoc)

Fügt Modellelemente wie Bemaßungen, Beschriftungen und Referenzgeometrie aus dem Modell in die ausgewählte Zeichenansicht ein.

Syntax

Function InsertModelAnnotations4( _
   ByVal Option As Long, _
   ByVal Types As Long, _
   ByVal AllViews As Boolean, _
   ByVal DuplicateDims As Boolean, _
   ByVal HiddenFeatureDims As Boolean, _
   ByVal UsePlacementInSketch As Boolean, _
   ByVal InsertAllAnnotations As Boolean, _
   ByVal InsertAllReferenceGeometry As Boolean _
) As Variant
vAnnotationen = swDraw.InsertModelAnnotations4(swImportModelItemsFromEntireModel, swInsertDimensionsMarkedForDrawing, False, True, False, False, False, False)

Parameter

OptionLongByVal

Woher die Elemente kommen, als Wert von swImportModelItemsSource_e:

  • swImportModelItemsFromEntireModel (0): ganzes Modell
  • swImportModelItemsFromSelectedFeature (1): ausgewähltes Feature
  • swImportModelItemsFromSelectedComponent (2): ausgewählte Komponente
  • swImportModelItemsFromAssemblyOnly (3): dem Namen nach nur die Baugruppe selbst
TypesLongByVal

Welche Arten von Elementen eingefügt werden, Werte aus swInsertAnnotation_e, mehrere mit Or kombiniert. Der Wert gilt nur, wenn InsertAllAnnotations und InsertAllReferenceGeometry beide False sind. Gängige Werte:

  • swInsertDimensionsMarkedForDrawing (32768): Bemaßungen, die für die Zeichnung markiert sind
  • swInsertDimensions (8): Bemaßungen
  • swInsertNotes (64): Hinweise
  • swInsertGTols (32): Form- und Lagetoleranzen
  • swInsertholeCallout (1048576): Bohrungsbeschreibungen
  • swInsertAxes (512): Achsen
  • swInsertPlanes (2048): Ebenen
AllViewsBooleanByVal
True fügt die Elemente in alle Ansichten der Zeichnung ein, False nur in die ausgewählte Ansicht.
DuplicateDimsBooleanByVal
True lässt doppelte Bemaßungen weg, False erlaubt doppelte Bemaßungen.
HiddenFeatureDimsBooleanByVal
True fügt auch Bemaßungen ausgeblendeter Features ein, False nicht.
UsePlacementInSketchBooleanByVal
True setzt die Bemaßungen so, wie sie in der Skizze platziert sind, False nicht.
InsertAllAnnotationsBooleanByVal
True fügt alle Beschriftungen ein, False nur die in Types genannten.
InsertAllReferenceGeometryBooleanByVal
True fügt die gesamte Referenzgeometrie ein, False nur die in Types genannte.

Rückgabewert

Array mit den eingefügten Beschriftungen (Annotation). Was zurückkommt, wenn nichts eingefügt wurde, sagt die Hilfe nicht. Prüf das Ergebnis deshalb mit IsArray.

Beispiel

' swDraw ist die aktive Zeichnung (DrawingDoc), etwa per Set swDraw = swModel.
Dim vAnnotationen As Variant
Dim swAnn As SldWorks.Annotation
Dim lBemassungen As Long
Dim lAndere As Long
Dim i As Long
vAnnotationen = swDraw.InsertModelAnnotations4(swImportModelItemsFromEntireModel, 0, _
    True, True, False, False, True, False)
If IsArray(vAnnotationen) Then
    For i = LBound(vAnnotationen) To UBound(vAnnotationen)
        Set swAnn = vAnnotationen(i)
        If swAnn.GetType = swDisplayDimension Then
            lBemassungen = lBemassungen + 1
        Else
            lAndere = lAndere + 1
        End If
    Next i
End If
Debug.Print "Bemaßungen: " & lBemassungen & ", andere Beschriftungen: " & lAndere

Bemerkungen

Der Befehl fügt in die ausgewählte Zeichenansicht ein. Wähl die Ansicht also vorher aus, etwa mit ModelDocExtension.SelectByID2, oder setz AllViews auf True wie im Beispiel.

Was passiert, wenn nur einer der beiden Schalter InsertAllAnnotations und InsertAllReferenceGeometry auf True steht, lässt die Hilfe offen: Nach der Beschreibung von Types gilt Types dann gar nicht, nach der Beschreibung der Schalter für den anderen Teil schon. Ob „alle Beschriftungen“ auch die Bemaßungen umfasst, sagt die Hilfe ebenfalls nicht. Probier die Kombination im eigenen Modell aus, bevor du dich darauf verlässt.

Neuere Fassung von DrawingDoc.InsertModelAnnotations3 mit den beiden zusätzlichen Schaltern am Ende. Nur Bemaßungen und ohne Rückgabe fügt DrawingDoc.InsertModelDimensions ein. Ein Modell in vordefinierte Ansichten setzt du mit DrawingDoc.InsertModelInPredefinedView.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2024

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

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