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 BooleanbOk = 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 übergebenswAllDisplayState. DisplayStateNamesVariantByVal- Die Namen der Anzeigezustände. Die Hilfebeispiele übergeben auch bei
swAllDisplayStatedie Namen ausConfiguration.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 & ", " & n2Bemerkungen
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.