SolidWorksMakroprogrammierung

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 Long
nStatus = swDim.SetValue3(NewValue, swSetValue_InThisConfiguration, Empty)

Parameter

NewValueDoubleByVal
Der neue Wert in der Einheit des Dokuments, bei Längen meist Millimeter.
WhichConfigurationsLongByVal

Für welche Konfigurationen, ein Wert aus swSetValueInConfiguration_e:

  • swSetValue_InThisConfiguration (1): nur die aktive
  • swSetValue_InAllConfigurations (2): alle
  • swSetValue_InSpecificConfigurations (3): die in Config_names genannten
Config_namesVariantByVal
Nur bei swSetValue_InSpecificConfigurations: der Name einer Konfiguration oder ein Array mit Namen. Sonst Empty.

Rückgabewert

Ein Status aus swSetValueReturnStatus_e:

  • swSetValue_Successful (0): geändert
  • swSetValue_Failure (1): ging nicht
  • swSetValue_InvalidValue (2): der Wert ist nicht zulässig
  • swSetValue_DrivenDimension (3): die Bemaßung ist getrieben und lässt sich nicht ändern
  • swSetValue_ModelNotLoaded (4): das Modell ist nicht geladen; es muss dafür geladen sein
  • swSetValue_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 Sub

Bemerkungen

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.