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 VariantvAnnotationen = swDraw.InsertModelAnnotations4(swImportModelItemsFromEntireModel, swInsertDimensionsMarkedForDrawing, False, True, False, False, False, False)Parameter
OptionLongByValWoher die Elemente kommen, als Wert von
swImportModelItemsSource_e:swImportModelItemsFromEntireModel(0): ganzes ModellswImportModelItemsFromSelectedFeature(1): ausgewähltes FeatureswImportModelItemsFromSelectedComponent(2): ausgewählte KomponenteswImportModelItemsFromAssemblyOnly(3): dem Namen nach nur die Baugruppe selbst
TypesLongByValWelche Arten von Elementen eingefügt werden, Werte aus
swInsertAnnotation_e, mehrere mitOrkombiniert. Der Wert gilt nur, wennInsertAllAnnotationsundInsertAllReferenceGeometrybeideFalsesind. Gängige Werte:swInsertDimensionsMarkedForDrawing(32768): Bemaßungen, die für die Zeichnung markiert sindswInsertDimensions(8): BemaßungenswInsertNotes(64): HinweiseswInsertGTols(32): Form- und LagetoleranzenswInsertholeCallout(1048576): BohrungsbeschreibungenswInsertAxes(512): AchsenswInsertPlanes(2048): Ebenen
AllViewsBooleanByValTruefügt die Elemente in alle Ansichten der Zeichnung ein,Falsenur in die ausgewählte Ansicht.DuplicateDimsBooleanByValTruelässt doppelte Bemaßungen weg,Falseerlaubt doppelte Bemaßungen.HiddenFeatureDimsBooleanByValTruefügt auch Bemaßungen ausgeblendeter Features ein,Falsenicht.UsePlacementInSketchBooleanByValTruesetzt die Bemaßungen so, wie sie in der Skizze platziert sind,Falsenicht.InsertAllAnnotationsBooleanByValTruefügt alle Beschriftungen ein,Falsenur die inTypesgenannten.InsertAllReferenceGeometryBooleanByValTruefügt die gesamte Referenzgeometrie ein,Falsenur die inTypesgenannte.
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: " & lAndereBemerkungen
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.