Objekt · SldWorks
VersionCompatibilityItem-Objekt
Ein Grund, warum ein Dokument nicht oder nur mit Warnung im Dateiformat einer älteren SOLIDWORKS-Version gespeichert werden kann.
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
ModelDocExtension.CheckVersionCompatibility: die Parameter Incompatibilities und Warnings sind Arrays dieser Objekte
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 SubBemerkungen
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
| Name | Beschreibung |
|---|---|
| Action | Liefert die Meldung mit der empfohlenen Abhilfe für diese Unverträglichkeit. |
| ID | Liefert die Kennung der Meldung zu dieser Unverträglichkeit. |
| IncompatibleObject | Liefert das Objekt, das nicht zum Dateiformat der älteren Version passt, meist ein Feature. |
| Message | Liefert die Meldung, die diese Unverträglichkeit beschreibt. |
| Version | Liefert 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.