SolidWorksMakroprogrammierung

Objekt · SldWorks

MaterialVisualPropertiesData-Objekt

Die Darstellungseinstellungen des Materials eines Teils: Farbe und Erscheinungsbild des Materials, Schraffur in Schnittansichten, RealView und die SOLIDWORKS-Standardtextur.

Deklaration Dim x As SldWorks.MaterialVisualPropertiesData · in der englischen .NET-Hilfe: IMaterialVisualPropertiesData

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

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 Sub

Bemerkungen

Ü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

NameBeschreibung
AdvancedGraphicsveraltet
AngleLiest oder setzt den Winkel der SOLIDWORKS-Standardtextur des Materials.
ApplyAppearanceLiest oder setzt, ob das Teil das Erscheinungsbild des Materials bekommt, sich sein Aussehen also mit dem Material ändert.
ApplyMaterialColorToPartLiest oder setzt, ob das Teil die Farbe des Materials bekommt.
ApplyMaterialHatchToSectionLiest oder setzt, ob Schnittansichten in Zeichnungen die Schraffur des Materials verwenden.
BlendColorLiest oder setzt, ob die Farbe des Teils mit der SOLIDWORKS-Standardtextur gemischt wird.
RealViewLiest oder setzt, ob die Texturen des Materials als RealView-Grafik oder als Standardgrafik erscheinen.
Scale2Liest 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.