SolidWorksMakroprogrammierung

Methode · DrawingDoc

InsertModelAnnotations3-Methode (DrawingDoc)

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

Syntax

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

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. Es ist eine Bitmaske, mehrere Werte kombinierst du mit Or. 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
  • swInsertSFSymbols (128): Oberflächenbeschaffenheit
  • swInsertholeCallout (1048576): Bohrungsbeschreibungen
  • swInsertCThreads (1): Gewindedarstellungen
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. Achtung: True heißt hier „Doppelte vermeiden“.
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.

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, bevor du es durchläufst.

Beispiel

' swModel ist die aktive Zeichnung (ModelDoc2), swDraw dasselbe Dokument als DrawingDoc.
Dim vAnnotationen As Variant
Dim swAnn As SldWorks.Annotation
Dim bErfolg As Boolean
Dim i As Long
bErfolg = swModel.Extension.SelectByID2("Zeichenansicht1", "DRAWINGVIEW", 0, 0, 0, False, 0, Nothing, 0)
vAnnotationen = swDraw.InsertModelAnnotations3(swImportModelItemsFromEntireModel, _
    swInsertDimensionsMarkedForDrawing Or swInsertNotes, False, True, False, True)
If IsArray(vAnnotationen) Then
    For i = LBound(vAnnotationen) To UBound(vAnnotationen)
        Set swAnn = vAnnotationen(i)
        Debug.Print swAnn.GetName
    Next i
    Debug.Print UBound(vAnnotationen) - LBound(vAnnotationen) + 1 & " Elemente eingefügt."
Else
    Debug.Print "Nichts eingefügt."
End If

Bemerkungen

Der Befehl fügt in die ausgewählte Zeichenansicht ein. Wähl die Ansicht also vorher aus oder setz AllViews auf True. Im Beispiel heißt die Ansicht "Zeichenansicht1", in einer englischen Zeichnung "Drawing View1".

Die Hilfe weist darauf hin, dass Option in ihren Ausgaben vor SOLIDWORKS 2008 SP03 falsch beschrieben war: Dort stand 1 für die ausgewählte Komponente und 2 für das ausgewählte Feature. Richtig ist die Zuordnung aus swImportModelItemsSource_e wie oben.

Ersetzt DrawingDoc.InsertModelAnnotations2. Seit SOLIDWORKS 2024 gibt es DrawingDoc.InsertModelAnnotations4 mit zwei zusätzlichen Schaltern für alle Beschriftungen und alle Referenzgeometrie. Nur Bemaßungen und ohne Rückgabe fügt DrawingDoc.InsertModelDimensions ein.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2005

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

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