SolidWorksMakroprogrammierung

Objekt · SldWorks

VersionCompatibilityItem-Objekt

Ein Grund, warum ein Dokument nicht oder nur mit Warnung im Dateiformat einer älteren SOLIDWORKS-Version gespeichert werden kann.

Deklaration Dim x As SldWorks.VersionCompatibilityItem · in der englischen .NET-Hilfe: IVersionCompatibilityItem

Beschreibung

VersionCompatibilityItem beschreibt einen Grund, warum ein Dokument nicht im Dateiformat einer früheren SOLIDWORKS-Version gespeichert werden kann. ModelDocExtension.CheckVersionCompatibility liefert solche Einträge in zwei Arrays: Hindernisse und Warnungen. Jeder Eintrag nennt eine Kennung, eine Meldung, eine empfohlene Abhilfe, die betroffene Version und das Objekt, das nicht passt. Alle Befehle sind nur lesbar und gibt es seit SOLIDWORKS 2026 SP03.

Zugriff

Beispiel

' Prüft, ob das aktive Dokument im Format der Vorgängerversion gespeichert werden kann,
' und gibt Hindernisse und Warnungen mit Meldung und Abhilfe aus.
' Vorbedingung: Ein Teil, eine Baugruppe oder eine Zeichnung ist offen (SOLIDWORKS 2026 SP03
'               oder neuer).
' Ergebnis:     Die Angaben stehen im Direktfenster, ein Dialog erscheint nicht.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim vHindernisse As Variant, vWarnungen As Variant
    Dim nErgebnis As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub

    nErgebnis = swModel.Extension.CheckVersionCompatibility(swSaveToVersion_Penultimate, _
                    swCompatibilityDialogOptions_NeverShow, vHindernisse, vWarnungen)
    Debug.Print "Ergebnis: " & nErgebnis
    EintraegeAusgeben "Hindernis", vHindernisse
    EintraegeAusgeben "Warnung", vWarnungen
End Sub

Private Sub EintraegeAusgeben(sArt As String, vEintraege As Variant)
    Dim swEintrag As SldWorks.VersionCompatibilityItem
    Dim swFeat As SldWorks.Feature
    Dim i As Long

    If Not IsArray(vEintraege) Then Exit Sub
    For i = 0 To UBound(vEintraege)
        Set swEintrag = vEintraege(i)
        Debug.Print sArt & " (" & swEintrag.Version & ", " & swEintrag.ID & "): " & swEintrag.Message
        Debug.Print "  Abhilfe: " & swEintrag.Action
        If TypeOf swEintrag.IncompatibleObject Is SldWorks.Feature Then
            Set swFeat = swEintrag.IncompatibleObject
            Debug.Print "  Feature: " & swFeat.Name
        End If
    Next i
End Sub

Bemerkungen

Ein Hilfebeispiel: Ein Hilfebeispiel zu diesem Objekt oder zu ModelDocExtension.CheckVersionCompatibility gibt es nicht.

Texte: Message und Action sind in der Sprache der Oberfläche (localized). Für Auswertungen im Programm eignet sich deshalb vermutlich die Kennung aus VersionCompatibilityItem.ID besser. Welche Kennungen es gibt, sagt die Hilfe nicht.

Ergebnis: Den Rückgabewert von CheckVersionCompatibility beschreibt swVersionCompatibilityResult_e, die Zielversion swSaveToVersion_e.

Eigenschaften und Methoden

Eigenschaften 5, davon 5 beschrieben

NameBeschreibung
ActionLiefert die Meldung mit der empfohlenen Abhilfe für diese Unverträglichkeit.
IDLiefert die Kennung der Meldung zu dieser Unverträglichkeit.
IncompatibleObjectLiefert das Objekt, das nicht zum Dateiformat der älteren Version passt, meist ein Feature.
MessageLiefert die Meldung, die diese Unverträglichkeit beschreibt.
VersionLiefert die SOLIDWORKS-Version, auf die sich die Unverträglichkeit bezieht, als Jahreszahl.

Siehe auch

Englisches Original: IVersionCompatibilityItem in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.