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 LongnErgebnis = swProps.Get6(FieldName, False, sWert, sErgebnis, bAusgewertet, bVerknuepft)Parameter
FieldNameStringByVal- Der Name der Eigenschaft.
UseCachedBooleanByValFalseliefert immer den aktuellen Wert.Truedarf 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 WertswCustomInfoGetResult_CachedValue(0): Wert aus dem ZwischenspeicherswCustomInfoGetResult_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 SubBemerkungen
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.