Methode · Dimension
SetValue3-Methode (Dimension)
Setzt den Wert einer Bemaßung in der Einheit des Dokuments, für eine, mehrere oder alle Konfigurationen.
Syntax
Function SetValue3( _
ByVal NewValue As Double, _
ByVal WhichConfigurations As Long, _
ByVal Config_names As Variant _
) As LongnStatus = swDim.SetValue3(NewValue, swSetValue_InThisConfiguration, Empty)Parameter
NewValueDoubleByVal- Der neue Wert in der Einheit des Dokuments, bei Längen meist Millimeter.
WhichConfigurationsLongByValFür welche Konfigurationen, ein Wert aus
swSetValueInConfiguration_e:swSetValue_InThisConfiguration(1): nur die aktiveswSetValue_InAllConfigurations(2): alleswSetValue_InSpecificConfigurations(3): die inConfig_namesgenannten
Config_namesVariantByVal- Nur bei
swSetValue_InSpecificConfigurations: der Name einer Konfiguration oder ein Array mit Namen. SonstEmpty.
Rückgabewert
Ein Status aus swSetValueReturnStatus_e:
swSetValue_Successful(0): geändertswSetValue_Failure(1): ging nichtswSetValue_InvalidValue(2): der Wert ist nicht zulässigswSetValue_DrivenDimension(3): die Bemaßung ist getrieben und lässt sich nicht ändernswSetValue_ModelNotLoaded(4): das Modell ist nicht geladen; es muss dafür geladen seinswSetValue_FrozenFeatureOwner(5): das Feature mit der Bemaßung ist eingefroren
Beispiel
' Setzt D1@Skizze1 in allen Konfigurationen auf 75 und baut das Teil neu auf.
' Vorbedingung: Ein Teil mit der Bemaßung D1@Skizze1 ist geöffnet, Einheit Millimeter.
' Ergebnis: D1 ist in allen Konfigurationen 75 mm.
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swDim As SldWorks.Dimension
Dim nStatus As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
Set swDim = swModel.Parameter("D1@Skizze1")
If swDim Is Nothing Then Exit Sub
nStatus = swDim.SetValue3(75, swSetValue_InAllConfigurations, Empty)
If nStatus <> swSetValue_Successful Then
swApp.SendMsgToUser2 "Wert nicht gesetzt, Status " & nStatus, swMbWarning, swMbOk
Exit Sub
End If
swModel.EditRebuild3
End SubBemerkungen
Der Wert gilt in der Einheit des Dokuments. Stellt jemand das Dokument auf Zoll um, bedeutet derselbe Aufruf plötzlich 75 Zoll. Wer davon unabhängig sein will, nimmt Dimension.SetSystemValue3 und rechnet in Metern.
Nach dem Setzen zeigt das Modell die Änderung erst nach einem Neuaufbau, etwa mit ModelDoc2.EditRebuild3.
Getriebene Bemaßungen, also solche, die SOLIDWORKS aus der Geometrie berechnet, lassen sich nicht setzen. SetValue3 meldet dann swSetValue_DrivenDimension.
Der Vorgänger SetValue2 ist veraltet.
Siehe auch
In den Videos
Verfügbarkeit
SOLIDWORKS 2004
Englisches Original: IDimension::SetValue3 in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.