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 VariantvAnnotationen = swDraw.InsertModelAnnotations3(swImportModelItemsFromEntireModel, swInsertDimensionsMarkedForDrawing, False, True, False, True)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. Es ist eine Bitmaske, mehrere Werte kombinierst du mitOr. Gängige Werte:swInsertDimensionsMarkedForDrawing(32768): Bemaßungen, die für die Zeichnung markiert sindswInsertDimensions(8): BemaßungenswInsertNotes(64): HinweiseswInsertGTols(32): Form- und LagetoleranzenswInsertSFSymbols(128): OberflächenbeschaffenheitswInsertholeCallout(1048576): BohrungsbeschreibungenswInsertCThreads(1): Gewindedarstellungen
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. Achtung:Trueheißt hier „Doppelte vermeiden“.HiddenFeatureDimsBooleanByValTruefügt auch Bemaßungen ausgeblendeter Features ein,Falsenicht.UsePlacementInSketchBooleanByValTruesetzt die Bemaßungen so, wie sie in der Skizze platziert sind,Falsenicht.
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 IfBemerkungen
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.