SolidWorksMakroprogrammierung

Eigenschaft · ModelDocExtension

DisplayStateSpecMaterialPropertyValues-Eigenschaft (ModelDocExtension)

Liest oder setzt die Erscheinungsbilder (Farbe, Licht, Transparenz) von Komponenten in Anzeigezuständen, als Array von AppearanceSetting-Objekten.

Syntax

Property DisplayStateSpecMaterialPropertyValues( _
   ByVal Setting As DisplayStateSetting _
) As Variant
vErsch = swModel.Extension.DisplayStateSpecMaterialPropertyValues(swDSS)

Parameter

SettingDisplayStateSettingByVal
Komponenten, Anzeigezustände und Bereich, siehe DisplayStateSetting.

Wert

Ein Array mit AppearanceSetting-Objekten. So zeigt es das Hilfebeispiel „Change Color of Component in Specific Display State“.

Beispiel

' swModel ist eine Baugruppe (ModelDoc2), swDSS ein vorbereitetes DisplayStateSetting
' mit einer Komponente und dem aktiven Anzeigezustand (siehe DisplayStateSetting).
Dim swAS As SldWorks.AppearanceSetting
Dim vErsch As Variant
Dim aNeu(0) As Object
vErsch = swModel.Extension.DisplayStateSpecMaterialPropertyValues(swDSS)
Set swAS = vErsch(0)
swAS.Color = RGB(0, 160, 0)
Set aNeu(0) = swAS
swModel.Extension.DisplayStateSpecMaterialPropertyValues(swDSS) = aNeu

Bemerkungen

Die VBA-Hilfe enthält zu diesem Befehl nur die Syntax, die .NET-Hilfe keine eigene Seite. Wie er arbeitet, zeigen die Hilfeseiten zu AppearanceSetting und DisplayStateSetting mit dem Beispiel oben: DisplayStateSetting vorbereiten, Array lesen, das AppearanceSetting ändern, ein Array mit dem geänderten Objekt zurückgeben. Mit DisplayStateSetting.PartLevel bestimmst du, ob die Farbe auf Ebene der Baugruppe oder des Teils gilt.

Ein neues Erscheinungsbild, ohne das alte zu lesen, bekommst du mit ModelDocExtension.GetAppearanceSetting.

Wie das Array bei mehreren Komponenten oder Anzeigezuständen aufgebaut ist, sagt die Hilfe nicht. Das Hilfebeispiel arbeitet mit genau einer Komponente und einem Anzeigezustand. Bei ModelDocExtension.DisplayMode kommt ein Wert je Komponente und Anzeigezustand, Komponente außen. Vermutlich ist es hier genauso.

Siehe auch

Verfügbarkeit

In allen aktuellen Versionen vorhanden. Seit wann es den Befehl gibt, nennt die Hilfe nicht.

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

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