Enumeration · SwConst
swExternalFileReferencesUpdate_e-Enumeration
Was UpdateExternalFileReferences mit den externen Referenzen eines Features, einer Komponente oder eines Modells macht: sperren, entsperren oder lösen.
Syntax
Enum swExternalFileReferencesUpdate_e
swExternalFileReferencesUpdateNone = 0
swExternalFileReferencesBreakAll = 1
swExternalFileReferencesLockAll = 2
swExternalFileReferencesunlockAll = 3
End EnumWerte
| Konstante | Wert | Bedeutung |
|---|---|---|
swExternalFileReferencesUpdateNone | 0 | Dem Namen nach keine Änderung. |
swExternalFileReferencesBreakAll | 1 | Alle externen Referenzen lösen (englisch „break“). Die Verbindung zum referenzierten Modell ist danach getrennt. Teste das an einer Kopie: Gelöste Referenzen lassen sich in der Regel nicht wiederherstellen. |
swExternalFileReferencesLockAll | 2 | Alle externen Referenzen sperren. Gesperrte Referenzen bleiben bestehen, werden aber nicht aktualisiert, bis du sie wieder entsperrst. |
swExternalFileReferencesunlockAll | 3 | Alle gesperrten Referenzen wieder entsperren. |
Beispiel
' swFeat ist ein Feature, etwa aus SelectionMgr.GetSelectedObject6.
Dim vModell, vKomp, vFeat, vArt, vStatus, vRef, vFeatKomp
Dim nKonfOpt As Long, sKonf As String
If swFeat.ListExternalFileReferencesCount = 0 Then Exit Sub
swFeat.ListExternalFileReferences2 vModell, vKomp, vFeat, vArt, vStatus, vRef, vFeatKomp, nKonfOpt, sKonf
' Die erste Referenz entscheidet: gesperrt, dann entsperren, sonst sperren
If vStatus(0) = swExternalReferenceLocked Then
swFeat.UpdateExternalFileReferences swExternalFileReferencesConfigNone, "", swExternalFileReferencesunlockAll
Else
swFeat.UpdateExternalFileReferences swExternalFileReferencesConfigNone, "", swExternalFileReferencesLockAll
End IfBemerkungen
Du übergibst den Wert im dritten Parameter UpdateStatus von UpdateExternalFileReferences: bei Feature für ein Feature, bei Component2 für eine Komponente und bei ModelDocExtension für das ganze Modell. Davor stehen ein Wert aus swExternalFileReferencesConfig_e und der Name der Konfiguration.
Den Zustand der einzelnen Referenzen liest du mit ListExternalFileReferences2 als Werte aus swExternalReferenceStatus_e, etwa swExternalReferenceLocked oder swExternalReferenceBroken.
Die Hilfe beschreibt die Werte nur mit ihrem Namen.
Verwendet von
Siehe auch
Englisches Original: swExternalFileReferencesUpdate_e in der SOLIDWORKS API-Hilfe ↗
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.