SolidWorksMakroprogrammierung

Methode · CustomPropertyManager

Get6-Methode (CustomPropertyManager)

Liest eine Dateieigenschaft: den eingetragenen Text und den ausgewerteten Wert, etwa bei Verknüpfungen auf die Masse.

Syntax

Function Get6( _
   ByVal FieldName As String, _
   ByVal UseCached As Boolean, _
   ByRef ValOut As String, _
   ByRef ResolvedValOut As String, _
   ByRef WasResolved As Boolean, _
   ByRef LinkToProperty As Boolean _
) As Long
nErgebnis = swProps.Get6(FieldName, False, sWert, sErgebnis, bAusgewertet, bVerknuepft)

Parameter

FieldNameStringByVal
Der Name der Eigenschaft.
UseCachedBooleanByVal
False liefert immer den aktuellen Wert. True darf einen zwischengespeicherten Wert liefern, wenn die Konfiguration seit dem Öffnen nicht aktiv war. Das ist schneller, aber womöglich veraltet.
ValOutStringByRef · Rückgabe
Hier steht danach der eingetragene Text, zum Beispiel "SW-Masse@Welle.SLDPRT".
ResolvedValOutStringByRef · Rückgabe
Hier steht danach der ausgewertete Wert, zum Beispiel "1.25".
WasResolvedBooleanByRef · Rückgabe
Hier steht danach, ob der Wert aktuell ausgewertet wurde (True) oder aus dem Zwischenspeicher kommt (False).
LinkToPropertyBooleanByRef · Rückgabe
Hier steht danach, ob die Eigenschaft mit dem übergeordneten Teil verknüpft ist, etwa bei Schweißkonstruktionen.

Rückgabewert

Ein Ergebniscode aus swCustomInfoGetResult_e:

  • swCustomInfoGetResult_ResolvedValue (2): aktueller, ausgewerteter Wert
  • swCustomInfoGetResult_CachedValue (0): Wert aus dem Zwischenspeicher
  • swCustomInfoGetResult_NotPresent (1): die Eigenschaft gibt es nicht

Beispiel

' Liest die Eigenschaft "Gewicht" und zeigt Eintrag und Ergebnis.
' Vorbedingung: Ein Teil mit der Dateieigenschaft "Gewicht" ist geöffnet,
'               zum Beispiel verknüpft mit der Masse.
' Ergebnis:     Meldung mit beiden Werten.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swProps As SldWorks.CustomPropertyManager
    Dim sWert As String
    Dim sErgebnis As String
    Dim bAusgewertet As Boolean
    Dim bVerknuepft As Boolean

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    Set swProps = swModel.Extension.CustomPropertyManager("")

    If swProps.Get6("Gewicht", False, sWert, sErgebnis, bAusgewertet, bVerknuepft) = swCustomInfoGetResult_NotPresent Then
        swApp.SendMsgToUser2 "Die Eigenschaft ""Gewicht"" gibt es nicht.", swMbWarning, swMbOk
        Exit Sub
    End If

    swApp.SendMsgToUser2 "Eingetragen: " & sWert & vbCrLf & "Ergebnis: " & sErgebnis, swMbInformation, swMbOk
End Sub

Bemerkungen

Für Anzeige und Weiterverarbeitung brauchst du fast immer das Ergebnis (ResolvedValOut), nicht den Eintrag. Bei einfachen Texten sind beide gleich. Bei Verknüpfungen wie "SW-Masse@Welle.SLDPRT" steht nur im Ergebnis die Zahl.

Das Ergebnis ist immer Text, auch bei Zahlen. Je nach Einstellungen steht darin ein Punkt oder ein Komma als Dezimaltrenner. Bevor du damit rechnest, wandle ihn passend um, etwa mit Val (erwartet einen Punkt) oder CDbl (erwartet das Format der Windows-Einstellungen).

Für ValOut und ResolvedValOut brauchst du String-Variablen, denn dort landen die Ergebnisse. Brauchst du WasResolved und LinkToProperty nicht, kannst du dort einfach False übergeben. Get6 kann bei einer Konfiguration, die seit dem Öffnen nicht aktiv war, die Konfigurationen durchschalten. Das Modell steht danach womöglich in einer anderen Konfiguration.

Die Vorgänger Get bis Get5 sind veraltet.

Siehe auch

In den Videos

Verfügbarkeit

SOLIDWORKS 2018

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

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