Objekt · SldWorks
MaterialVisualPropertiesData-Objekt
Die Darstellungseinstellungen des Materials eines Teils: Farbe und Erscheinungsbild des Materials, Schraffur in Schnittansichten, RealView und die SOLIDWORKS-Standardtextur.
Beschreibung
MaterialVisualPropertiesData gibt Zugriff auf das Material eines Teils, genauer auf seine Darstellungseinstellungen (material visual properties): ob das Teil die Farbe und das Erscheinungsbild des Materials bekommt, ob Schnittansichten in Zeichnungen die Schraffur des Materials verwenden, ob Texturen als RealView-Grafik erscheinen und wie die SOLIDWORKS-Standardtextur liegt. Du holst die Einstellungen mit PartDoc.GetMaterialVisualProperties, änderst sie und überträgst sie mit PartDoc.SetMaterialVisualProperties auf das Teil. Die meisten Befehle gibt es seit SOLIDWORKS 2007, ApplyAppearance seit 2013.
Zugriff
PartDoc.GetMaterialVisualProperties: die Darstellungseinstellungen des Materials eines Teils
Beispiel
' Gibt die Darstellungseinstellungen des Materials des aktiven Teils aus, schaltet
' die Farbe des Materials und seine Schraffur in Schnittansichten ein und gibt
' die Einstellungen noch einmal aus.
' Vorbedingung: Ein Teil mit Material ist offen.
' Ergebnis: Die Einstellungen vorher und nachher stehen im Direktfenster (Strg+G).
Option Explicit
Sub main()
Dim swApp As SldWorks.SldWorks
Dim swModel As SldWorks.ModelDoc2
Dim swPart As SldWorks.PartDoc
Dim swDaten As SldWorks.MaterialVisualPropertiesData
Dim sMaterial As String
Dim sDatenbank As String
Dim nErgebnis As Long
Set swApp = Application.SldWorks
Set swModel = swApp.ActiveDoc
If swModel Is Nothing Then Exit Sub
If swModel.GetType <> swDocPART Then Exit Sub
Set swPart = swModel
sMaterial = swPart.GetMaterialPropertyName2(swModel.ConfigurationManager.ActiveConfiguration.Name, sDatenbank)
If sMaterial = "" Then
Debug.Print "Das Teil hat kein Material."
Exit Sub
End If
Debug.Print "Material: " & sMaterial & " aus " & sDatenbank
Set swDaten = swPart.GetMaterialVisualProperties
If swDaten Is Nothing Then Exit Sub
Ausgeben swDaten
swDaten.ApplyMaterialColorToPart = True
swDaten.ApplyMaterialHatchToSection = True
nErgebnis = swPart.SetMaterialVisualProperties(swDaten, swThisConfiguration, Nothing)
If nErgebnis <> 0 Then
Debug.Print "Nicht übernommen, Ergebnis " & nErgebnis
Exit Sub
End If
Set swDaten = swPart.GetMaterialVisualProperties
Ausgeben swDaten
End Sub
' Gibt die Darstellungseinstellungen im Direktfenster aus
Private Sub Ausgeben(swDaten As SldWorks.MaterialVisualPropertiesData)
Debug.Print "Farbe des Materials: " & swDaten.ApplyMaterialColorToPart
Debug.Print "Erscheinungsbild: " & swDaten.ApplyAppearance
Debug.Print "Schraffur in Schnitten: " & swDaten.ApplyMaterialHatchToSection
Debug.Print "RealView: " & swDaten.RealView
Debug.Print "Standardtextur: Maßstab " & swDaten.Scale2 & ", Winkel " & swDaten.Angle & _
" rad, Farbe mischen " & swDaten.BlendColor
End SubBemerkungen
Übernehmen: Änderungen am Objekt wirken erst, wenn du es mit PartDoc.SetMaterialVisualProperties an das Teil zurückgibst. In SOLIDWORKS 2024 kam dabei keine Änderung an (siehe die Hinweise zu den Beispielen); ohne Änderung lieferte SetMaterialVisualProperties -1. Das Hilfebeispiel „Get and Set Material Visual Properties“ ruft nach jeder Änderung SetMaterialVisualProperties mit swThisConfiguration auf. SetMaterialVisualProperties wirkt immer auf die aktive Konfiguration.
Material wechseln: Das Hilfebeispiel weist mit PartDoc.SetMaterialPropertyName2 das Material „Beech“ aus der Datenbank „SOLIDWORKS Materials“ zu, gibt das vorher geholte Objekt noch einmal aus und holt die Einstellungen erst danach neu. Ob ein vorher geholtes Objekt nach dem Wechsel noch stimmt, sagt die Hilfe nicht. Hol es deshalb nach einem Materialwechsel neu.
Standardtextur: MaterialVisualPropertiesData.Scale2, MaterialVisualPropertiesData.Angle und MaterialVisualPropertiesData.BlendColor gelten nach Angabe der Hilfe nur für SOLIDWORKS-Standardtexturen, vermutlich also nur, wenn MaterialVisualPropertiesData.RealView False ist.
Veraltet: Die Eigenschaft AdvancedGraphics, die Anzeige mit schattierten Texturen, ist veraltet und hat keinen Nachfolger. Die Hilfe zu RealView verlangt sie trotzdem noch.
Erscheinungsbilder: Erscheinungsbilder, die auf Flächen, Körpern oder Komponenten liegen, sind eigene Objekte (RenderMaterial). Wie sie mit den Darstellungseinstellungen des Materials zusammenwirken, sagt die Hilfe hier nicht.
In SOLIDWORKS 2024 lieferte PartDoc.SetMaterialVisualProperties nach einer Änderung 0, PartDoc.GetMaterialVisualProperties meldete danach aber wieder die alten Werte, nur der Maßstab sprang auf 1. Das galt auch mit swAllConfiguration, mit swSpecifyConfiguration und nach einem Neuaufbau.
Eigenschaften und Methoden
Eigenschaften 8, davon 7 beschrieben, 1 veraltet
| Name | Beschreibung |
|---|---|
| AdvancedGraphics | veraltet |
| Angle | Liest oder setzt den Winkel der SOLIDWORKS-Standardtextur des Materials. |
| ApplyAppearance | Liest oder setzt, ob das Teil das Erscheinungsbild des Materials bekommt, sich sein Aussehen also mit dem Material ändert. |
| ApplyMaterialColorToPart | Liest oder setzt, ob das Teil die Farbe des Materials bekommt. |
| ApplyMaterialHatchToSection | Liest oder setzt, ob Schnittansichten in Zeichnungen die Schraffur des Materials verwenden. |
| BlendColor | Liest oder setzt, ob die Farbe des Teils mit der SOLIDWORKS-Standardtextur gemischt wird. |
| RealView | Liest oder setzt, ob die Texturen des Materials als RealView-Grafik oder als Standardgrafik erscheinen. |
| Scale2 | Liest oder setzt den Maßstab, mit dem die SOLIDWORKS-Standardtextur des Materials skaliert wird. |
Siehe auch
Englisches Original: IMaterialVisualPropertiesData in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)
Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.