SolidWorksMakroprogrammierung

Enumeration · SwConst

swLengthUnit_e-Enumeration

Längeneinheiten wie Millimeter, Meter oder Zoll, für das ganze Dokument, eine einzelne Bemaßung oder den Export.

Bibliothek SwConst · 11 Werte · im Code direkt mit Namen verwendbar, zum Beispiel swMM

Syntax

Enum swLengthUnit_e
    swMM         = 0
    swCM         = 1
    swMETER      = 2
    swINCHES     = 3
    swFEET       = 4
    swFEETINCHES = 5
    swANGSTROM   = 6
    swNANOMETER  = 7
    swMICRON     = 8
    swMIL        = 9
    swUIN        = 10
End Enum

Werte

KonstanteWertBedeutung
swMM0Millimeter.
swCM1Zentimeter.
swMETER2Meter.
swINCHES3Zoll (inch).
swFEET4Fuß (feet).
swFEETINCHES5Fuß und Zoll, zum Beispiel 1′ 6″.
swANGSTROM6Ångström, ein Zehntel Nanometer.
swNANOMETER7Nanometer.
swMICRON8Mikrometer (µm).
swMIL9Mil, ein Tausendstel Zoll (0,0254 mm).
swUIN10Mikrozoll (µin), ein Millionstel Zoll.

Beispiel

' swModel ist das aktive Dokument (ModelDoc2).
Dim dLaenge As Double, dFaktor As Double, sEinheit As String
dLaenge = 0.025                                   ' 25 mm, die API rechnet in Metern
Select Case swModel.LengthUnit
    Case swMETER:  dFaktor = 1: sEinheit = "m"
    Case swCM:     dFaktor = 100: sEinheit = "cm"
    Case swINCHES: dFaktor = 1 / 0.0254: sEinheit = "in"
    Case swFEET:   dFaktor = 1 / 0.3048: sEinheit = "ft"
    Case Else:     dFaktor = 1000: sEinheit = "mm"  ' swMM und alle übrigen
End Select
Debug.Print Format(dLaenge * dFaktor, "0.###") & " " & sEinheit

Bemerkungen

Die Hilfe beschreibt die Werte nur mit ihrem Namen. Für das ganze Dokument liest und setzt du die Einheit mit ModelDoc2.LengthUnit, zusammen mit Bruch und Nachkommastellen mit ModelDoc2.GetUnits und ModelDoc2.SetUnits. Als Dokumenteigenschaft (Extras › Optionen › Dokumenteigenschaften › Einheiten) erreichst du sie mit ModelDocExtension.SetUserPreferenceInteger: swUnitsLinear für Längen, swUnitsDualLinear für Längen bei dualer Bemaßung und swUnitsMassPropLength für die Masseneigenschaften. Die letzte lässt sich nur setzen, wenn das Einheitensystem swUnitSystem_Custom ist.

Für eine einzelne Längenbemaßung liefert DisplayDimension.GetUnits einen dieser Werte, oder -1, wenn die Einheit des Dokuments gilt. Setzen kannst du sie mit DisplayDimension.SetUnits2. Bei Winkelbemaßungen kommen die Werte stattdessen aus swAngleUnit_e. Brüche (swFractionDisplay_e) gibt es nur bei swINCHES und swFEETINCHES.

Die Einheit bestimmt nur die Anzeige. Die API liefert und erwartet Längen immer in Metern, darum rechnet das Beispiel um. Für den Export nach STL und IFC (swExportStlUnits, swExportIFCUnits mit SldWorks.SetUserPreferenceIntegerValue) nennt die Hilfe nur swMM, swCM, swMETER, swINCHES und swFEET. Beim Import von DXF/DWG gibst du die Einheit mit ImportDxfDwgData.LengthUnit vor.

Verwendet von

Siehe auch

Englisches Original: swLengthUnit_e in der SOLIDWORKS API-Hilfe ↗

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