SolidWorksMakroprogrammierung

Methode · UserUnit

ConvertToUserUnit-Methode (UserUnit)

Gibt einen Wert als Text in der Einheit des Objekts aus, auf Wunsch mit Einheitenname.

Syntax

Function ConvertToUserUnit( _
   ByVal ValueIn As Double, _
   ByVal ShowUsernames As Boolean, _
   ByVal NameInEnglish As Boolean _
) As String
sText = swEinheit.ConvertToUserUnit(dWert, True, False)

Parameter

ValueInDoubleByVal
Der Wert als Systemwert in Meter oder Bogenmaß (0,0254 ergab „25.4mm“, 0,5 bei der Winkeleinheit „28.648Grad“).
ShowUsernamesBooleanByVal
True: den Namen der Einheit anhängen. False: nicht.
NameInEnglishBooleanByVal
True: den Namen auf Englisch. False: in der Sprache der Oberfläche („28.648deg“ gegen „28.648Grad“).

Rückgabewert

Der Wert als Text.

Beispiel

' swModel ist das aktive Dokument (ModelDoc2).
Dim swEinheit As SldWorks.UserUnit
Set swEinheit = swModel.GetUserUnit(swLengthUnit)
Debug.Print "0,0254 m = " & swEinheit.ConvertToUserUnit(0.0254, True, False)

Bemerkungen

Die Hilfe sagt nur, dass die Methode den Wert in Dokumenteinheiten umrechnet. Das Hilfebeispiel „Get and Set Document Units“ übergibt bei der Winkeleinheit 2# und beschreibt das Ergebnis als „2.0 in complete document angle units“. Trennzeichen und Nachkommastellen der Einheit gelten („25.4mm“ mit Punkt, „28.648Grad“ mit drei Stellen); Nullen hängte die Methode nicht an.

Siehe auch

Verfügbarkeit

SOLIDWORKS 2001

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

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