SolidWorksMakroprogrammierung

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.

Bibliothek SwConst · 5 Werte · im Code direkt mit Namen verwendbar, zum Beispiel swExternalReferenceBroken

Syntax

Enum swExternalReferenceStatus_e
    swExternalReferenceBroken       = 0
    swExternalReferenceLocked       = 1
    swExternalReferenceInContext    = 3
    swExternalReferenceOutOfContext = 4
    swExternalReferenceDangling     = 5
End Enum

Werte

KonstanteWertBedeutung
swExternalReferenceBroken0Gelöst. Die Verbindung zum referenzierten Modell ist getrennt.
swExternalReferenceLocked1Gesperrt. Die Referenz bleibt bestehen, wird aber nicht aktualisiert. Mit swExternalFileReferencesunlockAll entsperrst du sie wieder.
swExternalReferenceInContext3Im Kontext. Die Referenz ist intakt, und das Dokument, in dessen Kontext sie entstanden ist, ist geöffnet.
swExternalReferenceOutOfContext4Auß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.
swExternalReferenceDangling5Dem 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 i

Bemerkungen

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.