SolidWorksMakroprogrammierung

Enumeration · SwConst

swUnitsDecimalRounding_e-Enumeration

Wie SOLIDWORKS Dezimalzahlen auf die eingestellten Nachkommastellen rundet, für das ganze Dokument oder eine einzelne Bemaßung.

Bibliothek SwConst · 4 Werte · im Code direkt mit Namen verwendbar, zum Beispiel swUnitsDecimalRounding_HalfAway

Syntax

Enum swUnitsDecimalRounding_e
    swUnitsDecimalRounding_HalfAway    = 0
    swUnitsDecimalRounding_HalfTowards = 1
    swUnitsDecimalRounding_HalfToEven  = 2
    swUnitsDecimalRounding_Truncate    = 3
End Enum

Werte

KonstanteWertBedeutung
swUnitsDecimalRounding_HalfAway0Kaufmännisch runden: Liegt der Wert genau in der Mitte, von null weg. Mit einer Nachkommastelle wird 2,25 zu 2,3. Im englischen Dialog „Round half away from zero“.
swUnitsDecimalRounding_HalfTowards1Liegt der Wert genau in der Mitte, zur Null hin runden. Mit einer Nachkommastelle wird 2,25 zu 2,2. Im englischen Dialog „Round half towards zero“.
swUnitsDecimalRounding_HalfToEven2Liegt der Wert genau in der Mitte, auf die gerade Ziffer runden. Mit einer Nachkommastelle wird 2,25 zu 2,2, aber 2,35 zu 2,4. Im englischen Dialog „Round half to even“.
swUnitsDecimalRounding_Truncate3Nicht runden, sondern die übrigen Stellen abschneiden. Mit einer Nachkommastelle wird 2,29 zu 2,2. Im englischen Dialog „Truncate without rounding“.

Beispiel

' swModel ist das aktive Dokument (ModelDoc2).
' swDispDim ist eine DisplayDimension, etwa aus Feature.GetFirstDisplayDimension oder der Auswahl.
Dim nRundung As Long
nRundung = swModel.Extension.GetUserPreferenceInteger(swUnitsDecimalRounding, swDetailingNoOptionSpecified)
If nRundung <> swUnitsDecimalRounding_HalfAway Then
    swModel.Extension.SetUserPreferenceInteger swUnitsDecimalRounding, swDetailingNoOptionSpecified, swUnitsDecimalRounding_HalfAway
End If
' Nur diese Bemaßung: Millimeter, dezimal, überzählige Stellen abschneiden
swDispDim.SetUnits2 False, swMM, swDECIMAL, 0, False, swUnitsDecimalRounding_Truncate
swModel.ActiveView.GraphicsRedraw Empty

Bemerkungen

Fürs ganze Dokument ist die Rundung eine Dokumenteigenschaft (Extras › Optionen › Dokumenteigenschaften › Einheiten). Du liest sie mit ModelDocExtension.GetUserPreferenceInteger und setzt sie mit ModelDocExtension.SetUserPreferenceInteger, jeweils mit swUnitsDecimalRounding. Ob die Rundung nur für Bemaßungen gilt oder für jede Zahlenanzeige bis hin zu Dialogen, steuert der Schalter swDetailingNoDimSpecificOptionSpecified (ModelDocExtension.SetUserPreferenceToggle). Bei swUnitsDecimalRounding_HalfAway steht dieses Kontrollkästchen nicht zur Verfügung.

Für eine einzelne Bemaßung übergibst du den Wert an DisplayDimension.SetUnits2 im Parameter DecimalRounding. Er zählt nur, wenn UseDoc False ist und FractBase swDECIMAL aus swFractionDisplay_e. Bei Brüchen steuert stattdessen RoundToFraction das Runden.

Die Erklärungen oben folgen den Namen im Dialog der Dokumenteigenschaften. Auf der Seite der Enumeration heißt es knapper, swUnitsDecimalRounding_HalfAway runde auf und swUnitsDecimalRounding_HalfTowards runde ab.

Verwendet von

Siehe auch

Englisches Original: swUnitsDecimalRounding_e in der SOLIDWORKS API-Hilfe ↗

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