Enumeration · SwConst
swExternalReferenceStatus_e-Enumeration
Zustand einer externen Referenz, wie ListExternalFileReferences2 ihn liefert: im Kontext, außerhalb des Kontexts, gesperrt, gelöst oder hängend.
Syntax
Enum swExternalReferenceStatus_e
swExternalReferenceBroken = 0
swExternalReferenceLocked = 1
swExternalReferenceInContext = 3
swExternalReferenceOutOfContext = 4
swExternalReferenceDangling = 5
End EnumWerte
| Konstante | Wert | Bedeutung |
|---|---|---|
swExternalReferenceBroken | 0 | Gelöst. Die Verbindung zum referenzierten Modell ist getrennt. |
swExternalReferenceLocked | 1 | Gesperrt. Die Referenz bleibt bestehen, wird aber nicht aktualisiert. Mit swExternalFileReferencesunlockAll entsperrst du sie wieder. |
swExternalReferenceInContext | 3 | Im Kontext. Die Referenz ist intakt, und das Dokument, in dessen Kontext sie entstanden ist, ist geöffnet. |
swExternalReferenceOutOfContext | 4 | Außerhalb des Kontexts. Das Dokument, in dessen Kontext die Referenz entstanden ist (meist die Baugruppe), ist nicht geöffnet. Die Referenz wird erst wieder aktualisiert, wenn du es öffnest. |
swExternalReferenceDangling | 5 | Dem Namen nach hängend: Das Element, auf das die Referenz zeigt, ist im referenzierten Modell nicht mehr zu finden, etwa weil die Kante gelöscht wurde. |
Beispiel
' swFeat ist ein Feature, etwa aus SelectionMgr.GetSelectedObject6.
Dim vModell, vKomp, vFeat, vArt, vStatus, vRef, vFeatKomp
Dim nKonfOpt As Long, sKonf As String, i As Long
swFeat.ListExternalFileReferences2 vModell, vKomp, vFeat, vArt, vStatus, vRef, vFeatKomp, nKonfOpt, sKonf
For i = 0 To swFeat.ListExternalFileReferencesCount - 1
Select Case vStatus(i)
Case swExternalReferenceInContext: Debug.Print vFeat(i) & ": im Kontext"
Case swExternalReferenceOutOfContext: Debug.Print vFeat(i) & ": außerhalb des Kontexts"
Case swExternalReferenceLocked: Debug.Print vFeat(i) & ": gesperrt"
Case swExternalReferenceBroken, swExternalReferenceDangling: Debug.Print vFeat(i) & ": gelöst oder hängend"
End Select
Next iBemerkungen
Die Werte stehen im Array Status, das ListExternalFileReferences2 von Feature, Component2 und ModelDocExtension liefert. Es hat einen Eintrag je Referenz, in derselben Reihenfolge wie die anderen Arrays (Feature, RefEntity …).
Sperren, entsperren oder lösen kannst du die Referenzen mit UpdateExternalFileReferences und einem Wert aus swExternalFileReferencesUpdate_e.
Die Hilfe beschreibt die Werte nur mit ihrem Namen. ModelDocExtension.ListExternalFileReferences2 liefert dieselben Angaben wie der Dialog mit den externen Referenzen, den du im FeatureManager über das Kontextmenü eines Features oder einer Komponente mit -> hinter dem Namen öffnest. Dort steht auch der Zustand jeder Referenz.
Verwendet von
Siehe auch
Englisches Original: swExternalReferenceStatus_e in der SOLIDWORKS API-Hilfe ↗
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.