SolidWorksMakroprogrammierung

Enumeration · SwConst

swExternalFileReferencesUpdate_e-Enumeration

Was UpdateExternalFileReferences mit den externen Referenzen eines Features, einer Komponente oder eines Modells macht: sperren, entsperren oder lösen.

Bibliothek SwConst · 4 Werte · im Code direkt mit Namen verwendbar, zum Beispiel swExternalFileReferencesUpdateNone

Syntax

Enum swExternalFileReferencesUpdate_e
    swExternalFileReferencesUpdateNone = 0
    swExternalFileReferencesBreakAll   = 1
    swExternalFileReferencesLockAll    = 2
    swExternalFileReferencesunlockAll  = 3
End Enum

Werte

KonstanteWertBedeutung
swExternalFileReferencesUpdateNone0Dem Namen nach keine Änderung.
swExternalFileReferencesBreakAll1Alle 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.
swExternalFileReferencesLockAll2Alle externen Referenzen sperren. Gesperrte Referenzen bleiben bestehen, werden aber nicht aktualisiert, bis du sie wieder entsperrst.
swExternalFileReferencesunlockAll3Alle 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 If

Bemerkungen

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.