SolidWorksMakroprogrammierung

Methode · ModelDocExtension

AddDisplayStateSpecificRenderMaterial-Methode (ModelDocExtension)

Bringt ein Erscheinungsbild in die angegebenen Anzeigezustände der aktiven Konfiguration und liefert seine Kennungen.

Syntax

Function AddDisplayStateSpecificRenderMaterial( _
   ByVal PRenderMaterial As RenderMaterial, _
   ByVal DisplayStateOption As Long, _
   ByVal DisplayStateNames As Variant, _
   ByRef PWMaterialId1 As Long, _
   ByRef PWMaterialId2 As Long _
) As Boolean
bOk = swModel.Extension.AddDisplayStateSpecificRenderMaterial(swRM, swAllDisplayState, vNamen, n1, n2)

Parameter

PRenderMaterialRenderMaterialByVal
Das Erscheinungsbild (RenderMaterial).
DisplayStateOptionLongByVal
Für welche Anzeigezustände, ein Wert aus swDisplayStateOpts_e. Die Hilfebeispiele übergeben swAllDisplayState.
DisplayStateNamesVariantByVal
Die Namen der Anzeigezustände. Die Hilfebeispiele übergeben auch bei swAllDisplayState die Namen aus Configuration.GetDisplayStates.
PWMaterialId1LongByRef · Rückgabe
Gibt die erste Kennung des Erscheinungsbilds zurück.
PWMaterialId2LongByRef · Rückgabe
Gibt die zweite Kennung zurück.

Rückgabewert

Vermutlich True bei Erfolg.

Beispiel

' swModel ist ein Teil, eine Fläche ist ausgewählt.
Dim swRM As SldWorks.RenderMaterial
Dim swConfig As SldWorks.Configuration
Dim vNamen As Variant
Dim n1 As Long, n2 As Long
Set swRM = swModel.Extension.CreateRenderMaterial("C:\Program Files\SOLIDWORKS Corp\SOLIDWORKS\data\graphics\Materials\metal\steel\polished steel.p2m")
swRM.AddEntity swModel.SelectionManager.GetSelectedObject6(1, -1)
Set swConfig = swModel.GetActiveConfiguration
vNamen = swConfig.GetDisplayStates
Debug.Print swModel.Extension.AddDisplayStateSpecificRenderMaterial(swRM, swAllDisplayState, vNamen, n1, n2)
Debug.Print "Kennungen: " & n1 & ", " & n2

Bemerkungen

Die VBA-Hilfe enthält nur die Syntax, die .NET-Hilfe keine eigene Seite. Ihre Befehlsliste beschreibt den Befehl aber, und drei VBA-Hilfebeispiele zeigen ihn, etwa „Add and Delete Appearances from Specific Display States“: Sie legen das Erscheinungsbild mit RenderMaterial.AddEntity auf ein Element und übergeben dann swAllDisplayState und die Namen aus Configuration.GetDisplayStates. Dieses Beispiel holt die Kennungen danach mit RenderMaterial.GetMaterialIds und entfernt das Erscheinungsbild damit später über ModelDocExtension.DeleteDisplayStateSpecificRenderMaterial. Was die Kennungen unterscheidet und ob bei swThisDisplayState auch Empty statt der Namen geht, sagt die Hilfe nicht. Bei AddRenderMaterial ist dies als Nachfolger seit SOLIDWORKS 2011 genannt.

Siehe auch

Verfügbarkeit

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

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

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