SolidWorksMakroprogrammierung

Methode · DrawingDoc

AutoDimension-Methode (DrawingDoc)

Bemaßt eine Zeichenansicht automatisch, meist die ausgewählte.

Syntax

Function AutoDimension( _
   ByVal EntitiesToDimension As Long, _
   ByVal HorizontalScheme As Long, _
   ByVal HorizontalPlacement As Long, _
   ByVal VerticalScheme As Long, _
   ByVal VerticalPlacement As Long _
) As Long
lStatus = swDraw.AutoDimension(swAutodimEntitiesAll, swAutodimSchemeBaseline, swAutodimHorizontalPlacementBelow, swAutodimSchemeBaseline, swAutodimVerticalPlacementLeft)

Parameter

EntitiesToDimensionLongByVal

Was bemaßt wird, ein Wert aus swAutodimEntities_e:

  • swAutodimEntitiesAll (1): alle Elemente der Ansicht
  • swAutodimEntitiesSelected (2): nur die ausgewählten Elemente, die mit der Markierung swAutodimMarkEntities (1) ausgewählt sind
  • swAutodimEntitiesBasedOnPreselect (0): SOLIDWORKS entscheidet. Gibt es so markierte Elemente, werden nur sie bemaßt, sonst alle.
HorizontalSchemeLongByVal

Art der waagrechten Bemaßung, ein Wert aus swAutodimScheme_e:

  • swAutodimSchemeBaseline (1): Bezugsmaße von einer gemeinsamen Basislinie
  • swAutodimSchemeOrdinate (2): Ordinatenbemaßung
  • swAutodimSchemeChain (3): Kettenmaße

swAutodimSchemeCenterline (4) geht in Zeichnungen nicht.

HorizontalPlacementLongByVal
Wo die waagrechten Maße stehen, ein Wert aus swAutodimHorizontalPlacement_e: swAutodimHorizontalPlacementAbove (1) über der Ansicht, swAutodimHorizontalPlacementBelow (-1) darunter.
VerticalSchemeLongByVal
Art der senkrechten Bemaßung, Werte wie bei HorizontalScheme.
VerticalPlacementLongByVal
Wo die senkrechten Maße stehen, ein Wert aus swAutodimVerticalPlacement_e: swAutodimVerticalPlacementLeft (-1) links der Ansicht, swAutodimVerticalPlacementRight (1) rechts davon.

Rückgabewert

Ein Wert aus swAutodimStatus_e. swAutodimStatusSuccess (0) heißt: Die Ansicht wurde bemaßt. Jeder andere Wert nennt den Grund für den Fehlschlag, zum Beispiel swAutodimStatusNoEntities (8), wenn du swAutodimEntitiesSelected übergibst, aber kein Element markiert hast. Die Enumeration gilt auch für das automatische Bemaßen von Skizzen, viele ihrer Werte betreffen nur Skizzen.

Beispiel

' swModel ist die aktive Zeichnung (ModelDoc2), swDraw dasselbe Dokument als DrawingDoc.
Dim lStatus As Long
swModel.ClearSelection2 True
If swModel.Extension.SelectByID2("Zeichenansicht1", "DRAWINGVIEW", 0, 0, 0, False, 0, Nothing, swSelectOptionDefault) Then
    ' waagrecht Kettenmaße unter der Ansicht, senkrecht Bezugsmaße links davon
    lStatus = swDraw.AutoDimension(swAutodimEntitiesAll, swAutodimSchemeChain, swAutodimHorizontalPlacementBelow, swAutodimSchemeBaseline, swAutodimVerticalPlacementLeft)
    Select Case lStatus
        Case swAutodimStatusSuccess
            Debug.Print "Ansicht bemaßt."
        Case swAutodimStatusDatumNotUnique
            Debug.Print "Mehr als ein Bezug ausgewählt."
        Case Else
            Debug.Print "Nicht bemaßt, Status " & lStatus
    End Select
End If

Bemerkungen

AutoDimension arbeitet mit der aktuellen Auswahl. Der Befehl braucht drei Angaben:

  1. Die Ansicht: Wähl die Zeichenansicht aus, eine Markierung ist nicht nötig. Ist keine Ansicht ausgewählt, versucht SOLIDWORKS sie aus den anderen ausgewählten Elementen zu bestimmen. Ist gar nichts ausgewählt, nimmt es die erste Ansicht, so wie die Oberfläche.
  2. Die Bezüge (Basislinien): Für die waagrechten Maße wählst du eine senkrechte Kante, eine senkrechte Skizzenlinie, einen Eckpunkt oder einen Skizzenpunkt mit der Markierung swAutodimMarkHorizontalDatum (2) aus swAutodimMark_e. Für die senkrechten Maße entsprechend ein waagrechtes Element mit swAutodimMarkVerticalDatum (4). Ein Eckpunkt oder Skizzenpunkt mit swAutodimMarkOriginDatum (8) dient als Bezug für beide Richtungen. Die Markierung übergibst du beim Auswählen, etwa im Parameter Mark von ModelDocExtension.SelectByID2. Ohne Bezüge nimmt SOLIDWORKS die Elemente ganz links und ganz unten in der Ansicht. Gibst du nur einen Bezug an, entstehen nur die Maße für diese Richtung.
  3. Die Elemente: über EntitiesToDimension und die mit swAutodimMarkEntities (1) markierten Elemente. Bemaßt werden Linien, Punkte, Eckpunkte, Flächen und Skizzenelemente.

Bei swAutodimEntitiesSelected widerspricht sich die Hilfe: Die Befehlsseite sagt, nur markierte Elemente werden bemaßt, und swAutodimStatus_e kennt dafür den Fehler swAutodimStatusNoEntities. Die Seite der Enumeration sagt dagegen, ohne markierte Elemente wird alles bemaßt. Prüf deshalb den Rückgabewert.

Der Ansichtsname im Beispiel hängt von der Sprache ab, in einer englischen Zeichnung heißt die Ansicht "Drawing View1". Die Maße aus dem Modell holst du stattdessen mit DrawingDoc.InsertModelAnnotations3 in die Zeichnung.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2005

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

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